| name | team-parallel-analyze |
| description | L 级任务前期或需跨多份文档/模块时,并行 spawn 只读子智能体分别分析切片后由主智能体统一汇总。适合多文档分析、跨模块摸底、风险盘点。 |
| tools | Read, Agent |
| model | sonnet |
team-parallel-analyze 技能
触发时机
- L 级任务前期,需要同时分析 >=3 份不相关文档
- 需并行摸底 >=2 个相对独立模块的代码边界
- 主智能体已确认本轮目标是分析,不直接进入写入实现
前置条件
主智能体必须先确认:
执行流程
Step 1: 主智能体划分分析切片
为每个子智能体明确:
- 输入文件列表或文档范围
- 分析目标(边界/风险/依赖/一致性/缺口)
- 输出格式(摘要、风险点、边界条件、待确认问题)
切片之间应尽量互不依赖,避免一个子智能体等待另一个子智能体的中间结论。
Step 2: 加载自定义 Agent 设定(可选但优先)
主智能体为每个分析切片选择合适的角色名,优先复用现有自定义 agent(如 tech-lead、doc-engineer、pm)。在 spawn 前按以下顺序加载:
- 尝试读取
MySkills/agents/{agent-name}.md
- 如文件存在:将全文作为该子智能体的角色 prompt 注入,并在 spawn 前输出:
✓ 使用自定义定义:MySkills/agents/tech-lead.md
- 如文件不存在:回退到本技能的默认分析角色约束,并输出:
⚠ 未找到自定义 agent 定义 MySkills/agents/tech-lead.md,使用默认角色描述。
- 每个子智能体独立执行此查表步骤,禁止静默回退。
注册约定详见 MySkills/agents/README.md。
Step 3: 并行 spawn N 个只读子智能体
主智能体
├─→ Subagent A: 分析切片 A
├─→ Subagent B: 分析切片 B
├─→ Subagent C: 分析切片 C
└─→ ...
每个子智能体只负责自己的切片,输出必须包含:
- 关键发现
- 风险点
- 边界条件
- 待主智能体统一确认的问题
所有 Task 调用同时发出,不串行等待。
Step 4: 主智能体统一汇总
主智能体负责:
- 合并重复发现
- 标注相互矛盾的结论
- 提炼统一建议
- 判断是否需要进入计划、实现或 review 阶段
推荐汇总格式:
## 并行分析汇总
### 切片 A
- 关键发现:
- 风险点:
### 切片 B
- 关键发现:
- 风险点:
### 汇总结论
- ...
### 待确认问题
- ...
子智能体约束
- 只读不写:子智能体不得使用 Write/Edit 工具修改文件
- 局部上下文:每个子智能体只读取被分配的切片,避免上下文污染
- 结构化返回:不得只返回大段原文摘抄,必须提炼分析结论
- 禁止越权扩张:本模式只做分析,不直接转入编码或文档改写
适用边界
- 适合:多文档摸底、跨模块边界盘点、计划前风险分析
- 不适合:需要统一接口设计后再并行编码的实现任务
- 不适合:文件数量很少、主智能体单独阅读更便宜的小范围问题