用途
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。
使用方式
- 收集 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。
- 创建团队与任务:TeamCreate { team_name: "pr-review" },并创建 12 个任务(技能索引 + 11 个领域审查)。
- 构建技能索引:lead 直接 Glob $HOME/.claude/skills//SKILL.md 与 .claude/skills//SKILL.md,读取每个文件的 frontmatter,生成清单并写入技能索引任务。
- 并行生成 11 个队友(model: sonnet),使用 mode: "bypassPermissions",每个队友先加载相关技能,再读取对应 references 文件与 {DATA_FILE} 进行分析。
- 轮询完成:反复调用 TaskList,直到 11 个任务全部 completed 或超时。连续 3 次轮询无状态变化视为停滞;最多轮询 20 次(约 10–15 分钟)。
- 收集结果:对已完成任务调用 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 模式生成,以避免文件读取权限弹窗。
- 存在超时与停滞处理机制,超时领域不会得到审查。
- 关于收费、价格、平台支持范围等事实,资料暂未提供。