arch-assess

name	arch-assess
description	现状系统评估与逆向架构：阅读现有代码、映射模块依赖、画 as-is C4 架构图、定位耦合热点和架构坏味道、输出系统健康度评估。 TRIGGER when: 评估现有系统架构、读代码找问题、画 as-is 架构图、依赖分析、耦合热点定位、架构坏味道识别、技术债务盘点、系统健康度评估、逆向架构。 DO NOT TRIGGER when: 从零设计新架构（用 arch-design）、方案评审（用 arch-review）、架构演进规划（用 arch-evolution）、全栈工程实践（用 arch-engineering）。

现状系统评估

目标

对现有系统进行逆向架构分析：从代码出发，画出 as-is 架构图，识别耦合热点和架构坏味道，输出系统健康度评估报告。这是"从零设计"的正交工作流——不假设绿地，从棕地出发。

工作流

1. 代码阅读与依赖映射

• 静态分析：解析 import/require 语句，构建模块依赖图
• 动态分析：运行时调用链追踪，识别实际执行路径
• 依赖方向检查：标注循环依赖、跨层引用、反向依赖
• 代码阅读启发式和依赖映射技术见： references/assessment-guide.md

2. As-Is C4 架构图

从现有代码反推架构图：

• Context：识别系统边界和外部依赖（数据库、消息队列、第三方 API）
• Container：识别可独立部署的组件（服务、前端应用、批处理）
• Component：识别每个容器内的主要模块和职责
• 标注技术栈、数据流方向、通信协议

C4 画法规范（Mermaid/PlantUML 模板、命名规范、每层粒度、坏味道标红方法）见： arch-design 技能的 c4-conventions.md 参考

3. 耦合热点与坏味道定位

识别架构层面的坏味道：

• 耦合热点：被最多模块依赖的"上帝类/上帝服务"
• 循环依赖：A→B→A 或更长的环
• 跨层引用：Controller 直连数据库、Service 导入 HTTP 类型
• 共享数据库：多服务直连同一数据库
• 分布式单体：微服务间强同步调用
• 坏味道目录和定位方法见： references/assessment-guide.md

4. 系统健康度评估

按质量属性逐项打分（1-5），输出健康度雷达图和改进建议：

• 可扩展性 / 高可用性 / 可维护性 / 可观测性 / 安全性 / 成本
• 评估方法和报告模板见： references/assessment-guide.md

决策规则

• 先读代码再画图——as-is 图必须反映真实代码结构，不是"应该是的样子"
• 依赖图比架构图更有诊断价值——耦合热点藏在依赖关系中
• 坏味道按影响范围排序——先修影响最大的
• 评估结果直接输入 arch-evolution 技能制定演进路线图
• 不在评估阶段提改造方案——先诊断后开方，诊断和方案分离