代码库分析文档

解决的具体问题

团队中常出现一种割裂：工程师写的代码、技术负责人理解的架构，与产品经理认知的业务落地逻辑之间存在信息差。代码库可能包含丰富的模块划分、模式选择和工程策略，但这些信息要么散落在注释中，要么停留在工程师的口头解释里。当产品经理需要梳理需求范围、评估迭代风险，或向非技术角色同步项目现状时，往往缺乏一份能快速读懂、又不失技术准确性的架构说明。

核心能力与工作流程

这个技能瞄准了这一痛点。它通过分析代码库的架构结构、设计模式与工程策略，产出一份结构化的中英文分析文档，且以产品经理的视角组织内容。

关键步骤包括：

• 扫描代码库，提取模块划分、依赖关系和关键功能边界
• 识别项目中采用的设计模式与工程实践（如分层策略、复用逻辑）
• 生成 Mermaid 图，直观展示模块间的交互与数据流向
• 以产品经理熟悉的逻辑组织内容，平衡技术细节与业务语境，避免过度深入代码层面的晦涩描述

适用边界与注意点

该技能更适合需要向非技术角色（如产品经理、业务方）解释代码库架构的场景，尤其是当团队需要统一技术与产品认知时。它不替代深度的技术文档，也不针对代码优化或性能调优提供具体建议。此外，分析结果依赖于代码库本身的清晰度——如果代码结构混乱、注释缺失，可能需要先进行基础整理。