SuperAPI AI 工具集

cursor-review-and-ship

编程与开发

查看项目

更新于 10-16 06:07

技能介绍

用途

cursor-review-and-ship 是一个面向代码提交前审查与发布的技能,用于在推送代码前对当前分支进行系统性检查,并完成提交与 PR 的打开或更新。其触发场景为:在发布前审查改动,关闭关键问题、验证行为,并打开或更新 PR。

主要能力

该技能围绕以下工作流展开:

  1. 收集上下文:对比基础分支的 diff、未提交的改动、近期提交、变更文件,以及(如有用)从近期相关聊天中获取用户意图。
  2. 运行针对性测试:针对变更行为运行测试。如果不存在聚焦测试,则决定是补充测试还是记录该缺口。
  3. 审查:检查正确性、回归、安全性与意图契合度。对于较大的 diff,可使用并行子代理。
  4. 修复关键问题:在最终确定前修复关键问题,并重新运行受影响的测试。
  5. 提交:以简洁的消息选择性提交文件。
  6. 推送并发布:推送分支并打开或更新 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