---
name: 验收模板输出契约规则
scope:
  - '*'
products:
  - '*'
id: ka-hard-rule-验收模板输出契约规则
asset_kind: hard_rule
lifecycle_status: active
authority: canonical
owner_mechanism_id: mc-standard-asset-contract
routes:
  - artifact_generation
  - code_change
  - verification
primary_triggers:
  - 验收模板
  - 标准输出
  - 设计产物
secondary_triggers:
  - API接口规格
  - 数据库设计
  - 架构设计
negative_triggers:
  - 普通解释
  - 简单 bugfix
priority: P0
specificity: 5
consumes:
  - standard_asset_contract
  - design_artifact_pack
  - repair_reverify_directive
hard_blocks:
  - template_contract_violation
  - draft_artifact_consumed
  - missing_authoritative_asset
fallback: manual_required
required_evidence:
  - template_contract_result
  - authoritative_asset
  - repair_reverify_result
version: 1.0.0
last_reviewed: '2026-05-26'
status: active
---

# 验收模板输出契约规则

## 触发条件

当任务产出正式设计文档、架构设计、数据库设计、API 接口规格、原型说明或验收报告时，必须按标准资产契约验收。

## 适用范围

- 架构设计文档（01-架构设计文档.md）
- 数据库设计文档（02-数据库设计文档.md）
- API 接口规格（03-API接口规格文档.md）
- 设计一致性验收报告（99-设计一致性验收报告.md）
- 原型说明文档

## 契约要求

每个 P0 模板输出必须满足:

1. **章节检查**: 必填章节存在、顺序合理、不得只有空标题。
2. **表格检查**: 必填表格存在、表头正确、行内容覆盖必要对象。
3. **字段检查**: API/数据/追踪字段具备类型、必填、来源、说明、示例、校验规则、错误语义。
4. **权威资产检查**: 必须引用并对齐 OpenAPI、SQL/migration 等机器权威资产。
5. **语义检查**: Mermaid 图、字段、实体与当前业务相关，不得用无关内容凑数。

## API 字段表最小列

字段名 / 类型 / 必填 / 来源 / 说明 / 示例 / 校验规则 / 错误语义

## Mermaid 检查规则

- fence 语法合法。
- 图类型符合模板要求（sequenceDiagram、flowchart 等）。
- 图内容与当前业务相关。

## 修复闭环

模板契约验收失败必须进入修复重验:

1. sf_verify 报告缺口和诊断码。
2. 修复后重新 sf_verify。
3. 仍然失败则继续循环或请求用户确认。
4. 修复期间交付被阻断。

## 草稿状态

草稿必须显式标记 `draft`、`not_for_implementation` 或 `needs_template_verification`。草稿不进入编码消费。

## 低风险跳过

普通 bugfix、样式修复、只读解释和小范围改动不触发模板契约验收。
