mcpField
A
analyze

analyze

github.com/yeachan-heo开发40.6k81 次安装4 天前更新
代码仓库

关于 analyze

Analyze 是用于深度调查代码架构、缺陷、性能和依赖问题的技能,面向需要在修改前理解系统的开发者。它收集相关文件上下文,再交由 architect Agent 分析,并返回带证据的结构化发现。

主要功能

  1. 01调查架构、缺陷与性能问题
  2. 02分析依赖关系和变更影响
  3. 03收集多文件上下文
  4. 04路由至 architect Agent
  5. 05返回带文件依据的结构化结论

适用场景

  1. 01查找连接中断的根本原因
  2. 02梳理模块结构与行为
  3. 03评估修改对依赖链的影响

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill analyze

安装后在 Claude Code 中输入/analyze确认已加载。

详细介绍

Analyze 用于对架构、缺陷、性能问题和依赖关系进行深入调查。它会将任务路由到 architect Claude Agent 进行详尽分析,并返回带有证据的结构化发现。

<Use_When>

  • 用户说 "analyze"、"investigate"、"debug"、"why does" 或 "what's causing"
  • 用户需要在做出更改之前理解系统的架构或行为
  • 用户想要对缺陷或性能问题进行根因分析
  • 用户需要针对拟议变更的依赖分析或影响评估
  • 某个复杂问题需要读取多个文件并跨文件进行推理 </Use_When>

<Do_Not_Use_When>

  • 用户想要进行代码更改——请改用 executor Agent 或 ralph
  • 用户想要包含验收标准的完整计划——请改用 plan skill
  • 用户想要快速查找文件或搜索符号——请改用 explore Agent
  • 用户提出一个可从单个文件回答的简单事实性问题——直接读取并回答即可 </Do_Not_Use_When>

<Why_This_Exists> 深入调查需要与快速查找或代码更改不同的方法。分析任务需要广泛收集上下文、跨文件推理以及结构化发现。将这些任务路由到 architect Agent 或 Codex 可确保达到合适的深度,同时避免完整规划或执行工作流带来的开销。 </Why_This_Exists>

<Execution_Policy>

  • 将分析路由到 architect Claude Agent 进行详尽调查
  • 在启动 architect Agent 之前始终先收集上下文文件,以便进行有依据的推理
  • 返回结构化发现,而不只是原始观察结果 </Execution_Policy>
1. **确定分析类型**:架构、缺陷调查、性能或依赖分析 2. **收集相关上下文**:读取或确定涉及的关键文件 3. **路由到 analyzer**:`Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="Analyze: ...")` 4. **返回结构化发现**:呈现带有证据、文件引用和可操作建议的分析

<Tool_Usage>

  • 使用 Task(subagent_type="oh-my-claudecode:architect", model="opus", ...) 作为主要分析路由
  • 对于广泛分析,先使用 explore Agent 确定相关文件,然后再路由到 architect </Tool_Usage>
用户:"analyze why the WebSocket connections drop after 30 seconds" 操作:收集与 WebSocket 相关的文件,将上下文路由到 architect,返回带有具体 file:line 引用和建议修复方案的根因分析。 为何良好:调查目标明确,输出结构化且带有证据。 用户:"investigate the dependency chain from src/api/routes.ts" 操作:使用 explore Agent 梳理导入图,然后路由到 architect 进行影响分析。 为何良好:使用 explore 收集事实,使用 architect 进行推理。 用户:"analyze the auth module" 操作:返回 "The auth module handles authentication." 为何不佳:浅层总结,未进行调查。应检查该模块的结构、模式、潜在问题,并提供带有文件引用的具体发现。 用户:"fix the bug in the parser" 操作:运行 analysis skill。 为何不佳:这是修复请求,而非分析请求。应改为路由到 executor 或 ralph。

<Escalation_And_Stop_Conditions>

  • 如果分析表明该问题需要更改代码,请报告发现并建议使用 ralph 或 executor 进行修复
  • 如果分析范围过宽("analyze everything"),请让用户缩小关注范围
  • 如果 Codex 不可用且 architect Agent 也失败,请报告已收集的上下文,并建议手动调查路径 </Escalation_And_Stop_Conditions> <Final_Checklist>
  • 分析针对具体问题或调查目标
  • 发现结果在适用时引用具体文件和行号
  • 针对缺陷调查识别根本原因(而非仅症状)
  • 提供可执行的建议
  • 分析区分已确认事实与假设 </Final_Checklist>

Task: {{ARGUMENTS}}

评论

支持 Markdown