SuperAPI AI 工具集

gdd

编程与开发

查看项目

更新于 10-30 19:27

技能介绍

GDD 是一个名为“God-driven development”的工作流工具,其核心思路是:在工作项开始前“祈祷”并记录用户所听到的指引,随后让计划与这份指引保持一致。

用途与触发:该工具在 /gdd 命令以及若干检查点使用,用于在开发过程中引入并复核指引。

状态存储:状态保存在 git 根目录的 .temp/gdd.json 中,每个分支对应一个工作项。记录包含 branch(分支名)、status(active 或 declined)、guidance(用户原话,逐字记录)、checked(是否已运行 PR 前检查)。当 status 为 declined 时,所有检查点均静默,只有 /gdd 能重新开启;当记录中的 branch 与 git branch --show-current 不一致时,视为过期,将在下次写入时覆盖;checked 表示已运行 PR 前检查,一个 Claude Code 钩子 .skilly/engine/gdd/check-pr.mjs 会在 active 且未 checked 时阻止 gh pr create。

配置:在 .skilly/config.json 中配置 gdd,minutes 默认 5,pr 默认 false。

会话流程:发布逐字文本(填入 {minutes})。重复会话会把当前指引以引用形式放在上方;首次会话以“Clear already? Say skip.”结尾。随后启动后台计时器 sleep <minutes × 60>,没有后台 shell 则跳过并结束回合。计时器触发后询问“GDD here: what guidance did you get?”并结束回合;若用户先回复,则该回复即为答案,计时器触发时忽略。写入状态时 guidance 为答案原文,status 为 active,checked 为 false;“Same as before”保留旧指引;选择 skip 则写入 status: declined 并继续工作。

偏离检查:将计划与指引静默对比,吻合则不发言继续;偏离则询问“GDD here: does this fall within ""?”并结束回合。回答为最终决定,接受则继续;若回答显得不确定(含糊、“I guess”、“not sure”),则提议重复会话,同意则进入 Session,否则继续。

PR 前检查:先展示指引,然后按主要变更逐行列出(git log <base>..HEAD、git diff <base>...HEAD --stat),说明是否符合及原因,这就是摘要。询问工作是否与指引匹配,由用户决定先修复还是按原样开 PR。若 gdd.pr 为 true,则询问是否将确切摘要追加到 PR;同意则在 PR 正文末尾追加“## GDD”及第 1 步的摘要原文,设置 checked: true 后运行 gh pr create。

适用场景:适用于希望在工作项中引入并持续对照“指引”的开发流程,尤其配合 Claude Code 使用时。限制:依赖 git 与 Claude Code 钩子;状态按分支管理;未提供其他平台或收费信息。