name: 差距分析 description: 比较当前状态与目标状态架构。范围限定为技术选项 - 完整分析需要业务上下文。 allowed-tools: 读取, 全局查找, 搜索, 技能

差距分析

何时使用此技能

当您需要时使用此技能：

记录当前（As-Is）架构
定义目标（To-Be）架构
识别当前状态与目标状态之间的差距
探索技术迁移选项

关键词： 差距分析、当前状态、目标状态、As-Is、To-Be、路线图、迁移、基线、过渡

范围警告

重要： 此分析基于代码结构覆盖技术迁移选项。

完整的迁移规划需要业务上下文，包括：

预算和时间表（代码外部）

组织结构（代码外部）

技术债务优先级（部分在代码中）

资源可用性（代码外部）

将此作为更广泛规划讨论的输入，而非完整的迁移策略。

差距分析工作流程

1. 记录当前状态（As-Is）

可以从代码中提取的内容（Zachman 行 4-6）：

方面	来源	分析
技术栈	package.json, pom.xml 等	框架、库、版本
架构模式	代码结构	单体、微服务、层
数据存储	配置文件	数据库、缓存、队列
集成点	API 定义	REST、GraphQL、消息传递
基础设施	IaC 文件	云资源、网络

需要人工输入的内容（Zachman 行 1-3）：

方面	所需来源
业务能力	业务文档
流程流	利益相关者访谈
战略对齐	战略文档

2. 定义目标状态（To-Be）

目标状态应包括：

愿景声明： 成功看起来像什么？
技术目标： 具体技术、版本
架构目标： 模式、结构
质量属性： 性能、可扩展性、安全目标
约束： 预算、时间表、合规要求

3. 识别差距

针对每个架构维度：

维度	当前	目标	差距
计算	基于虚拟机	容器化	容器采用
数据	单体数据库	服务每数据库	数据库分解
集成	点对点	事件驱动	事件网格实施
…	…	…	…

4. 分类差距

按以下方式分类每个差距：

类型：

技术债务
缺失能力
可扩展性限制
安全漏洞
合规差距

复杂性：

低：配置更改
中：代码修改
高：架构更改
非常高：平台迁移

风险：

低：隔离更改
中：跨组件影响
高：系统范围影响

5. 探索选项

针对每个差距，记录：

## 差距：[差距名称]

### 当前状态
[当前情况描述]

### 目标状态
[期望情况描述]

### 技术选项

#### 选项 A：[名称]
- **方法：** [描述]
- **优点：** [列表]
- **缺点：** [列表]
- **技术复杂性：** [低/中/高]
- **依赖项：** [列表]

#### 选项 B：[名称]
- **方法：** [描述]
- **优点：** [列表]
- **缺点：** [列表]
- **技术复杂性：** [低/中/高]
- **依赖项：** [列表]

### 推荐
[基于理由的技术推荐]

### 所需业务上下文
[需要哪些业务输入来最终决策]

差距分析输出结构

# 差距分析：[系统名称]

**日期：** YYYY-MM-DD
**范围：** [包含/排除内容]

## 范围限制

此分析基于代码结构分析覆盖技术迁移选项。
完整的迁移规划需要额外的业务上下文：
- 预算约束和批准流程
- 团队能力和技能可用性
- 业务时间表要求
- 风险承受能力和合规需求

这些选项应告知更广泛的规划讨论，而非取代它们。

## 当前状态总结
[As-Is 架构概述]

## 目标状态总结
[To-Be 架构概述]

## 差距清单

| ID | 差距 | 类型 | 复杂性 | 优先级 |
| --- | --- | --- | --- | --- |
| G1 | ... | ... | ... | TBD |
| G2 | ... | ... | ... | TBD |

## 详细差距分析

### G1：[差距名称]
[根据上述模板的详细分析]

## 技术依赖项
[显示哪些差距必须首先解决的依赖图]

## 推荐排序
[基于依赖项的技术排序]

## 所需业务决策
[需要业务输入的决策列表]

与其他技能的集成

architecture-documentation： 生成当前状态文档
zachman-analysis： 确保差距覆盖所有相关视角
togaf-guidance： 与 TOGAF 阶段 E（机会与解决方案）对齐
adr-management： 为差距解决决策创建 ADR

仓库位置

差距分析文档应存储在：

/architecture/
  gap-analysis.md
  /transitions/
    transition-1.md
    transition-2.md

版本历史

v1.0.0（2025-12-05）：初始发布
- 当前/目标状态分析工作流程
- 差距分类（类型、复杂性、风险）
- 技术选项探索
- 明确范围限制（需要业务上下文）

最后更新

日期： 2025-12-05 模型： claude-opus-4-5-20251101