Investigating Code Patterns

此技能为导航、分析与解读现有软件系统提供了一套结构化的方法论。它专为需要快速熟悉新存储库、解决晦涩错误或重构遗留代码的软件工程师与技术主管所设计。通过运用严谨的调查框架（涵盖代码流追踪、实现定位、瓶颈识别与架构映射），它能将模糊的“这段代码是如何运作的？”问题转化为有证据支持的技术见解。

• 执行全面的代码流追踪，绘制从 API 入口点到数据处理结果的执行路径，确保对决策树与错误处理逻辑拥有完整的可见性。

• 使用 grep 与递归搜索模式执行精确的代码定位任务，以识别主要实现文件、支持模块与隐藏的依赖关系。

• 通过结构化的三个阶段方法诊断复杂的性能瓶颈：定位延迟、验证假设，并针对如 N+1 查询或算法效率低下等问题实现基于证据的优化。

• 开发详细的架构映射，定义组件边界、数据流模式以及服务或层级之间的集成点。

• 促进并行的调查策略，协调多代理工作流程，同时分析前端、后端与集成领域。

• 利用专业模板记录调查结果，确保所有分析都锚定于具体的文件行数引用，以实现可审计性与团队透明度。

• 使用此技能来探索代码结构、研究技术堆栈，并回答关于实现细节或架构逻辑的具体问题。

• 此技能不适用于从零开始建立新功能；请专注于调查与诊断任务，以支持后续的实现阶段。

• 在深入进行代码分析之前，请优先阅读项目文档，包括产品需求、功能规格、系统设计与 API 合约（例如 swagger/openapi/yaml）。

• 始终优先引用具体的文件路径与行号作为证据，以避免推测性结论。

• 运用 grep、read 与 glob 等直接工具进行模式发现，并在处理多服务或全栈性能调查时使用专业的代理协调。