用途
review-and-ship 用于在交付代码前对当前分支进行审查与发布。其触发场景为:在发布前审查改动,关闭关键问题、验证行为,并打开或更新 PR。
主要能力
该技能的工作流包括以下环节:
- 收集上下文:与基础分支进行 diff、查看未提交的改动、最近的提交、变更的文件,以及必要时从近期相关对话中获取用户意图。
- 针对变更的行为运行定向测试。如果不存在聚焦的测试,则决定是添加测试还是记录这一缺口。
- 审查正确性、回归、安全性和意图匹配度。对于较大的 diff,使用并行子代理。
- 在最终确定前修复关键问题,并重新运行受影响的测试。
- 使用简洁的消息提交选定的文件。
- 推送分支并打开或更新 PR。
使用方式
该技能建议的检查命令包括:
git fetch origin main
git diff origin/main...HEAD
git status
gh pr checks --json name,bucket,state,workflow,link
适用场景
适用于在代码提交和发布前进行质量把关,尤其适合需要检查缺陷、意图匹配度和测试覆盖,并需要提交聚焦改动、打开或更新 PR 的开发流程。
限制与护栏
该技能包含以下护栏:
- 优先考虑正确性、安全性和回归,而非仅关注风格的评论。
- 保持提交聚焦,避免无关的文件改动。
- 如果预提交检查失败,应修复问题而不是绕过钩子。
- 在判断 PR 就绪状态时,使用 gh pr checks 而不是仅限 GitHub Actions 的命令。
输出
该技能的输出包括:
- 发现摘要(关键、警告、提示)
- 运行的测试及结果
- PR URL