SuperAPI AI 工具集

setup-engine

编程与开发

查看项目

更新于 10-15 14:53

技能介绍

用途

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。

暂未提供

关于收费、价格、平台支持范围、具体效果指标等信息,资料中暂未提供。