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 项微架构变更),确认后输出完整报告