---
name: requirement-traceability-matrix
id: ka-artifact_template-design-implementation-traceability-matrix
asset_kind: acceptance_template
lifecycle_status: active
authority: supporting
scope: ['*']
products:
  - '*'
routes: ['artifact_generation', 'code_change']
primary_triggers:
  - 追踪矩阵
  - 需求原型设计实现追踪
  - 需求到编码追踪
priority: P0
specificity: 5
version: 1.1.0
last_reviewed: '2026-06-01'
owner_mechanism_id: mc-design-artifact-pack
consumes:
  - docs/requirements.md
  - docs/prototype.md
  - docs/architecture/01-架构设计文档.md
  - docs/architecture/02-数据库设计文档.md
  - docs/architecture/03-API接口规格文档.md
  - docs/architecture/04-开发切片计划.md
emits:
  - docs/traceability/01-需求原型设计实现追踪矩阵.md
required_evidence:
  - REQ/PROTO/ARCH/DD/PHASE/SLICE/AC 全链路 ID
  - design_artifact_pack_verification
  - changed_files_traceability_binding
type: acceptance_template
stages: ["架构设计"]
---

# 需求原型设计实现追踪矩阵

输出路径：`docs/traceability/01-需求原型设计实现追踪矩阵.md`

## 1. ID 规则

- 需求：`REQ-01`
- 原型：`PROTO-01`
- 架构：`ARCH-01`
- 数据库详细设计可使用：`DD-T01`
- API 详细设计可使用：`DD-A01`
- 阶段：`PHASE-01`
- 实现切片：`SLICE-01`
- 验收：`AC-01`

## 2. 总矩阵

| 需求 ID | 需求摘要 | 原型 ID | 架构 ID | 详细设计 ID | 阶段 ID | 切片 ID | 验收 ID | 状态 | 证据/文件 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| REQ-01 |  | PROTO-01 | ARCH-01 | DD-T01, DD-A01 | PHASE-01 | SLICE-01 | AC-01 | planned | docs/architecture/04-开发切片计划.md |

## 3. 上游来源

| ID | 来源文件 | 来源章节 | 关键结论 |
| --- | --- | --- | --- |
| REQ-01 |  |  |  |
| PROTO-01 |  |  |  |

## 4. 设计承接

| 设计 ID | 上游 ID | 文件 | 设计结论 | 影响范围 |
| --- | --- | --- | --- | --- |
| ARCH-01 | REQ-01, PROTO-01 | docs/architecture/01-架构设计文档.md |  |  |
| DD-T01 | ARCH-01 | docs/architecture/02-数据库设计文档.md |  |  |
| DD-A01 | ARCH-01 | docs/architecture/03-API接口规格文档.md |  |  |

## 5. 切片与验收

| 阶段 ID | 切片 ID | 设计来源 | 验收 ID | 计划变更文件 | 验收标准 |
| --- | --- | --- | --- | --- | --- |
| PHASE-01 | SLICE-01 | DD-T01, DD-A01 | AC-01 |  |  |

## 6. 变更记录

| 日期 | 变更 | 影响 ID | 处理结论 |
| --- | --- | --- | --- |
|  |  |  |  |

## 7. 复验闭环

生成或修改本矩阵后必须执行：

```bash
soloforge audit-design-artifacts
soloforge next
```

进入编码前必须确认：

- `audit-design-artifacts` 无追踪矩阵阻断项。
- 架构设计引用 `REQ-*` 或 `PROTO-*`。
- 详细设计引用 `ARCH-*` 并声明 `DD-*`。默认由数据库设计 `DD-T*` 与 API 规格 `DD-A*` 两个载体共同承载；`04-详细设计文档.md` 只作为复杂模块或旧项目迁移的可选补充。
- 切片计划引用 `DD-*` 或 `ARCH-*`，并声明 `SLICE-*` 和 `AC-*`。
- 编码任务上下文包含本次实现对应的 `PHASE-*`、`SLICE-*`、`DD-*`、`AC-*`。
