用途:当需要记录当前(as-is)架构、定义目标(to-be)架构、识别两者之间的差距并探索技术迁移选项时,可使用该技能。关键词包括差距分析、现状、目标状态、路线图、迁移、基线、过渡。
主要能力:从代码可提取技术栈(package.json、pom.xml 等)、架构模式、数据存储、集成点、基础设施等现状信息;目标状态包含愿景、技术目标、架构目标、质量属性与约束;并按维度(计算、数据、集成等)列出当前、目标与差距;随后对差距按类型(技术债、缺失能力、扩展性限制、安全漏洞、合规差距)、复杂度(低/中/高/极高)与风险进行分类;最后为每个差距记录技术方案,含方法、优缺点、复杂度、依赖、建议及所需业务上下文。
使用方式:按工作流执行——记录现状、定义目标、识别差距、分类差距、探索选项,并按给定输出结构生成文档(含范围限制、现状与目标摘要、差距清单、详细分析、技术依赖、推荐排序、所需业务决策)。文档建议存放于 /architecture/ 目录,如 gap-analysis.md 与 transitions/ 子目录。
适用场景:技术迁移规划、架构演进评估、路线图制定中的技术选项分析。
限制:该分析仅基于代码结构覆盖技术迁移选项,完整迁移规划还需业务上下文,如预算与时间线、组织架构、技术债优先级、资源可用性,这些多存在于代码之外;应将其作为更广泛规划讨论的输入,而非完整迁移策略。可与其他技能集成,如架构文档生成、Zachman 分析、TOGAF 指导(Phase E)、ADR 管理。版本历史与更新信息:v1.0.0(2025-12-05)初始发布,最后更新 2025-12-05,模型 claude-opus-4-5-20251101。