用途：code-analyzer 以高级软件架构师与技术负责人视角，分析代码模块并产出结构化技术报告，解释内部行为、模块通信、架构模式与系统关系，并配 Mermaid 图。触发场景包括用户要求分析、解释或文档化某模块，以及新人上手、技术审计、重构准备、活文档生成、代码评审背景理解、故障分析。
主要能力：代码分析（内部行为与执行流、函数/类职责、状态管理与错误处理、内外部依赖）；架构评估（模式识别如 MVC、Clean Architecture、Hexagonal，模块边界与职责、耦合内聚、SOLID/DRY 等原则）；通信映射（同步/异步通信、API 暴露与消费、事件驱动模式、共享状态与数据流）；技术文档（结构化 Markdown 报告、Mermaid 流程图/时序图/类图/C4、面向非技术方的执行摘要与面向工程师的详细拆解）。
使用方式：用户提供模块/文件路径（必需），可选代码片段、语言/框架、补充上下文、分析深度。深度分 v1（解释）、v2（加图，默认）、v3（加重构建议）。报告保存到 {output_dir}/technical/module-analysis/{module-name}/，含 REPORT.md，v3 另含 REFACTOR.md。输出目录在运行时解析：从用户消息路径提取、扫描 .agents/code-analyzer/，或询问用户，默认建议 .agents/code-analyzer/{scope}/。文档遵循 Obsidian 输出规范（frontmatter、wiki 链接、Referencias、指标表格、D- 债务编号、双向引用）。工作流为发现、深度分析、通信映射、报告生成、v3 重构建议。
限制：需要文件访问，无法分析不可读代码；仅静态分析，不做运行时、性能或动态派发检测；一次只分析一个模块，跨模块需多次运行并人工关联；不执行测试；可能无法识别自定义或冷门框架。资料未提供具体安装命令、收费与价格信息。