mcpField
A
adopt

adopt

github.com/donchitosAgent 工作流28.5k459 次安装1 周前更新
代码仓库

关于 adopt

adopt 是面向将现有项目纳入模板工作流团队的 Claude 技能。它检查项目文档格式及基础设施与技能流程的兼容性,并生成按优先级排列的迁移计划。

主要功能

  1. 01审查 GDD、ADR 和故事格式
  2. 02检查基础设施产物缺口
  3. 03支持完整或定向审查
  4. 04按优先级排列迁移缺口
  5. 05生成可核查的采用计划

适用场景

  1. 01在采用模板前评估现有项目
  2. 02查找 GDD、ADR 或故事中的格式问题
  3. 03规划项目基础设施迁移

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/donchitos/claude-code-game-studios --skill adopt

安装后在 Claude Code 中输入/adopt确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
1-detect.md
2-format-audit.md
3-classify.md
4-migration-plan.md
5-summary.md
6-write.md
7-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 — 以下规则 说明的是协作模式的要求,并非通用行为。

  1. 静默阅读 — 完成完整审查后再展示任何内容
  2. 先展示摘要 — 让用户先了解范围,再询问是否写入
  3. 写入前先询问 — 创建采纳计划文件前务必确认
  4. 提供建议,不强行执行 — 计划仅供参考;由用户决定修复哪些问题以及何时修复
  5. 一次只做一件事 — 移交计划后,提供一个具体的后续步骤,而不是同时列出六件要做的事
  6. 绝不重新生成现有产物 — 只补全现有内容中的缺漏; 不要重写已有内容的 GDD、ADR 或故事

评论

支持 Markdown