SuperAPI AI 工具集

shepherd

通用与其它

查看项目

更新于 10-16 08:09

技能介绍

Shepherd 是一个用于长时间自主构建的技能,强调“简单”:已批准的规格、已批准的计划、经过验证的里程碑、最终证明。适用场景是多里程碑、耗时数小时或数天的端到端自主交付;不适用于一次性修复、单文件编辑、短时调试或每走一小步都需批准的工作。

工作流分为三段:Setup(意图 -> 规格 -> 评审 -> 验证 -> 标准 -> 计划)、Milestone(选择 -> 实现 -> 重构 -> 证据 -> QA -> 架构评审 -> 关闭)、Finish(最终 QA -> 最终架构评审 -> 验证器 -> 清理/报告)。只有当前阶段有证明时才能推进;缺少证明就修复、豁免或停止。

产物包括:.shepherd/spec.md(产品事实)、.shepherd/plan.md(构建顺序)、.shepherd/verification.md(证明映射)、.shepherd/standards.md(仓库规则)、.shepherd/progress.md(运行日志)、.shepherd/final-report.md(最终报告)。progress.md 记录当前状态,但不得覆盖已批准的规格、计划或证明映射。

实现阶段最多并行调度 5 个 implementer,各自在独立 worktree 中工作;行为变更里程碑需调度 refactorer;QA 通过后才能调度 architect。同一里程碑修复循环超过 3 次应停止并报告阻塞。完成阶段需运行验证脚本,例如:python3 skills/shepherd/scripts/validate_verification.py .shepherd/verification.md、validate_evidence.py、validate_freshness.py 和 validate_final_report.py。清理非主 worktree 使用 git worktree remove -f -f <path>。

限制:证据必须新鲜且可复现;验证失败、跳过验证命令、verification.md 缺失或不一致、QA 未通过、存在未批准的额外用户可见行为等情况下不得标记为绿色。关于具体平台支持、收费价格等信息,资料中暂未提供。