关于 adopt
adopt 是面向将现有项目纳入模板工作流团队的 Claude 技能。它检查项目文档格式及基础设施与技能流程的兼容性,并生成按优先级排列的迁移计划。
主要功能
- 01审查 GDD、ADR 和故事格式
- 02检查基础设施产物缺口
- 03支持完整或定向审查
- 04按优先级排列迁移缺口
- 05生成可核查的采用计划
适用场景
- 01在采用模板前评估现有项目
- 02查找 GDD、ADR 或故事中的格式问题
- 03规划项目基础设施迁移
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ donchitos/ claude-code-game-studios --skill adopt安装后在 Claude Code 中输入/adopt确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/1-detect.md2-format-audit.md3-classify.md4-migration-plan.md5-summary.md6-write.md7-first-action.md详细介绍
!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys review_mode,automation,automation_always_ask,workflow
已在上方解析 — 按原样使用。/adopt 还会直接检查 project.yaml 和旧版配置文件,以报告和写入迁移状态;这种原始检查是有意为之,与上方解析出的值分开进行。
Adopt — 棕地项目模板采纳
此技能会审查现有项目的产物是否符合格式要求,以适配模板的技能流水线,然后生成按优先级排列的迁移计划。
这不是 /project-stage-detect。
/project-stage-detect 回答:现有哪些内容?
/adopt 回答:现有内容能否与模板的技能配合使用?
项目可以拥有 GDD、ADR 和故事,但如果这些产物的内部格式不正确,所有对格式敏感的技能仍可能悄无声息地失败或产生错误结果。
输出: docs/adoption-plan-[date].md — 一份持久、可检查的迁移计划。
参数模式:
审计模式: $ARGUMENTS(留空 = full)
- 无参数 /
full:完整审计 — 所有产物类型 gdds:仅审计 GDD 格式合规性adrs:仅审计 ADR 格式合规性stories:仅审计故事格式合规性infra:仅检查基础设施产物缺漏(registry、manifest、sprint-status、stage.txt)
自动化模式:解析 modes.automation(project.local.yaml →
project.yaml → 默认值 collaborative)。每次调用 AskUserQuestion 都遵循 .claude/docs/automation-modes.md
(collaborative 始终提问 · guided 仅重大事项提问 · autonomous 记录并继续;
automation_always_ask 类别始终提示)。
workflow(参见 .claude/docs/workflow-modes.md)。它限定了第 2 阶段的审计范围和第 3 阶段的严重性:full 按完整结构审计所有文档类型;standard 仅审计必需文档/章节(可选章节仅作参考,不计为缺漏);minimal 仅检查 design/game-brief.md 格式 — 不要求 GDD/ADR/UX。参见第 2 阶段。
第 1 阶段:检测项目状态
现在阅读 references/1-detect.md 并遵循其中说明 — 本阶段的步骤位于该文件中,而非此处。如果在本阶段期间对话被压缩或恢复,请重新阅读。
第 2 阶段:格式审计
现在阅读 references/2-format-audit.md 并遵循其中说明 — 本阶段的步骤位于该文件中,而非此处。如果在本阶段期间对话被压缩或恢复,请重新阅读。
第 3 阶段:分类并确定缺漏的优先级
现在阅读 references/3-classify.md 并遵循其中说明 — 本阶段的步骤位于该文件中,而非此处。如果在本阶段期间对话被压缩或恢复,请重新阅读。
第 4 阶段:制定迁移计划
现在阅读 references/4-migration-plan.md 并遵循其中说明 — 本阶段的步骤位于该文件中,而非此处。如果在本阶段期间对话被压缩或恢复,请重新阅读。
第 5 阶段:展示摘要并询问是否写入
现在阅读 references/5-summary.md 并遵循其中说明 — 本阶段的步骤位于该文件中,而非此处。如果在本阶段期间对话被压缩或恢复,请重新阅读。
第 6 阶段:编写采纳计划
现在阅读 references/6-write.md 并遵循其中说明 — 本阶段的步骤位于该文件中,而非此处。如果在本阶段期间对话被压缩或恢复,请重新阅读。
第 7 阶段:提供首个行动建议
现在阅读 references/7-first-action.md 并遵循其中说明 — 本阶段的步骤位于该文件中,而非此处。如果在本阶段期间对话被压缩或恢复,请重新阅读。
协作协议
适用于 collaborative 模式(默认模式)。 关于 guided 和
autonomous 模式,请参阅 .claude/docs/automation-modes.md — 以下规则
说明的是协作模式的要求,并非通用行为。
- 静默阅读 — 完成完整审查后再展示任何内容
- 先展示摘要 — 让用户先了解范围,再询问是否写入
- 写入前先询问 — 创建采纳计划文件前务必确认
- 提供建议,不强行执行 — 计划仅供参考;由用户决定修复哪些问题以及何时修复
- 一次只做一件事 — 移交计划后,提供一个具体的后续步骤,而不是同时列出六件要做的事
- 绝不重新生成现有产物 — 只补全现有内容中的缺漏; 不要重写已有内容的 GDD、ADR 或故事