name: analyze description: 深度调查模式。收集上下文、分析、综合建议,不修改代码。 argument-hint: “<问题或主题>” allowed-tools: Read, Grep, Glob, Bash, Task, TeamCreate, TeamDelete, SendMessage, AskUserQuestion disable-model-invocation: true
分析 — 深度调查模式
彻底调查问题或主题。收集上下文、分析模式、综合可操作建议 — 不修改代码。
参数
<问题或主题> — 要调查的描述。
硬规则
- 只读: 严禁使用 Write、Edit 或 NotebookEdit 工具。仅用于调查。
- 基于证据: 每个发现必须引用特定文件和行号。
- 结构化输出: 始终生成以下标准报告格式。
工作流程
步骤 1: 范围界定
解析用户描述。识别:
- 核心问题或问题
- 相关领域(文件、模块、系统)
- “已回答”的样子(退出标准)
步骤 2: 收集上下文
创建团队进行并行调查:
TeamCreate(team_name: "analyze-{topic-slug}", description: "调查 {topic}")
生成工作者:
explore— 代码库搜索相关文件、模式、依赖oracle— 探索提供发现后的战略分析(仅用于复杂主题)
分配目标搜索任务给探索:
- 找到与主题相关的文件
- 追踪数据流或调用链
- 识别模式和惯例
步骤 3: 分析
综合工作者的发现。寻找:
- 根本原因(不仅仅是症状)
- 模式和反模式
- 依赖和耦合
- 风险区域
- 缺失覆盖(测试、文档、错误处理)
步骤 4: 报告
输出结构化报告:
## 摘要
[2-3 句发现概述]
## 关键发现
1. **[发现]**: [带有文件:行号引用的证据]
2. ...
## 分析
[按主题/区域组织的详细分解]
## 建议
1. **[行动]** — [原因、努力估计、风险级别]
2. ...
## 检查的文件
- `path/to/file.ts:42` — [发现了什么]
步骤 5: 清理
TeamDelete(reason: "分析完成")
TeamDelete 清理: 如果 TeamDelete 失败,回退到:rm -rf ~/.claude/teams/{team-name} ~/.claude/tasks/{team-name}
何时使用
- 在修复问题前进行调试
- 理解不熟悉的代码区域
- 评估架构决策
- 预重构分析
- 事件调查
何时不使用
- 如果已经知道要修复什么 → 使用
/work代替 - 如果需要做出更改 → 这是只读的
- 对于简单的“X 在哪里?”问题 → 直接使用 Grep/Glob 直接