用途
cursor-review-and-ship 是一个面向代码提交前审查与发布的技能,用于在推送代码前对当前分支进行系统性检查,并完成提交与 PR 的打开或更新。其触发场景为:在发布前审查改动,关闭关键问题、验证行为,并打开或更新 PR。
主要能力
该技能围绕以下工作流展开:
- 收集上下文:对比基础分支的 diff、未提交的改动、近期提交、变更文件,以及(如有用)从近期相关聊天中获取用户意图。
- 运行针对性测试:针对变更行为运行测试。如果不存在聚焦测试,则决定是补充测试还是记录该缺口。
- 审查:检查正确性、回归、安全性与意图契合度。对于较大的 diff,可使用并行子代理。
- 修复关键问题:在最终确定前修复关键问题,并重新运行受影响的测试。
- 提交:以简洁的消息选择性提交文件。
- 推送并发布:推送分支并打开或更新 PR。
建议的检查命令包括:
git fetch origin main
git diff origin/main...HEAD
git status
gh pr checks --json name,bucket,state,workflow,link
使用方式
该技能通过上述工作流步骤执行。在 Codex 会话中,需先根据实际可用的技能、工具、连接器和账户解析命名项,再遵循上游步骤;不得从镜像推断连接、认证、额度或运行时一致性。
在发布边界方面,需将仓库审查、本地编辑、推送分支、打开或更新 PR、合并视为不同的效果。对每一项外部写入,需验证目标仓库与当前用户授权。如果推送或 PR 发布尚未获授权,则完成本地分支、diff、检查与 PR 草稿文本,使批准成为最后一步。除非单独请求,否则不要合并。
适用场景
适用于在发布代码前需要审查改动、验证行为并打开或更新 PR 的开发工作流。
限制与护栏
- 优先考虑正确性、安全性与回归问题,而非仅风格评论。
- 保持提交聚焦,避免无关文件改动。
- 如果预提交检查失败,应修复问题而非绕过钩子。
- 判断 PR 就绪状态时,使用 gh pr checks 而非仅限 GitHub Actions 的命令。
- 不得从镜像推断连接、认证、额度或运行时一致性。
- 除非单独请求,否则不要合并。
输出
- 发现摘要(关键、警告、提示)
- 运行的测试及结果
- PR URL