SuperAPI AI 工具集

adr-driven-development

编程与开发

查看项目

更新于 10-15 19:48

技能介绍

用途:把一个模糊的大需求,经「grill 访谈 → loop 小周期 → host runner 无人值守实现」流水线,产出已核验的一串本地 commit。人只在两处介入:前期 grill 对话裁决设计,以及 runner 点火被权限拦截时手动执行一条命令。

硬性执行契约(顺序不可重排):先 grill 门禁,深挖意图、裁决方案、写出 plan.md 并取得用户对 plan 的明确确认;再由 loop 小周期按「host 解析 → goal 编译 → impl runner → 跨工具验收 reviewer」串行推进;只有验收 reviewer 汇报全部完成后才能进入最终汇总。禁止跳过 grill 直接实现(除非用户明确说已有设计,或 plan.md 已存在含已确认的决策+roadmap+DoD,且要在 progress.md 记原因);禁止主会话内联实现切片代码;禁止把 runner 自报完成当完成;禁止默认同工具自检冒充对抗验收。

主要能力与用法:coordination agent 先用可执行 CLI 查状态再读长规程,统一入口为 <path-to-skill>/scripts/adr doctor、status --plan .adr/<id>/plan.md、next --plan .adr/<id>/plan.md --run-dir .adr/<id>/run、attempt new、lock acquire、state can、review-packet。进入 loop 时必须运行 <path-to-skill>/scripts/detect-runtime-host.sh(或 scripts/adr detect-host)确定 host,禁止自行推理,默认倾向 tmux,Orca 环境且 CLI 健康时返回 orca。产物集中在 .adr/<id>/:plan.md、next-goal.md、progress.md,以及 run/ 下启动器、日志、报告与验收文件。

执行宿主与隔离:tmux 用 git worktree + launch-runner.sh 起 headless CLI;orca 用 orca worktree create 并扇出 impl/reviewer terminal。impl 默认 claude-code,reviewer 默认取与 impl 不同的工具(如 claude-code→codex 或 grok),同工具验收须用户明确授权。启动时须检查 grilling 系列 skill 是否可用,全部缺失要主动询问,不静默降级;安装示例为 npx skills add mattpocock/skills。

巡检定:以每 10 分钟定时任务巡检,用原子 mkdir 抢 compile/impl/review/advance 阶段锁,向 progress.md 追加巡检行,连续两次疑似停滞主动通知。

限制:证据不足处未提供;不得未确认归档即 worktree rm;被权限拦截只记「待点火」并给用户命令,不得退化为内联实现;验证不得只看固定路径文件存在。