附录B 工程模板
模板只保留当前项目实际需要的栏目。未填写模板不能作为工程成果。
B.1 议题
# <一个可观察的问题或结果>
## 问题
<当前事实、影响和证据>
## 目标
<本次只完成什么>
## 允许范围
-
## 禁止范围
-
## 验收条件
- [ ]
## 验证
- 自动:
- 实机:
- 用户:
## 依赖与风险
-
B.2 AI规划请求
目标:
允许读取:
允许在计划中修改:
禁止:
工程约束:
验证要求:
请先输出:
1. 对现有接口的理解;
2. 最小步骤;
3. 每步文件范围;
4. 风险;
5. 验证方法。
当前只规划,不修改文件,不执行命令。
B.3 AI实施请求
请按已经批准的议题和计划实施。
只允许修改:
不得修改:
实施规则:
1. 每次完成一个小步骤;
2. 每步列出实际变化;
3. 只运行批准的本地命令;
4. 不提交、不推送、不合并、不发布;
5. 需要扩大范围时停止并说明。
验收:
B.4 合并请求
## 关联
Closes #<议题编号>
## 变化
-
## 不变
-
## 验证
- [ ] 本地构建
- [ ] 自动测试
- [ ] 实机测试
## 实际结果
- 提交:
- 硬件/环境:
- 模型、数据与JSON模式:
- 日志或报告:
## 风险和回退
-
## AI协同
- AI参与:
- 人工完成:
- 拒绝或修正:
B.5 验证记录
# <版本/任务>验证记录
- Git提交:
- 日期:
- 操作人员:
- 环境:
- 硬件修订:
- 固件/服务版本:
- 数据集:
- 模型:
- 策略:
- 契约:
| 测试ID | 输入与条件 | 预期 | 实际 | 通过 | 证据 |
|---|---|---|---|---|---|
## 未通过和限制
-
B.6 技术决策记录
# ADR-<编号>:<决定>
- 状态:Proposed/Accepted/Superseded
- 日期:
- 关联需求和议题:
## 问题
## 约束
## 候选
### A
- 优点:
- 代价:
- 证据:
### B
- 优点:
- 代价:
- 证据:
## 决定
## 理由
## 后果和风险
## 重新评估条件
## 验证
B.7 调研来源记录
| 编号 | 研究问题 | 原始来源 | 版本/日期 | 核查日期 | 支持的结论 | 限制 |
|---|---|---|---|---|---|---|
AI答案作为检索线索,原始来源作为可引用证据。
B.8 构建物清单最小字段
artifact_id
artifact_version
file_or_uri
sha256
bytes
source_repository
source_commit
build_configuration
created_at
license_or_authorization
compatibility
数据、模型、固件和发布包根据对象增加专用字段。
B.9 发布检查
[ ] 主分支与远程同步
[ ] 标签指向批准提交
[ ] 自动检查通过
[ ] 实机和用户验证完成
[ ] 硬件、数据、模型、策略和契约一致
[ ] README.md和CHANGELOG.md准确
[ ] 已知限制完整
[ ] 秘密和个人数据检查通过
[ ] 许可证和第三方声明通过
[ ] SBOM与构建物一致
[ ] 干净环境复现通过
[ ] 构建物SHA-256固定
[ ] 回退方法实际验证
B.10 AI协同复盘
| 议题 | AI任务 | 人工任务 | 接受 | 修正或拒绝 | 验证 | 结果 |
|---|---|---|---|---|---|---|
## 有效条件
-
## 失控或返工原因
-
## 下一次改进
-