new-component

name	new-component
description	交互式创建新的 ECS 组件，自动生成反射注册代码
disable-model-invocation	true
allowed-tools	Read, Edit, Grep
argument-hint	[ComponentName] 组件名称（PascalCase，如 WindZoneComponent）

创建一个新的 ECS 组件，并完成反射系统注册。

流程

1. 收集组件信息

向用户询问以下信息（如参数中未提供）：

• 组件名称（PascalCase，必须以 Component 结尾，如 WindZoneComponent）
• 显示名称（中文，用于编辑器 UI，如 "风场"）
• 属性列表，每个属性需要：
  • 字段名（PascalCase）
  • C++ 类型（float、int、bool、glm::vec3 等）
  • 显示标签（中文）
  • 默认值
  • 可选 UI 约束（Min / Max / Speed / DragSpeed）

遇到不确定或缺失信息时主动向用户提问，不要猜测。

2. 修改文件

按顺序修改两处代码：

a) Engine/src/Scene/Components.h

在文件末尾（最后一个组件之后）添加结构体定义：

struct XxxComponent
{
    // 属性字段 + 默认值
};

b) Engine/src/Reflection/ComponentRegistry.cpp

在文件末尾添加反射声明 + 注册代码（ENGINE_COMPONENT / ENGINE_PROPERTY 宏现在在 .cpp 中声明）：

ENGINE_COMPONENT(XxxComponent, "显示名称");
ENGINE_PROPERTY(XxxComponent, FieldName, "标签", Vec3);

REGISTER_COMPONENT_BEGIN(XxxComponent)
    REGISTER_COMPONENT_PROPERTY(XxxComponent, FieldName)
REGISTER_COMPONENT_END(XxxComponent)

如需 UI 约束（数值 Min/Max/Speed），使用带 _EX 后缀的变体：

ENGINE_PROPERTY_EX(XxxComponent, Speed, "速度", Float,
    hints.Speed = 0.1f; hints.Min = 0.0f; hints.Max = 100.0f; hints.Format = "%.1f");

REGISTER_COMPONENT_BEGIN(XxxComponent)
    REGISTER_COMPONENT_PROPERTY(XxxComponent, Speed)
REGISTER_COMPONENT_END(XxxComponent)

3. 自检

• 结构体具备默认构造与可拷贝语义
• 每个 ENGINE_PROPERTY / ENGINE_PROPERTY_EX 都有对应的 REGISTER_COMPONENT_PROPERTY
• PropertyType 与字段 C++ 类型严格匹配
• ComponentRegistry.cpp 已包含 Scene/Components.h（通常已有）
• PropertyType 枚举值在 ENGINE_PROPERTY 中写简短形式（Float、Vec3），不是 PropertyType::Float

4. 构建验证

执行 build skill 构建 Editor 目标，确认编译通过。构建成功后，编辑器的 Add Component 菜单应出现新组件。

属性类型速查

C++ 类型	ENGINE_PROPERTY 写法	说明
float	Float	标量
int	Int	整数
bool	Bool	布尔
glm::vec2	Vec2	二维向量
glm::vec3	Vec3	三维向量
glm::vec4	Vec4	四维向量
glm::vec3（颜色）	Color3	颜色选择器
glm::vec4（颜色）	Color4	带 Alpha 颜色选择器
std::string	String	字符串
std::string（路径）	AssetPath	文件选择器
enum	Enum	需额外定义枚举名数组