Antigravity × Unreal Engine でゲーム開発を加速する — C++ とブループリントを AI で効率化する実践ガイド

# AGENTS.md の例（Unreal Engine プロジェクト向け）
 
## プロジェクト概要
- エンジン: Unreal Engine 5.5
- 言語: C++ / Blueprint
- ターゲット: Windows / PlayStation 5 / Xbox Series X
 
## コーディング規約
- Epic Games のコーディング標準に準拠
- クラス名には適切なプレフィックスを使用（A=Actor, U=Object, F=Struct, E=Enum）
- UPROPERTY / UFUNCTION マクロを必ず付与
 
## ディレクトリ構造
- Source/MyGame/Public/ — ヘッダーファイル
- Source/MyGame/Private/ — 実装ファイル
- Content/Blueprints/ — ブループリントアセット

// Source/MyGame/Public/HealthComponent.h
// Antigravity が生成したヘルスコンポーネント
 
#pragma once
 
#include "CoreMinimal.h"
#include "Components/ActorComponent.h"
#include "HealthComponent.generated.h"
 
DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(
    FOnHealthChanged, float, CurrentHealth, float, MaxHealth);
DECLARE_DYNAMIC_MULTICAST_DELEGATE(FOnDeath);
 
UCLASS(ClassGroup=(Custom), meta=(BlueprintSpawnableComponent))
class MYGAME_API UHealthComponent : public UActorComponent
{
    GENERATED_BODY()
 
public:
    UHealthComponent();
 
    // ダメージを受ける処理
    UFUNCTION(BlueprintCallable, Category = "Health")
    void TakeDamage(float DamageAmount);
 
    // 回復処理
    UFUNCTION(BlueprintCallable, Category = "Health")
    void Heal(float HealAmount);
 
    // 現在のHP取得
    UFUNCTION(BlueprintPure, Category = "Health")
    float GetHealthPercent() const;
 
    // デリゲート：HP変更時
    UPROPERTY(BlueprintAssignable, Category = "Health")
    FOnHealthChanged OnHealthChanged;
 
    // デリゲート：死亡時
    UPROPERTY(BlueprintAssignable, Category = "Health")
    FOnDeath OnDeath;
 
protected:
    virtual void BeginPlay() override;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Health",
        meta = (ClampMin = "0.0"))
    float MaxHealth = 100.0f;
 
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Health")
    float CurrentHealth;
};

// Source/MyGame/Private/HealthComponent.cpp
// 期待される動作:
// - TakeDamage(30) → CurrentHealth が 100 → 70 に減少
// - Heal(50) → CurrentHealth が 70 → 100 に回復（上限クランプ）
// - TakeDamage(150) → CurrentHealth が 0 になり OnDeath がブロードキャスト
 
#include "HealthComponent.h"
 
UHealthComponent::UHealthComponent()
{
    PrimaryComponentTick.bCanEverTick = false;
}
 
void UHealthComponent::BeginPlay()
{
    Super::BeginPlay();
    CurrentHealth = MaxHealth;
}
 
void UHealthComponent::TakeDamage(float DamageAmount)
{
    if (DamageAmount <= 0.0f || CurrentHealth <= 0.0f) return;
 
    CurrentHealth = FMath::Clamp(
        CurrentHealth - DamageAmount, 0.0f, MaxHealth);
    OnHealthChanged.Broadcast(CurrentHealth, MaxHealth);
 
    if (CurrentHealth <= 0.0f)
    {
        OnDeath.Broadcast();
    }
}
 
void UHealthComponent::Heal(float HealAmount)
{
    if (HealAmount <= 0.0f || CurrentHealth <= 0.0f) return;
 
    CurrentHealth = FMath::Clamp(
        CurrentHealth + HealAmount, 0.0f, MaxHealth);
    OnHealthChanged.Broadcast(CurrentHealth, MaxHealth);
}
 
float UHealthComponent::GetHealthPercent() const
{
    return (MaxHealth > 0.0f)
        ? CurrentHealth / MaxHealth
        : 0.0f;
}

// C++ 側：ブループリントで拡張可能なインターフェース
UFUNCTION(BlueprintNativeEvent, Category = "AI")
void OnDetectPlayer(AActor* DetectedPlayer);
 
// C++ 側のデフォルト実装
void AEnemyCharacter::OnDetectPlayer_Implementation(AActor* DetectedPlayer)
{
    // デフォルト動作：プレイヤーに向かって移動
    if (AIController)
    {
        AIController->MoveToActor(DetectedPlayer);
    }
}

// テストコードの例：HealthComponent のユニットテスト
IMPLEMENT_SIMPLE_AUTOMATION_TEST(
    FHealthComponentTest,
    "MyGame.Components.HealthComponent",
    EAutomationTestFlags::ApplicationContextMask
    | EAutomationTestFlags::ProductFilter)
 
bool FHealthComponentTest::RunTest(const FString& Parameters)
{
    // Arrange: テスト用ワールドとアクターを生成
    UWorld* World = FAutomationEditorCommonUtils::CreateNewMap();
    AActor* TestActor = World->SpawnActor<AActor>();
    UHealthComponent* Health = NewObject<UHealthComponent>(
        TestActor, UHealthComponent::StaticClass());
    Health->RegisterComponent();
 
    // Act & Assert: ダメージ処理のテスト
    Health->TakeDamage(30.0f);
    TestEqual(TEXT("HP should be 70 after 30 damage"),
        Health->GetHealthPercent(), 0.7f);
 
    // Act & Assert: 回復処理のテスト
    Health->Heal(50.0f);
    TestEqual(TEXT("HP should be 100 after healing"),
        Health->GetHealthPercent(), 1.0f);
 
    // Act & Assert: 過剰ダメージのテスト
    Health->TakeDamage(150.0f);
    TestEqual(TEXT("HP should be 0 after lethal damage"),
        Health->GetHealthPercent(), 0.0f);
 
    return true;
}