---
name: 设计产物包规则
id: ka-rule-design-artifact-pack
asset_kind: hard_rule
lifecycle_status: active
authority: canonical
scope:
  - all
products:
  - '*'
routes:
  - artifact_generation
  - code_change
primary_triggers:
  - 架构设计文档
  - 数据库设计文档
  - API接口规格文档
priority: P0
specificity: 5
version: 1.0.0
last_reviewed: '2026-05-25'
owner_mechanism_id: mc-design-artifact-pack
hard_blocks:
  - 未经复验的设计文档支撑编码或交付
  - API 缺字段级契约
  - 数据库 SQL 不可执行
  - 跨设计产物关键冲突
required_evidence:
  - design_artifact_pack
  - consistency_verification
consumes:
  - architecture_decision_workshop
  - docs/architecture/00-架构决策记录.md
  - docs/architecture/01-架构设计文档.md
fallback: manual_required
type: rule
status: active
---

# 设计产物包规则

## 权威资产

- 决策和确认以 `00-架构决策记录.md` 为准。
- 总体架构以 `01-架构设计文档.md` 为准。
- 详细设计的必需承载是 `02-数据库设计文档.md` 和 `03-API接口规格文档.md`；`04-详细设计文档.md` 只是兼容旧项目或复杂模块的可选补充，不得被门禁强制要求。
- 数据库物理结构以真实 SQL/migration 为准，`02-数据库设计文档.md` 解释和追踪。
- API 路径和字段 schema 以 `docs/api/openapi.yaml` 为准，`03-API接口规格文档.md` 补充业务语义。
- 开发切片以 `04-开发切片计划.md` 为准，作为全项目切片索引承载 `PHASE-*`、`SLICE-*`、状态、依赖和验收顺序；旧 `04-第一阶段开发切片计划.md` 只能作为迁移提示，不得作为新项目标准输出，也不得单独作为设计产物包通过依据。
- 需求、原型、架构、详细设计、切片、实现和验收之间的身份关系以 `docs/traceability/01-需求原型设计实现追踪矩阵.md` 为准。
- `99-设计一致性验收报告.md` 只记录真实验证结果。

## 生命周期输入输出

| 节点 | 必需输入 | 必需输出 | 进入下一节点的硬门禁 |
| --- | --- | --- | --- |
| 需求输入 | 用户需求材料 | `REQ-*` 与需求文档 | 需求进入追踪矩阵 |
| 原型提取 | 原型材料 | `PROTO-*` 与原型说明 | 原型进入追踪矩阵 |
| 架构设计 | `REQ-*`、`PROTO-*` | `00-架构决策记录.md`、`01-架构设计文档.md`、`ARCH-*` | 架构引用需求或原型，决策已确认 |
| 详细设计 | `ARCH-*` | `02-数据库设计文档.md`、`03-API接口规格文档.md`、`DD-T*`、`DD-A*`、OpenAPI、SQL/migration | DB/API 设计引用架构，OpenAPI 和 SQL 权威资产存在 |
| 切片规划 | `DD-*` 或 `ARCH-*` | `04-开发切片计划.md`、`PHASE-*`、`SLICE-*`、`AC-*` | 切片绑定阶段、设计来源和验收 ID |
| 实现 | 追踪矩阵与切片计划 | 真实 `changed_files` | 任务绑定 `SLICE-*`、`DD-*`、`AC-*` |
| 测试 | 真实 `changed_files` 与验收 ID | 真实命令执行结果 | 不能把验证计划当验证结果，验证必须覆盖变更 |
| 验收/交付 | 测试结果和设计产物包 | `99-设计一致性验收报告.md` 与交付摘要 | hard_fail 清零并保留消费 trace |

## 硬底线

- 每个 endpoint 必须具备请求和响应字段级说明，JSON 示例不能替代字段表。
- SQL、OpenAPI、架构、数据库和 API 文档出现关键漂移时必须阻断。
- 旧文档在新标准下必须先审计；未经确认和复验不得继续作为编码依据。
- 升级必须默认 dry-run，确认写入时归档原文件和 hash。
