SuperAPI AI 工具集

cc-pr-review

编程与开发

查看项目

更新于 10-15 10:35

技能介绍

用途

cc-pr-review 是一个多智能体 PR 审查技能(Multi-Agent Lead),仅限本地使用。它把一次 PR 审查拆分为多个领域视角,由主智能体(lead)统一调度,并行生成 11 个领域专家队友,收集各自报告后综合成一条 gh pr comment。

主要能力

  • 并行生成 11 个领域专家队友,覆盖:技能索引、安全、性能、React/TypeScript、测试、测试有效性、DevOps、整体架构、可维护性(thermo)、缺陷猎捕、范围纪律、代码注释。
  • 每个队友先加载与其领域相关的技能(通过技能索引任务),再按对应参考文件中的清单逐行分析 diff。
  • 支持两种输入:给定 PR 编号时使用 gh pr view / gh pr diff;未给定编号时改为与 origin/main 做 diff。
  • 将 PR 元数据、完整 diff、变更文件列表写入 /tmp/pr-review-data.md,供所有审查者共享。
  • 通过 TaskCreate / TaskUpdate / TaskList / TaskGet 管理任务与收集结果,最终由 lead 综合为一条 gh pr comment。

使用方式

  1. 收集 PR 数据:给定 PR 编号时运行 gh pr view <N>、gh pr diff <N>、gh pr diff <N> --name-only;未给定编号时运行 git diff origin/main 与 git diff origin/main --name-only。将输出写入 /tmp/pr-review-data.md,格式包含 ## PR METADATA、## DIFF、## CHANGED FILES。
  2. 创建团队与任务:TeamCreate { team_name: "pr-review" },并创建 12 个任务(技能索引 + 11 个领域审查)。
  3. 构建技能索引:lead 直接 Glob $HOME/.claude/skills//SKILL.md 与 .claude/skills//SKILL.md,读取每个文件的 frontmatter,生成清单并写入技能索引任务。
  4. 并行生成 11 个队友(model: sonnet),使用 mode: "bypassPermissions",每个队友先加载相关技能,再读取对应 references 文件与 {DATA_FILE} 进行分析。
  5. 轮询完成:反复调用 TaskList,直到 11 个任务全部 completed 或超时。连续 3 次轮询无状态变化视为停滞;最多轮询 20 次(约 10–15 分钟)。
  6. 收集结果:对已完成任务调用 TaskGet,超时任务标记为 "TIMED OUT — domain not reviewed",最后综合为一条 gh pr comment。

适用场景

  • 需要在本地对 PR 进行多视角、系统化审查的开发者。
  • 希望覆盖安全、性能、测试有效性、范围纪律、注释质量等多个维度的团队。
  • 使用 Claude 技能体系(SKILL.md)并希望复用已有技能指导审查流程的用户。

限制

  • 仅限本地使用(local use only)。
  • 依赖 gh CLI、git 以及 Claude 的任务/团队工具(TeamCreate、TaskCreate、TaskUpdate、TaskList、TaskGet)。
  • 审查者以 bypassPermissions 模式生成,以避免文件读取权限弹窗。
  • 存在超时与停滞处理机制,超时领域不会得到审查。
  • 关于收费、价格、平台支持范围等事实,资料暂未提供。