用途:对用户指定的代码库进行系统化、分阶段的架构分析,产出“架构分析报告”,以“守护/教育”而非评判的口吻讲解架构、权衡与健康度。
主要能力与流程:技能分六个阶段执行。阶段1侦察与定位(强制关卡),用 Glob、Grep、Read 及受限 Bash(如 wc -l、git log --oneline | head,不执行应用代码)生成 Codebase Map,并等待用户确认范围(整个代码库、特定组件或特定关注点)。阶段2宏观分析并行启动三个 Lens Analyst(架构模式识别、架构适配性、决策考古),分别产出发现与推断的 ADR,汇总为 Architectural Profile。阶段3中观分析并行启动四个 Lens Analyst(依赖与耦合、意图与实现一致性、不变量分析、文档完整性)。阶段4微观分析并行三个 Lens Analyst。阶段5综合与报告(强制关卡)。阶段6交互式讲解。
核心约束:每个发现必须引用至少一个代码位置(文件路径与行范围),缺证据则丢弃;自上而下顺序不可颠倒;同一阶段内各 Lens Analyst 上下文独立,交叉引用仅在编排层进行;不执行代码、不运行测试/服务器/构建,性能与可靠性结论属结构性推断而非测量;不生成或重构代码,只输出分析与建议;每条发现必须包含 Observation、Pattern、Tradeoff、Socratic Question、Stewardship Recommendation 五部分;用守护式语言而非评判式语言,权衡表述为质量属性之间的张力;苏格拉底式提问用“what”而非“why”;明确声明为抽样而非穷尽覆盖;推断 ADR 使用假设式措辞。
适用场景:希望以教育性方式理解陌生或既有代码库架构、模式、权衡与健康度的开发者或团队。
限制:不执行代码、不测性能、不产出代码修改;分析深度取决于抽样范围;具体模型配置、运行环境与依赖的完整信息暂未提供。