研发协作
在需要对同一代码变更获得多位独立且专精的审查意见时,用…
当用户要求一组专门代码审查者从多个独立视角审查变更,或要求 single/iterate 模式时,用此技能组织 reviewer 子代理并汇总结果。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在需要对同一代码变更获得多位独立且专精的特定
解决思路
- 对同一变更运行一组专门 reviewer 子代理;让每个 reviewer 不知道其他 reviewer,并严格限定在分配的关注区域内。
- reviewer prompts 位于 `reviewers/`;只读取计划启动的 reviewer 文件。
- single 模式:默认模式;启动一次 reviewers,聚合 findings,去重,并报告最终审查。
- iterate 模式:启动 reviewers,修复接受的 findings,重跑相关 reviewers,并重复直到审查干净或剩余 findings 被有意延后。
- 如果用户未指定模式,使用 single。
- 仅当用户明确要求持续修复、让 reviewers 满意、或运行到 clean 时,使用 iterate。
- 核心 reviewers:`reviewers/correctness-reviewer.md`、`reviewers/security-abuse-reviewer.md`、`reviewers/architecture-reviewer.md`、`reviewers/code-quality-conventions-reviewer.md`、`reviewers/simplicity-scope-reviewer.md`。
- 专业 reviewers:`reviewers/product-ux-accessibility-reviewer.md`、`reviewers/performance-reliability-reviewer.md`、`reviewers/telemetry-observability-reviewer.md`、`reviewers/testing-strategy-reviewer.md`、`reviewers/api-compatibility-reviewer.md`、`reviewers/documentation-dx-reviewer.md`。
- 当用户要求完整团队时,默认使用所有 reviewers;对更窄的请求,只启动相关的 reviewers。
- 对每个 reviewer 子代理,提供其 Markdown 文件中的准确 reviewer prompt。
- 对每个 reviewer 子代理,提供任务描述、PR/issue 上下文或用户请求。
- 对每个 reviewer 子代理,提供要审查的 diff 或变更文件。
- 对每个 reviewer 子代理,提供任何测试结果、日志、截图或相关仓库上下文。
- 给每个 reviewer prompt 添加包装提示:你是代码审查代理团队中的一名 reviewer。你看不到其他 reviewer。严格停留在你被分配的角色内。只返回具体、可执行的 findings,并附文件和行号引用。如果你负责的领域没有问题,请明确说明。不要提供总体评论、表扬、摘要或你职责之外的重复关注点。
- 优先并行运行相互独立的 reviewers。
- 不要让多个 reviewers 以相同方式解决同一个宽泛任务;他们的 reviewer prompt 就是边界。
- 聚合时合并重复 findings。
- 聚合时丢弃缺少具体 failure mode、用户影响、安全风险或维护成本的 findings。
- 聚合时以代码库、测试和明确需求作为证据解决冲突。
- 聚合时按严重性和实际重要性排序 findings。
- 聚合时先呈现 findings,并附文件和行号引用。
- 最终审查不应暴露原始 reviewer transcripts,除非用户要求。
- iterate 模式:运行初始 reviewer set。
- iterate 模式:决定哪些 findings 有效且应修复。
- iterate 模式:直接实现修复。
- iterate 模式:运行适合这些变更的测试或检查。
- iterate 模式:只重跑与变更区域或未解决 findings 相关的 reviewers。
- iterate 模式:继续直到没有可操作 findings,或直到剩余 findings 被明确记录为 out of scope、false positives 或 accepted tradeoffs。
- 在迭代之间让用户知情。
- 不要无限循环;当额外迭代不再产生实质新 findings 时停止。
- single 模式最终响应:返回聚合审查。
- iterate 模式最终响应:返回修复了什么。
- iterate 模式最终响应:返回运行了什么验证。
- iterate 模式最终响应:返回重跑了哪些 reviewers。
- iterate 模式最终响应:返回任何剩余 findings 或 accepted tradeoffs。
适用边界 · 注意事项
- 用户未明确要求持续修复、让 reviewers 满意或运行到 clean 时,不要使用 iterate 模式。
- 对窄范围审查请求,不要启动完整 reviewer 团队;只启动相关 reviewers。
- 不要让多个 reviewer 以相同方式解决同一个宽泛任务,也不要暴露原始 reviewer transcript,除非用户要求。