| name | chip-version-diff-generator |
| description | Use when comparing architecture document versions and generating change impact analysis. Triggers on '版本对比', 'version diff', '变更分析', '变更影响', '文档对比', 'change impact'. Compares two versions of architecture docs and outputs structured change impact analysis. |
Chip Version Diff Generator
任务
对比两个版本的架构文档,输出结构化变更影响分析。
执行步骤
- 读取旧版本与新版本的架构文档(用户提供文件路径或粘贴内容)。
- 识别以下类别的变更:
- 接口变更(新增/删除/修改信号、位宽、时序)
- 微架构变更(数据通路、控制逻辑、状态机)
- PPA 变更(指标调整、预算重新分配)
- 风险与缓解变更(新增或移除的风险项)
- RTL 实现指导变更(编码规范、策略更新)
- 评估每项变更对下游的影响范围:
- RTL 实现(高/中/低)
- 验证(回归测试范围)
- 后端(物理设计、时序、功耗)
- 软件/FW(驱动、寄存器配置)
- 生成变更建议:哪些模块需要重新验证、哪些测试用例需要更新、是否需要更新 UPF/SDC。
输出格式
### 版本变更摘要(vA → vB)
#### 1. 接口变更
| 变更项 | 旧值 | 新值 | 影响范围 | 下游动作 |
|--------|------|------|----------|----------|
#### 2. 微架构变更
...
#### 3. 影响评估汇总
- RTL:...
- 验证:...
- 后端:...
- 软件:...
使用示例
示例 1:FS 版本对比
用户:对比 data_adpt FS v1.0 和 v1.1 的变更,旧版在 ds/doc/fs/data_adpt_FS_v1.0.md,新版在 ds/doc/fs/data_adpt_FS_v1.1.md
预期行为:
- 逐章对比两个版本,识别接口/微架构/PPA/风险变更
- 输出变更摘要表 + 影响评估汇总
示例 2:微架构版本对比
用户:data_adpt_buf 微架构从 v1.0 改到 v1.2,帮我分析变更影响
预期行为:对比 UA 文档,标注每项变更对 RTL/验证/后端/软件的影响等级
异常处理
| 场景 | 触发条件 | 处理动作 |
|---|
| 版本文件缺失 | 旧版本或新版本文件不存在 | 提示用户提供文件路径或粘贴内容 |
| 差异过大 | > 50% 内容变更 | 分类汇总而非逐行对比,标注"大规模重构" |
| 差异过小 | 仅格式/注释变更 | 标注"无实质变更",跳过影响评估 |
| 二进制文件 | PNG/PDF 等无法 diff | 标注"二进制文件已变更,需人工确认" |
检查点
- 对比前:展示两个版本的文件路径和大小,确认版本正确
- 对比后:展示变更摘要(N 项接口变更、M 项微架构变更),确认后输出完整报告