subagent-review

name	subagent-review
description	启动一个或多个干净上下文子代理执行独立审查，并把简洁审查结论返回给主代理。当用户要求子代理、独立审查、干净上下文审查、严格审查、架构审查、耦合审查、换个视角审查、审查代理、并行审查，或希望另一个代理在不继承完整对话上下文的情况下检查代码、文档、差异、方案或任务产物时使用。

子代理审查

使用此 skill 让独立代理基于最小必要上下文执行审查。目标是减少上下文污染，并返回可由主代理整合的审查发现。

工作流程

1. 定义审查目标：

   • 明确需要审查的具体文件、差异、产物、命令输出、PR 摘要或设计章节。
   • 条件允许时，优先提供原始产物，而不是转述摘要。
   • 排除无关对话历史、先验结论、预设修复方案和猜测性诊断。

2. 构造干净上下文：

   • 只包含执行审查所必需的信息：用户目标、相关路径、精确差异或文件、验收标准和已知约束。
   • 如果需要审查代码仓库，提供工作目录，并要求子代理只检查相关路径。
   • 如果审查应保持只读，必须明确说明。
   • 不要传递密钥、.env、凭证、令牌或无关私有上下文。

3. 启动子代理：

   • 只有在子代理工具可用，且用户要求子代理或委托审查时，才使用 multi_agent_v1.spawn_agent。
   • 如果当前环境没有子代理工具，说明无法启动干净上下文子代理，并询问用户是继续普通本地审查还是停止。
   • 设置 fork_context: false，让子代理从干净上下文开始。
   • 只读代码库或产物审查优先使用 agent_type: "explorer"。
   • 只有当用户明确希望子代理修改文件时，才使用 agent_type: "worker"。
   • 除非用户要求，或存在明确的任务原因，不要覆盖模型设置。

4. 要求返回审查型输出：

   • 先列问题，按严重程度排序。
   • 能定位时，包含文件路径和行号。
   • 包含可复现证据或推理依据。
   • 没有可执行问题时，明确写出“未发现问题”。
   • 摘要要简短，并与问题列表分开。
   • 当用户要求严格审查、架构审查或耦合审查时，必须明确要求子代理检查架构是否干净、模块边界是否清晰、是否存在不必要耦合、是否存在过大的文件，以及是否有单个源代码文件超过 500 行。

5. 将结果返回给主代理：

   • 等待并收集子代理审查结果后，再向用户报告审查结论。
   • 子代理运行期间，只继续处理不依赖审查结果且不重叠的工作。
   • 忠实总结问题，不夸大置信度。
   • 标记主代理尚未独立验证的内容。
   • 子代理不再需要时，关闭已完成的子代理。

提示词模板

使用类似下面的提示词，只填写相关字段：

你正在基于干净上下文执行独立审查。

目标：
{用户希望审查什么}

审查对象：
{具体文件、差异、产物路径、命令输出或范围}

上下文：
{判断正确性所需的最小背景}

约束：
- 除非明确说明，否则本次审查保持只读。
- 除非为了验证问题必须查看，否则不要检查无关文件。
- 重点关注缺陷、回归、缺失测试、错误假设和用户可感知风险。
- 不要依赖任何先前对话；只使用本提示词和引用产物。

严格审查补充项，仅在用户要求时加入：
- 检查架构是否干净，职责是否分离。
- 标记无关模块、分层、界面、业务逻辑、基础设施或数据访问之间的不必要耦合。
- 标记任何超过 500 行的单个源代码文件为可执行问题，除非用户明确豁免生成文件或第三方文件。
- 优先指出存在耦合的具体文件或模块，以及能够降低风险的拆分边界。

返回：
- 先列问题，按严重程度排序。
- 每个问题尽量包含路径和行号。
- 如果没有可执行问题，请明确说明。
- 最后简要列出剩余风险或测试缺口。

上下文检查清单

启动子代理前，确认提示词包含：

• 精确的审查问题。
• 所需的最小路径或产物。
• 预期输出格式。
• 只读或可修改权限。
• 相关验收标准。
• 是否要求严格架构、耦合和 500 行文件审查。

启动子代理前，确认提示词不包含：

• 完整父线程历史。
• 主代理预设答案或期望结论。
• 无关实现细节。
• 密钥或环境凭证。