name: analyze description: 深度分析与调查
<Purpose> 分析执行对架构、bug、性能问题和依赖关系的深度调查。它将路由到架构师代理或Codex MCP进行彻底分析,并返回结构化发现与证据。 </Purpose>
<Use_When>
- 用户说“analyze”、“investigate”、“debug”、“why does”或“what’s causing”
- 用户在做出更改前需要理解系统的架构或行为
- 用户想要bug或性能问题的根本原因分析
- 用户需要依赖分析或对提议更改的影响评估
- 复杂问题需要读取多个文件并进行跨文件推理 </Use_When>
<Do_Not_Use_When>
- 用户想要进行代码更改——改用执行器代理或
ralph - 用户想要一个带有验收标准的完整计划——改用
plan技能 - 用户想要快速文件查找或符号搜索——改用
explore代理 - 用户问一个简单的事实性问题,可以从一个文件中回答——直接阅读并回答 </Do_Not_Use_When>
<Why_This_Exists> 深度调查需要不同于快速查找或代码更改的方法。分析任务需要广泛上下文收集、跨文件推理和结构化发现。将这些路由到架构师代理或Codex确保适当的深度,而无需完整的规划或执行工作流开销。 </Why_This_Exists>
<Execution_Policy>
- 当可用时,优先使用Codex MCP进行分析(更快,成本更低)
- 当Codex不可用时,回退到架构师Claude代理
- 始终为分析工具提供上下文文件以进行有根据的推理
- 返回结构化发现,而不仅仅是原始观察 </Execution_Policy>
<Steps>
- 识别分析类型:架构、bug调查、性能或依赖分析
- 收集相关上下文:读取或识别关键涉及文件
- 路由到分析器:
- 首选:使用
agent_role: "architect"和相关的context_files调用ask_codex - 备选:
Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="Analyze: ...")
- 首选:使用
- 返回结构化发现:呈现分析结果,包括证据、文件引用和可操作建议 </Steps>
<Tool_Usage>
- 在首次使用MCP工具之前,调用
ToolSearch("mcp")以发现延迟的MCP工具 - 使用
ask_codex,设置agent_role: "architect"作为首选分析路由 - 传递
context_files,包含所有相关源文件以进行有根据的分析 - 当ToolSearch找不到MCP工具或Codex不可用时,使用
Task(subagent_type="oh-my-claudecode:architect", model="opus", ...)作为备选 - 对于广泛分析,首先使用
explore代理识别相关文件,然后再路由到架构师 </Tool_Usage>
<Examples> <Good> 用户:“analyze why the WebSocket connections drop after 30 seconds” 行动:收集WebSocket相关文件,路由到架构师并带有上下文,返回根因分析,包含具体文件:行引用和推荐修复。 为什么好:清晰的调查目标,带有证据的结构化输出。 </Good>
<Good> 用户:“investigate the dependency chain from src/api/routes.ts” 行动:使用explore代理映射导入图,然后路由到架构师进行影响分析。 为什么好:使用explore进行事实收集,架构师进行推理。 </Good>
<Bad> 用户:“analyze the auth module” 行动:返回“The auth module handles authentication.” 为什么不好:浅层总结,没有调查。应该检查模块的结构、模式、潜在问题,并提供带有文件引用的具体发现。 </Bad>
<Bad> 用户:“fix the bug in the parser” 行动:运行分析技能。 为什么不好:这是修复请求,不是分析请求。应该路由到执行器或ralph。 </Bad> </Examples>
<Escalation_And_Stop_Conditions>
- 如果分析显示问题需要代码更改,报告发现并推荐使用
ralph或执行器进行修复 - 如果分析范围太广(“analyze everything”),要求用户缩小焦点
- 如果Codex不可用且架构师代理也失败,报告收集的上下文并建议手动调查路径 </Escalation_And_Stop_Conditions>
<Final_Checklist>
- [ ] 分析针对特定问题或调查目标
- [ ] 发现引用具体文件和行号(如适用)
- [ ] 为bug调查识别根本原因(不仅仅是症状)
- [ ] 提供可操作建议
- [ ] 分析区分已确认事实和假设 </Final_Checklist>
Task: {{ARGUMENTS}}