深度分析技能Skill analyze

这个技能用于深度分析系统架构、调试bug、调查性能问题和依赖关系。通过路由到架构师代理或Codex MCP,提供结构化发现和证据,帮助用户理解系统行为、识别根本原因并评估影响。关键词:分析、调查、架构设计、bug调试、性能优化、依赖分析、系统推理。

架构设计 0 次安装 0 次浏览 更新于 3/11/2026

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>

  1. 识别分析类型:架构、bug调查、性能或依赖分析
  2. 收集相关上下文:读取或识别关键涉及文件
  3. 路由到分析器
    • 首选:使用agent_role: "architect"和相关的context_files调用ask_codex
    • 备选:Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="Analyze: ...")
  4. 返回结构化发现:呈现分析结果,包括证据、文件引用和可操作建议 </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}}