---
name: knowledge-change-impact
description: 沿项目画像根目录与本体关系追踪设计、代码、测试、策略或证据变更，确定受影响的设计要求、实现单元、验证、门禁和决定。用于工作规划前、发现漂移后以及修复后，只使过期证据失效并最小化重跑范围。
metadata:
  version: 1.1.17
---

# 变更影响分析

> **领导速读：** 回答“这次变化影响什么、哪些结论要重跑、哪些可以复用”，避免每次从头检查。

## 一、管理视角

- **何时使用：** 规划工作前、发现漂移后或完成修复后。
- **主要输入：** 变更文件及哈希、项目画像、本体关系和仓库依赖。
- **主要输出：** 受影响对象、失效决定和最小安全重跑计划。
- **职责边界：** 不根据文件名接近程度猜测依赖。

## 二、执行方法

建立有边界、有证据支撑的影响集合。不得把文件名接近等同于语义依赖。

### 执行流程

1. 识别已变更产物及其当前哈希。
2. 读取 `reports/project-profile.json` 中的模块、实现、测试、设计和设计文件目录。
3. 存在当前快照时，使用 `ontology-drift`、`ontology-query --query impact` 和 `ontology-plan`。
4. 从已变更来源或实现单元出发，沿设计要求、场景、验证、证据、风险和决定追踪。
5. 纳入由导入关系、公开契约、构建清单、设计映射或显式引用支撑的仓库依赖。
6. 从最早受影响边界起，将依赖门禁决定标记为 `STALE`。
7. 产出最小安全重跑计划，并用证据说明排除的门禁。

### 边界规则

- 规格或验收规则变化会使下游设计、实现、测试、一致性、持续集成和准入证据失效。
- 架构或接口变化会使受影响的所有权和集成证据失效。
- 实现变化会使受影响的代码、开发者测试、一致性、持续集成和准入证据失效。
- 测试、夹具、流水线、策略或候选版本变化，默认只使消费它的决定失效；权威证据表明影响更广时除外。
- 未知依赖方向可能隐藏必跑门禁时，必须阻断。

### 输出

记录变更根、受影响对象标识与路径、失效决定、必要重跑、有理由保持有效的决定以及残余未知项。明确区分事实、推断和假设。