关于 shepherd
shepherd 是一项将拉取请求推进到可合并状态、但不会执行合并的工作流技能。它等待自动审查、处理符合条件的反馈，并在交由人工决定前再次核对审查结果和 CI。
主要功能
- 01轮询审查反馈和 PR 检查状态
- 02处理符合条件的审查意见
- 03提交并推送修复以进入下一轮审查
- 04交接前核验最新审查周期和 CI
- 05合并前要求人工明确批准
适用场景
- 01让新建的 PR 进入审查流程
- 02逐轮处理自动审查反馈
- 03确认最新修改已通过审查和 CI
- 04将可合并的 PR 交给人工而不执行合并
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/shepherd确认已加载。
详细介绍
Shepherd PR
你的任务是全程跟进此 PR，直到它已准备好合并——完成审查、处理反馈、验证通过且 CI 全绿。**不要合并。**是否合并由人工决定。
创建 PR（或接手刚创建的 PR）；如果尚未标记为可审查，则将其标记为可审查，然后持续循环检查其状态。不要停止检查，直到所有自动审查者（例如 Bugbot、Cubic 等）都已完成审查。
-
**等待审查者：**持续检查
gh pr view/gh pr checks/ 审查评论，直到所有审查者都已完成。不要根据不完整的反馈采取行动。如果还有审查者正在处理，就继续等待。 -
**分类处理反馈：**双方都完成后，落实他们要求的更改。修复所有中等严重程度及以上的问题。低严重程度的问题仅在违反 DRY 原则，或已有其他问题需要修复时才处理。如果只剩建议或低严重程度的问题，且属于极小问题（nit）或罕见边缘情况，则严格跳过，并回复说明原因，然后继续自主推进工作。
-
**提交并推送：**实施更改后，提交并推送。然后回到第 1 步——审查者会自动重新审查你推送的更改。
-
**循环：**重复上述过程，直到完整的一轮审查中，双方都没有留下需要处理的重要事项。
-
**再次核验是否已准备好合并：**宣布 PR 已准备好合并之前，再核验两次：(a) 所有审查者都已针对最新提交重新审查；(b) 没有尚未处理的必要更改；(c) CI 全绿且 PR 可合并。
-
**停止，交由人工处理。**报告 PR 已准备好合并，然后等待。不要合并。
硬性规定：未经明确批准，绝不合并
- 绝不要自行运行
gh pr merge、调用 GitHub 合并 API，或执行任何等效操作。 - “所有检查均已通过”不等于获准合并。这意味着可以停止并报告。
- 即使用户最初说“把这个 PR 合并掉”，也应理解为“让这个 PR 准备好合并”，并在合并前征求明确确认。
- 只有在你报告 PR 已准备好合并后，用户明确、无歧义地回复同意合并（例如“是，合并吧”“可以合并”），才能合并。点赞或回复“好的”都不够明确——如有歧义，请再次询问。
- 如有疑问，不要合并。先询问。
“已推送修复”不代表完成。“全部通过”也不代表完成——这只是交接给人工处理的时点。
不要提前停止。不要自行合并。
只有完成一轮干净的审查、进行双重核验、报告 PR 已准备好合并，并获得人工明确批准后，才算完成。