用途
setup-engine 用于为游戏开发项目配置引擎及其版本,并将该配置固定到 CLAUDE.md 中。当所选版本超出 LLM 训练数据范围时,它会通过 WebSearch 填充参考文档,帮助后续开发保持版本感知。
主要能力
- 支持四种调用模式:完整规格(引擎+版本)、仅引擎(版本自动查询)、无参数引导模式、refresh 刷新参考文档、upgrade 版本迁移。
- 将引擎配置写入 CLAUDE.md 技术栈,并填充技术偏好。
- 同时写入 project.yaml(主配置存储,v1.1)和 technical-preferences.md(旧版镜像);两者冲突时以 project.yaml 为准。
- 判断知识缺口,并填充引擎参考文档。
- 搭建引擎项目脚手架。
- 验证 CLAUDE.md 导入。
- 为所选引擎的专家代理文件添加“版本感知”章节,提示代理读取 docs/engine-reference/<engine>/VERSION.md、检查废弃 API、检查破坏性变更,并在不确定时使用 WebSearch 验证。
- refresh 子命令:读取现有 VERSION.md,通过 WebSearch 检查新引擎发布、更新的迁移指南、新废弃 API,更新参考文档及“最后验证”日期并报告变更。
- upgrade 子命令:迁移到新的引擎版本。
使用方式
调用形式包括:
/setup-engine godot 4.6(引擎和版本)/setup-engine unity(仅引擎,版本查询)/setup-engine(引导模式)/setup-engine refresh(刷新参考文档)/setup-engine upgrade [old-version] [new-version](版本迁移)
技能执行时会调用 hooks/yaml-helper.sh 解析 workflow 配置。工作流层级(minimal / standard / full)决定期望的设计产物和完成路径:minimal 层级的设计产物是单页 design/game-brief.md,完成路径为 4 步底线;standard/full 层级的设计产物是 design/gdd/game-concept.md,完成路径为完整流水线。若预处理块未渲染,则默认按 minimal 处理。
适用场景
适用于使用 Claude Code 进行游戏开发、需要固定引擎版本并维护版本感知参考文档的项目。
限制与约束
- 绝不猜测引擎版本,必须通过 WebSearch 或用户确认。
- 未经询问不得覆盖现有参考文档,只能追加或更新。
- 若已存在其他引擎的参考文档,替换前需询问。
- 编辑 CLAUDE.md 前需向用户展示将要更改的内容。
- WebSearch 结果不明确时需展示给用户决定。
- 当用户选择 GDScript 时,必须精确复制 references/godot-language-config.md 中 A1 的 GDScript CLAUDE.md 模板,绝不在 Language 字段添加“C++ via GDExtension”。
- 非 Godot 引擎不得加载 godot-language-config.md。
暂未提供
关于收费、价格、平台支持范围、具体效果指标等信息,资料中暂未提供。