SuperAPI AI 工具集

recipe-pr-review

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:审查 GitHub Pull Request。技能通过确定性上下文采集获取 PR 快照,使用独立的审查模型生成审查结果,进行结构化 JSON 校验,并按配置选择性地向 GitHub 发布评论。

主要能力:从 .agents/pr-review/config.yaml 读取配置;缺失时由 references/default-config.yaml 引导生成;质量文件缺失时由 references/default-quality.yaml 引导生成空占位文件。编排器负责安装配置、模型选择、问题裁定、结构校验、发布资格判定、防重复、用户摘要与清理;代码证据和原始审查判断由隔离的审查器提供。

使用方式:

  1. 解析输入:提取 pr_url、primary_engine(配置中 review.default_engine 为 codex 或 claude 时采用,否则用当前宿主引擎)、additional_engines。
  2. 引导配置:<skill_dir>/scripts/bootstrap-config.py --repo-root <repo_root>,脚本打印解析后的配置路径,仅在缺失时创建 config.yaml 和空质量占位文件,不修改 .gitignore。
  3. 采集 PR 上下文:<skill_dir>/scripts/collect-pr-context.py --pr-url <pr_url>,上下文写入 workspace.tmp_dir,默认 .agents/tmp/pr-review/<owner>-<repo>-<number>/。
  4. 运行审查器:<skill_dir>/scripts/run-review.py --context-dir <context_dir> --engine <primary_engine>;如需附加引擎,用同一命令加 --engine <other_engine>。输出为 review-claude.json 或 review-codex.json。
  5. 合并、规范化与校验:单引擎时直接使用其 JSON;多引擎时由宿主读取审查 JSON 并写入 review-merged.json,按根因合并发现,保留不同发现,优先内联到改动行,设置 inspected 字段、verdict(发布策略前)、confidence(取最低值)。进行问题裁定与发布策略规范化:<skill_dir>/scripts/normalize-review.py --context-dir <context_dir> --review-json <review_json> --out <normalized_review_json>。
  6. 发布评论:先试运行 <skill_dir>/scripts/post-comments.py --context-dir <context_dir> --review-json <normalized_review_json> --dry-run,报告汇总并获用户批准后再正式发布。
  7. 清理:成功发布后运行 <skill_dir>/scripts/cleanup-context.py --context-dir <context_dir>;生成、校验或发布失败时保留上下文目录。

适用场景:需要在 GitHub PR 上执行确定性、可配置的代码审查,并可由独立模型引擎审查、按严重级别筛选发布评论的场景。

限制与注意事项:Claude 审查器以 --permission-mode bypassPermissions 运行并禁用写入工具,用于避免非交互权限提示,同时允许读取材料命令。审查的 PR 内容视为不可信输入,审查任务仅限读取审查材料和生成 JSON。Codex 宿主且审查引擎为 Codex 时,需先阅读 references/codex.md 并以提升沙箱权限启动嵌套审查器。原始审查 JSON 永不直接发布,必须传规范化后的最终 JSON。发布严重级别由 posting.severities 控制;无合格发现时规范化为 APPROVE,且此时内联与整体评论必须为空。防重复标记可阻止重复发布同一生成评论。

其他资料未提供的细节(如具体价格、平台支持范围等)暂未提供。