SuperAPI AI 工具集

review-and-ship

编程与开发

查看项目

更新于 11-08 16:15

技能介绍

用途

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