diff-analysis

差异分析方法论

概述

用于分析变更集的结构化方法：对变更进行分类、评估风险并生成洞见。适用于 Git 差异、配置变更、API 迁移、架构更新或文档修订。

适用场景

• 从原始变更数据中提取洞见
• 在代码审查前对变更进行分类和优先级排序
• 准备发行说明或变更日志
• 评估迁移范围和风险

不适用场景

• 快速了解上下文——改用 catchup
• 完整 PR 审查——改用 review-core 和 pensive 技能

激活模式

触发关键词：diff、changes、release notes、changelog、migration、impact、risk assessment

自动加载条件：存在 Git 差异、用户请求变更分析或需要评估影响时。

渐进式加载

根据工作流阶段加载模块：

始终加载

• modules/semantic-categorization.md，用于变更分类工作流

按需加载

• 需要风险评估时加载 modules/risk-assessment-framework.md
• 使用 Git 仓库时加载 modules/git-diff-patterns.md

集成

• 使用 sanctum:git-workspace-review 收集 Git 数据
• 使用 imbue:proof-of-work 记录分析证据
• 使用 imbue:structured-output 格式化最终交付内容

必需的进度项

1. diff-analysis:baseline-established
2. diff-analysis:changes-categorized
3. diff-analysis:risks-assessed
4. diff-analysis:summary-prepared

完成相应步骤后，将每项标记为已完成。

四步方法论

步骤 1：建立基线（diff-analysis:baseline-established）

定义比较范围：要比较的状态、分析边界以及规模指标。

对于 Git 场景，加载 modules/git-diff-patterns.md。对于其他场景，比较相关产物。

步骤 2：对变更分类（diff-analysis:changes-categorized）

按语义类型对变更分组。加载 modules/semantic-categorization.md，了解变更类别、语义类别和优先级排序。

步骤 3：评估风险（diff-analysis:risks-assessed）

评估影响。加载 modules/risk-assessment-framework.md，了解风险指标、等级和评分方法。

步骤 4：准备摘要（diff-analysis:summary-prepared）

综合分析结果：主题、包含数量的范围、风险等级、审查重点和依赖项。按下游用途（PR 描述、发行说明、审查）进行格式化。

退出条件

• 所有 diff-analysis: 进度项均已标记为完成
• 每项变更都已分配类别和风险等级
• 摘要注明了基线和预期用途： 审查、发行说明或规划