[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6HSMRW0EDSJNTX4Y74CT1T2":3,"skill-same:01M6HSMRW0EDSJNTX4Y74CT1T2":50},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":23,"linkOnly":24,"markdownContent":25,"markdownBody":26,"frontMatter":27,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M6HSMRW0EDSJNTX4Y74CT1T2","gdscript-codegen",null,"AI 生成高质量 GDScript 代码的规范和模板。当用户要求生成、修改或审查 GDScript 代码时使用此 Skill。涵盖 Godot 4.x 类型系统、信号声明、导出变量、代码模板和最佳实践。","welflau\u002Fai-dev-system","welflau","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7010385?v=4","01M6HPTDGF18RFY07M229P8CTM","01M6HPTDMRMZCJPYBFEA9XVVYT",3,"MIT","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Fmagicai-hub\u002Fskills\u002Fgdscript-codegen\u002FSKILL.md",[],[18,19,20,21,22],"gdscript","gdscript codegen","生成","godot","godot 4","2026-11-10 10:12:30",false,"---\nname: gdscript-codegen\ndescription: AI 生成高质量 GDScript 代码的规范和模板。当用户要求生成、修改或审查 GDScript 代码时使用此 Skill。涵盖 Godot 4.x 类型系统、信号声明、导出变量、代码模板和最佳实践。\nversion: 1.0.1\n---\n\n# GDScript 代码生成 Skill\n\n> **用途**：AI 生成高质量 GDScript 代码的规范和模板  \n> **版本**：v1.0 · 2026-04-22  \n> **适用引擎**：Godot 4.5\u002F4.6\n\n---\n\n## 一、GDScript 4.x 核心规范\n\n### 1.1 类型系统\n\nGodot 4.x 使用强类型 GDScript，AI 生成代码时必须遵循：\n\n```gdscript\n# ✅ 推荐：显式类型标注\nvar health: int = 100\nvar speed: float = 10.0\nvar player_name: String = \"Player\"\nvar position: Vector3 = Vector3.ZERO\nvar enemies: Array[Node3D] = []\nvar weapon_data: Dictionary = {}\n\n# ✅ 推荐：函数参数和返回值标注\nfunc take_damage(amount: int) -> void:\n    health -= amount\n\nfunc get_health_ratio() -> float:\n    return float(health) \u002F float(max_health)\n\n# ❌ 避免：无类型标注（编译器警告）\nvar health = 100  # 类型推断，但不推荐\n```\n\n### 1.2 类型推断陷阱\n\n```gdscript\n# ❌ 错误：for 循环迭代变量无法推断\nfor x in [-1.0, 1.0]:\n    var pos := center + Vector2(x, 0) * radius  # 报错！\n\n# ✅ 正确：显式标注迭代变量\nfor x: float in [-1.0, 1.0]:\n    var pos := center + Vector2(x, 0) * radius\n\n# ❌ 错误：字典值类型无法推断\nvar data = {\"a\": 1, \"b\": 2}\nvar value := data[\"a\"]  # 报错！\n\n# ✅ 正确：显式标注或使用 as\nvar value: int = data[\"a\"]\nvar value := data[\"a\"] as int\n```\n\n### 1.3 信号声明\n\n```gdscript\n# Godot 4.x 信号语法\nsignal health_changed(current: int, maximum: int)\nsignal died\nsignal damage_taken(amount: int, remaining: int)\nsignal weapon_changed(weapon_index: int)\n```\n\n### 1.4 导出变量\n\n```gdscript\n# 基础类型\n@export var health: int = 100\n@export var speed: float = 10.0\n\n# 范围限制\n@export_range(0, 100, 1) var health: int = 100\n@export_range(0.0, 10.0, 0.1) var speed: float = 5.0\n\n# 枚举\n@export_enum(\"Easy\", \"Normal\", \"Hard\") var difficulty: int = 1\n\n# 资源\n@export var weapon_resource: WeaponResource\n@export var projectile_scene: PackedScene\n\n# 分组\n@export_group(\"Combat\")\n@export var damage: int = 10\n@export var fire_rate: float = 0.5\n```\n\n### 1.5 @onready 和节点引用\n\n```gdscript\n# ✅ 推荐：@onready 延迟初始化\n@onready var animation_player: AnimationPlayer = $AnimationPlayer\n@onready var health_bar: ProgressBar = $UI\u002FHealthBar\n\n# ✅ 推荐：运行时获取（更灵活）\nvar player: Node3D\nfunc _ready() -> void:\n    player = get_tree().get_first_node_in_group(\"player\")\n\n# ❌ 避免：硬编码路径（易断裂）\nvar health_label = $\"..\u002FUI\u002FGameHUD\u002FHealthPanel\u002FHealthLabel\"\n```\n\n---\n\n## 二、常用代码模板\n\n### 2.1 组件脚本模板\n\n```gdscript\n# health_component.gd\nextends Node\nclass_name HealthComponent\n\n## 生命值组件 - 可挂载到任何需要 HP 的实体\n\nsignal health_changed(current: int, maximum: int)\nsignal died\nsignal damage_taken(amount: int, remaining: int)\n\n@export var max_health: int = 100\n@export var invincible: bool = false\n@export var invincible_time: float = 0.0\n\nvar current_health: int\nvar is_dead: bool = false\nvar _invincible_timer: float = 0.0\n\nfunc _ready() -> void:\n    current_health = max_health\n\nfunc take_damage(amount: int) -> void:\n    if is_dead or invincible:\n        return\n    if _invincible_timer > 0:\n        return\n    \n    current_health = max(0, current_health - amount)\n    damage_taken.emit(amount, current_health)\n    health_changed.emit(current_health, max_health)\n    \n    if current_health \u003C= 0:\n        is_dead = true\n        died.emit()\n\nfunc heal(amount: int) -> void:\n    if is_dead:\n        return\n    current_health = min(max_health, current_health + amount)\n    health_changed.emit(current_health, max_health)\n```\n\n### 2.2 Manager 脚本模板\n\n```gdscript\n# arena_manager.gd\nextends Node\nclass_name ArenaManager\n\n## 竞技场管理器 - 处理限时刷分模式的核心逻辑\n\nsignal arena_started\nsignal arena_ended(final_score: int, rating: String)\nsignal score_changed(score: int, combo: int)\nsignal time_changed(remaining: float)\n\n@export var match_duration: float = 60.0\n@export var combo_window: float = 3.0\n\nvar _score: int = 0\nvar _combo: int = 0\nvar _time_remaining: float = 0.0\nvar _is_active: bool = false\n\nfunc _ready() -> void:\n    set_process(false)\n\nfunc start_arena() -> void:\n    _score = 0\n    _combo = 0\n    _time_remaining = match_duration\n    _is_active = true\n    set_process(true)\n    arena_started.emit()\n```\n\n---\n\n## 三、信号连接规范\n\n```gdscript\n# 方法引用（推荐）\nbutton.pressed.connect(_on_button_pressed)\n\n# Lambda（简单逻辑）\ntimer.timeout.connect(func(): print(\"Timeout!\"))\n\n# 带参数绑定\nenemy.died.connect(_on_enemy_died.bind(spawn_point, enemy))\n\n# 一次性连接\nbutton.pressed.connect(_on_one_time_press, CONNECT_ONE_SHOT)\n```\n\n---\n\n## 四、代码生成检查清单\n\nAI 生成 GDScript 代码后，检查以下项目：\n\n### 语法检查\n- [ ] 所有变量有类型标注\n- [ ] for 循环迭代变量有类型标注\n- [ ] 函数参数和返回值有类型标注\n- [ ] 信号声明格式正确\n- [ ] 缩进使用 Tab（不是空格）\n\n### 最佳实践检查\n- [ ] 避免硬编码节点路径\n- [ ] 使用 @onready 或 _ready() 获取节点\n- [ ] 信号连接有错误处理\n- [ ] 资源加载有空值检查\n\n### 命名规范检查\n- [ ] 类名 PascalCase\n- [ ] 变量名 snake_case\n- [ ] 私有变量 _snake_case\n- [ ] 常量 UPPER_SNAKE_CASE\n- [ ] 信号名 snake_case\n\n---\n\n## 五、编辑器警告规避（真实踩过的坑，避免打扰用户）\n\n这一节列的都是 Godot 4 **编辑器错误面板里最常见**、并且**生成式 AI 最容易犯**的警告。每条都给出修复模式，生成代码时直接避开。\n\n### 5.1 变量名与 built-in function 重名\n\n```gdscript\n# ❌ 警告：The variable \"hash\" has the same name as a built-in function.\nvar hash := _hash_cell(x, z)\n\n# ✅ 改名避开\nvar cell_hash := _hash_cell(x, z)\n# 或在辅助函数内部用 1 字母短名\nvar h := _hash_u32(seed)\n```\n\n**触发名单**（非完全列表）：`hash`、`len`、`str`、`int`、`float`、`bool`、\n`print`、`abs`、`sin`、`cos`、`min`、`max`、`clamp`、`lerp`、`sign`、\n`type_of`、`range`、`load`、`preload`。生成代码前，**避免用 GDScript\n全局函数名做局部变量名**。\n\n### 5.2 局部变量 shadow 基类属性\n\n```gdscript\n# ❌ 警告：The local variable \"basis\" is shadowing an already-declared\n#          property in the base class \"Node3D\".\nvar basis := Basis(Vector3.UP, yaw)\n\n# ✅ 改名\nvar cell_basis := Basis(Vector3.UP, yaw)\n```\n\n**`Node3D` 高风险属性**：`transform`、`basis`、`position`、`rotation`、\n`scale`、`global_transform`、`global_position`、`global_basis`。\n**`CanvasItem` 高风险**：`visible`、`modulate`、`material`。\n**`Node` 高风险**：`name`、`owner`、`tree`。\n\n生成挂在 Node 继承树上的脚本时，**不要用这些名字做局部变量**。\n\n### 5.3 函数参数未使用\n\n```gdscript\n# ❌ 警告：The parameter \"threshold\" is never used in the function ...\nfunc compute(value: float, threshold: float) -> float:\n    return value * 2.0\n\n# ✅ 接口必须保留该参数（callback \u002F signal \u002F polymorphism）时加下划线\nfunc compute(value: float, _threshold: float) -> float:\n    return value * 2.0\n\n# ✅ 如果不需要保留签名，直接删掉参数\nfunc compute(value: float) -> float:\n    return value * 2.0\n```\n\n**判断原则**：\n- 参数是为了匹配 signal 签名 \u002F callback 接口 \u002F 多态重载 → 加 `_` 前缀\n- 参数确实是历史残留、没人调用指定它 → 删掉\n\n### 5.4 整数除法警告\n\n```gdscript\n# ❌ 警告：Integer division. Decimal part will be discarded.\nvar x_groups := int((size.x - 1) \u002F 8) + 1\n\n# ✅ 选项 A：如果这就是故意的（如 GPU dispatch 组数、tile index 计算）\n@warning_ignore(\"integer_division\")\nvar x_groups := int((size.x - 1) \u002F 8) + 1\n\n# ✅ 选项 B：如果其实想要浮点结果\nvar x_groups_f := (size.x - 1) \u002F 8.0\n\n# ✅ 选项 C：显式用 @GlobalScope 的 int div 语义更清晰\nvar x_groups := ((size.x - 1) \u002F 8) + 1  # 全 int 操作数，结果也是 int\n```\n\n**判断原则**：除数 \u002F 被除数任一方是 float **则永远不报** ——\n`1.0 \u002F 3.0` 安全；`1 \u002F 3` 报警告。\n\n### 5.5 赋值未使用\n\n```gdscript\n# ❌ 警告：The value of \"result\" is never used.\nvar result := compute()\nreturn\n\n# ✅ 不关心返回值就别赋\ncompute()\nreturn\n```\n\n### 5.6 未使用的 signal\n\n```gdscript\n# ❌ 警告：The signal \"health_changed\" is declared but never used.\nsignal health_changed(hp: int)\n\n# 生成时：只声明你真正会 emit 的 signal。若是占位留给将来，加注释 +\n# @warning_ignore\n@warning_ignore(\"unused_signal\")\nsignal health_changed(hp: int)  # TODO(v2): emit after HP system lands\n```\n\n### 5.7 `@warning_ignore` 使用守则\n\n只在**三种情况**使用，别当万灵药：\n\n1. **故意如此**（整数除法 \u002F shadow 是有意的 API 对齐）\n2. **接口约束**（签名必须保留某个参数）\n3. **待办占位**（signal\u002Ffield 下个版本才接）\n\n**禁止**：用 `@warning_ignore` 来\"压住一个自己没搞清楚的警告\"。警告是\nGodot 在告诉你某处有 bug 风险 —— 先理解，再决定豁免。\n\n### 5.8 生成前自检清单\n\nAI 在输出 GDScript 前**务必**过一遍：\n\n- [ ] 没有 `var hash \u002F var len \u002F var str \u002F var range \u002F var load \u002F var print` 等重名\n- [ ] 如果 `extends Node3D` → 没有 `var basis \u002F var transform \u002F var position \u002F var rotation \u002F var scale`\n- [ ] 如果 `extends CanvasItem` \u002F `Control` → 没有 `var visible \u002F var modulate \u002F var material`\n- [ ] 函数参数全部有用；接口参数加 `_` 前缀\n- [ ] `int \u002F int` 表达式：显式 `@warning_ignore(\"integer_division\")` 或改成 `float`\n- [ ] signal 全部会 `emit()`，或显式标记占位\n- [ ] 没有\"写着玩\"的 `var result = foo()` 却不用 result\n","# GDScript 代码生成 Skill\n\n> **用途**：AI 生成高质量 GDScript 代码的规范和模板  \n> **版本**：v1.0 · 2026-04-22  \n> **适用引擎**：Godot 4.5\u002F4.6\n\n---\n\n## 一、GDScript 4.x 核心规范\n\n### 1.1 类型系统\n\nGodot 4.x 使用强类型 GDScript，AI 生成代码时必须遵循：\n\n```gdscript\n# ✅ 推荐：显式类型标注\nvar health: int = 100\nvar speed: float = 10.0\nvar player_name: String = \"Player\"\nvar position: Vector3 = Vector3.ZERO\nvar enemies: Array[Node3D] = []\nvar weapon_data: Dictionary = {}\n\n# ✅ 推荐：函数参数和返回值标注\nfunc take_damage(amount: int) -> void:\n    health -= amount\n\nfunc get_health_ratio() -> float:\n    return float(health) \u002F float(max_health)\n\n# ❌ 避免：无类型标注（编译器警告）\nvar health = 100  # 类型推断，但不推荐\n```\n\n### 1.2 类型推断陷阱\n\n```gdscript\n# ❌ 错误：for 循环迭代变量无法推断\nfor x in [-1.0, 1.0]:\n    var pos := center + Vector2(x, 0) * radius  # 报错！\n\n# ✅ 正确：显式标注迭代变量\nfor x: float in [-1.0, 1.0]:\n    var pos := center + Vector2(x, 0) * radius\n\n# ❌ 错误：字典值类型无法推断\nvar data = {\"a\": 1, \"b\": 2}\nvar value := data[\"a\"]  # 报错！\n\n# ✅ 正确：显式标注或使用 as\nvar value: int = data[\"a\"]\nvar value := data[\"a\"] as int\n```\n\n### 1.3 信号声明\n\n```gdscript\n# Godot 4.x 信号语法\nsignal health_changed(current: int, maximum: int)\nsignal died\nsignal damage_taken(amount: int, remaining: int)\nsignal weapon_changed(weapon_index: int)\n```\n\n### 1.4 导出变量\n\n```gdscript\n# 基础类型\n@export var health: int = 100\n@export var speed: float = 10.0\n\n# 范围限制\n@export_range(0, 100, 1) var health: int = 100\n@export_range(0.0, 10.0, 0.1) var speed: float = 5.0\n\n# 枚举\n@export_enum(\"Easy\", \"Normal\", \"Hard\") var difficulty: int = 1\n\n# 资源\n@export var weapon_resource: WeaponResource\n@export var projectile_scene: PackedScene\n\n# 分组\n@export_group(\"Combat\")\n@export var damage: int = 10\n@export var fire_rate: float = 0.5\n```\n\n### 1.5 @onready 和节点引用\n\n```gdscript\n# ✅ 推荐：@onready 延迟初始化\n@onready var animation_player: AnimationPlayer = $AnimationPlayer\n@onready var health_bar: ProgressBar = $UI\u002FHealthBar\n\n# ✅ 推荐：运行时获取（更灵活）\nvar player: Node3D\nfunc _ready() -> void:\n    player = get_tree().get_first_node_in_group(\"player\")\n\n# ❌ 避免：硬编码路径（易断裂）\nvar health_label = $\"..\u002FUI\u002FGameHUD\u002FHealthPanel\u002FHealthLabel\"\n```\n\n---\n\n## 二、常用代码模板\n\n### 2.1 组件脚本模板\n\n```gdscript\n# health_component.gd\nextends Node\nclass_name HealthComponent\n\n## 生命值组件 - 可挂载到任何需要 HP 的实体\n\nsignal health_changed(current: int, maximum: int)\nsignal died\nsignal damage_taken(amount: int, remaining: int)\n\n@export var max_health: int = 100\n@export var invincible: bool = false\n@export var invincible_time: float = 0.0\n\nvar current_health: int\nvar is_dead: bool = false\nvar _invincible_timer: float = 0.0\n\nfunc _ready() -> void:\n    current_health = max_health\n\nfunc take_damage(amount: int) -> void:\n    if is_dead or invincible:\n        return\n    if _invincible_timer > 0:\n        return\n    \n    current_health = max(0, current_health - amount)\n    damage_taken.emit(amount, current_health)\n    health_changed.emit(current_health, max_health)\n    \n    if current_health \u003C= 0:\n        is_dead = true\n        died.emit()\n\nfunc heal(amount: int) -> void:\n    if is_dead:\n        return\n    current_health = min(max_health, current_health + amount)\n    health_changed.emit(current_health, max_health)\n```\n\n### 2.2 Manager 脚本模板\n\n```gdscript\n# arena_manager.gd\nextends Node\nclass_name ArenaManager\n\n## 竞技场管理器 - 处理限时刷分模式的核心逻辑\n\nsignal arena_started\nsignal arena_ended(final_score: int, rating: String)\nsignal score_changed(score: int, combo: int)\nsignal time_changed(remaining: float)\n\n@export var match_duration: float = 60.0\n@export var combo_window: float = 3.0\n\nvar _score: int = 0\nvar _combo: int = 0\nvar _time_remaining: float = 0.0\nvar _is_active: bool = false\n\nfunc _ready() -> void:\n    set_process(false)\n\nfunc start_arena() -> void:\n    _score = 0\n    _combo = 0\n    _time_remaining = match_duration\n    _is_active = true\n    set_process(true)\n    arena_started.emit()\n```\n\n---\n\n## 三、信号连接规范\n\n```gdscript\n# 方法引用（推荐）\nbutton.pressed.connect(_on_button_pressed)\n\n# Lambda（简单逻辑）\ntimer.timeout.connect(func(): print(\"Timeout!\"))\n\n# 带参数绑定\nenemy.died.connect(_on_enemy_died.bind(spawn_point, enemy))\n\n# 一次性连接\nbutton.pressed.connect(_on_one_time_press, CONNECT_ONE_SHOT)\n```\n\n---\n\n## 四、代码生成检查清单\n\nAI 生成 GDScript 代码后，检查以下项目：\n\n### 语法检查\n- [ ] 所有变量有类型标注\n- [ ] for 循环迭代变量有类型标注\n- [ ] 函数参数和返回值有类型标注\n- [ ] 信号声明格式正确\n- [ ] 缩进使用 Tab（不是空格）\n\n### 最佳实践检查\n- [ ] 避免硬编码节点路径\n- [ ] 使用 @onready 或 _ready() 获取节点\n- [ ] 信号连接有错误处理\n- [ ] 资源加载有空值检查\n\n### 命名规范检查\n- [ ] 类名 PascalCase\n- [ ] 变量名 snake_case\n- [ ] 私有变量 _snake_case\n- [ ] 常量 UPPER_SNAKE_CASE\n- [ ] 信号名 snake_case\n\n---\n\n## 五、编辑器警告规避（真实踩过的坑，避免打扰用户）\n\n这一节列的都是 Godot 4 **编辑器错误面板里最常见**、并且**生成式 AI 最容易犯**的警告。每条都给出修复模式，生成代码时直接避开。\n\n### 5.1 变量名与 built-in function 重名\n\n```gdscript\n# ❌ 警告：The variable \"hash\" has the same name as a built-in function.\nvar hash := _hash_cell(x, z)\n\n# ✅ 改名避开\nvar cell_hash := _hash_cell(x, z)\n# 或在辅助函数内部用 1 字母短名\nvar h := _hash_u32(seed)\n```\n\n**触发名单**（非完全列表）：`hash`、`len`、`str`、`int`、`float`、`bool`、\n`print`、`abs`、`sin`、`cos`、`min`、`max`、`clamp`、`lerp`、`sign`、\n`type_of`、`range`、`load`、`preload`。生成代码前，**避免用 GDScript\n全局函数名做局部变量名**。\n\n### 5.2 局部变量 shadow 基类属性\n\n```gdscript\n# ❌ 警告：The local variable \"basis\" is shadowing an already-declared\n#          property in the base class \"Node3D\".\nvar basis := Basis(Vector3.UP, yaw)\n\n# ✅ 改名\nvar cell_basis := Basis(Vector3.UP, yaw)\n```\n\n**`Node3D` 高风险属性**：`transform`、`basis`、`position`、`rotation`、\n`scale`、`global_transform`、`global_position`、`global_basis`。\n**`CanvasItem` 高风险**：`visible`、`modulate`、`material`。\n**`Node` 高风险**：`name`、`owner`、`tree`。\n\n生成挂在 Node 继承树上的脚本时，**不要用这些名字做局部变量**。\n\n### 5.3 函数参数未使用\n\n```gdscript\n# ❌ 警告：The parameter \"threshold\" is never used in the function ...\nfunc compute(value: float, threshold: float) -> float:\n    return value * 2.0\n\n# ✅ 接口必须保留该参数（callback \u002F signal \u002F polymorphism）时加下划线\nfunc compute(value: float, _threshold: float) -> float:\n    return value * 2.0\n\n# ✅ 如果不需要保留签名，直接删掉参数\nfunc compute(value: float) -> float:\n    return value * 2.0\n```\n\n**判断原则**：\n- 参数是为了匹配 signal 签名 \u002F callback 接口 \u002F 多态重载 → 加 `_` 前缀\n- 参数确实是历史残留、没人调用指定它 → 删掉\n\n### 5.4 整数除法警告\n\n```gdscript\n# ❌ 警告：Integer division. Decimal part will be discarded.\nvar x_groups := int((size.x - 1) \u002F 8) + 1\n\n# ✅ 选项 A：如果这就是故意的（如 GPU dispatch 组数、tile index 计算）\n@warning_ignore(\"integer_division\")\nvar x_groups := int((size.x - 1) \u002F 8) + 1\n\n# ✅ 选项 B：如果其实想要浮点结果\nvar x_groups_f := (size.x - 1) \u002F 8.0\n\n# ✅ 选项 C：显式用 @GlobalScope 的 int div 语义更清晰\nvar x_groups := ((size.x - 1) \u002F 8) + 1  # 全 int 操作数，结果也是 int\n```\n\n**判断原则**：除数 \u002F 被除数任一方是 float **则永远不报** ——\n`1.0 \u002F 3.0` 安全；`1 \u002F 3` 报警告。\n\n### 5.5 赋值未使用\n\n```gdscript\n# ❌ 警告：The value of \"result\" is never used.\nvar result := compute()\nreturn\n\n# ✅ 不关心返回值就别赋\ncompute()\nreturn\n```\n\n### 5.6 未使用的 signal\n\n```gdscript\n# ❌ 警告：The signal \"health_changed\" is declared but never used.\nsignal health_changed(hp: int)\n\n# 生成时：只声明你真正会 emit 的 signal。若是占位留给将来，加注释 +\n# @warning_ignore\n@warning_ignore(\"unused_signal\")\nsignal health_changed(hp: int)  # TODO(v2): emit after HP system lands\n```\n\n### 5.7 `@warning_ignore` 使用守则\n\n只在**三种情况**使用，别当万灵药：\n\n1. **故意如此**（整数除法 \u002F shadow 是有意的 API 对齐）\n2. **接口约束**（签名必须保留某个参数）\n3. **待办占位**（signal\u002Ffield 下个版本才接）\n\n**禁止**：用 `@warning_ignore` 来\"压住一个自己没搞清楚的警告\"。警告是\nGodot 在告诉你某处有 bug 风险 —— 先理解，再决定豁免。\n\n### 5.8 生成前自检清单\n\nAI 在输出 GDScript 前**务必**过一遍：\n\n- [ ] 没有 `var hash \u002F var len \u002F var str \u002F var range \u002F var load \u002F var print` 等重名\n- [ ] 如果 `extends Node3D` → 没有 `var basis \u002F var transform \u002F var position \u002F var rotation \u002F var scale`\n- [ ] 如果 `extends CanvasItem` \u002F `Control` → 没有 `var visible \u002F var modulate \u002F var material`\n- [ ] 函数参数全部有用；接口参数加 `_` 前缀\n- [ ] `int \u002F int` 表达式：显式 `@warning_ignore(\"integer_division\")` 或改成 `float`\n- [ ] signal 全部会 `emit()`，或显式标记占位\n- [ ] 没有\"写着玩\"的 `var result = foo()` 却不用 result\n",{"name":5,"version":28,"description":7},"1.0.1","main","18d0e63d1313ca87098f614aa7c1e2dcf6de79c7","backend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Fmagicai-hub\u002Fskills\u002Fgdscript-codegen",1,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system","https:\u002F\u002Fgithub.com\u002Fwelflau","2026-11-12 14:55:20",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add welflau\u002Fai-dev-system --skill gdscript-codegen",{"tool":42,"command":43},"bunx","bunx skills add welflau\u002Fai-dev-system --skill gdscript-codegen",{"tool":45,"command":46},"pnpm","pnpm dlx skills add welflau\u002Fai-dev-system --skill gdscript-codegen","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Fmagicai-hub\u002Fskills\u002Fgdscript-codegen\u002FSKILL.md",true,[],[51,86,116,142,172,197],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":56,"sourceHtmlUrl":57,"categories":58,"keywords":67,"publishedAt":85},"01M6HS9Z4B0YA8CJCS2Y2F04Y3","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fwebapp-testing\u002FSKILL.md",[59,64],{"categoryNo":60,"categoryName":61,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",{"categoryNo":65,"categoryName":66,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000009","前端开发",[68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84],"testing","webapp testing","webapp","frontend","screenshots","playwright","web","debugging","toolkit","browser","ui","logs","applications","behavior","local","with","for","2026-11-11 15:11:14",{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":96,"publishedAt":85},"01M6HRAGMG7JF0HXYHMA5QHS8A","internal-comms","A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Finternal-comms\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Finternal-comms\u002FSKILL.md",[93],{"categoryNo":94,"categoryName":95,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000005","邮件与沟通",[97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115],"internal comms","comms","status","help","SET","write","use","reports","me","incident","leadership","project","resources","communications","internal communications","formats","sort","my","updates",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":120,"sourceHtmlUrl":121,"categories":122,"keywords":124,"publishedAt":23},"01M6HSTDP4M3JFXEBK91VFB4PA","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Fweb-artifacts-builder\u002FSKILL.md",[123],{"categoryNo":65,"categoryName":66,"taxonomyType":62,"taxonomyTypeDesc":63},[125,74,126,127,128,71,129,130,131,132,133,134,135,136,103,137,138,139,140,84,141],"web artifacts builder","artifacts","artifacts builder","builder","css","components","react","routing","state management","state","file","Tailwind","single-file","simple","ui components","multi","single",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":146,"sourceHtmlUrl":147,"categories":148,"keywords":158,"publishedAt":23},"01M6HSDXH0JSP8R3QTNY9XZ8HN","frontend-design","Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML\u002FCSS layouts, or when styling\u002Fbeautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Ffrontend-design\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Ffrontend-design\u002FSKILL.md",[149,150,153],{"categoryNo":65,"categoryName":66,"taxonomyType":62,"taxonomyTypeDesc":63},{"categoryNo":151,"categoryName":152,"taxonomyType":62,"taxonomyTypeDesc":63},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":154,"categoryName":155,"taxonomyType":156,"taxonomyTypeDesc":157},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[71,159,160,129,74,130,131,161,162,163,126,164,80,165,103,166,167,168,169,83,170,171],"design","frontend design","react components","create","code","examples","landing","ui design","pages","aesthetics","web ui","generic","when",{"skillNo":173,"name":174,"nameZh":6,"description":175,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":176,"sourceHtmlUrl":177,"categories":178,"keywords":180,"publishedAt":23},"01M6HSA77QYVP7A72HREGTDN2C","algorithmic-art","Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Falgorithmic-art\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Falgorithmic-art\u002FSKILL.md",[179],{"categoryNo":151,"categoryName":152,"taxonomyType":62,"taxonomyTypeDesc":63},[181,182,183,162,163,184,185,186,187,103,188,189,190,191,83,192,193,194,195,196,171],"algorithmic art","Art","algorithmic","flow","js","work","interactive","generative art","exploration","systems","users","Existing","request","generative","copyright","fields",{"skillNo":198,"name":199,"nameZh":6,"description":200,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":201,"sourceHtmlUrl":202,"categories":203,"keywords":205,"publishedAt":23},"01M6HS9HE0X390Y6RQKTY1YNGJ","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Ftheme-factory\u002FSKILL.md",[204],{"categoryNo":151,"categoryName":152,"taxonomyType":62,"taxonomyTypeDesc":63},[206,207,208,209,76,210,126,101,211,212,165,213,214,167,215,83,216,217,218,84,219,220],"theme factory","factory","theme","docs","generate","fly","slides","styling","artifact","themes","you","fonts","can","apply","new"]