---
status: draft
chapter-type: appendix
---

# 附录 D —— HarnessCard 模板

HarnessCard 格式是一份由 CAR 分解论文 {cite}`car2025decomposition` 所提出的标准化披露。本附录承载三块内容：一份 **空白模板**（拷进你自己的仓库）、两份取自第 15 章的 **已填样本**（并排展示以便读 delta）、以及一份 **评分尺**（定义 0–5 每一档的含义）。

(apd-harnesscard-template)=
## 空白模板

把下面这一整段拷进你仓库根目录的 `HarnessCard.md`。把每一个 `…` 替换成你自己马具的具体证据。

```markdown
# HarnessCard —— <项目名>

**Schema 版本。** CAR-HarnessCard v0.2。
**对象。** <仓库 URL>，commit <SHA>。
**观察窗口。** <YYYY-MM-DD> – <YYYY-MM-DD>。
**许可证。** <SPDX 标识符>。

## 层级注释（CAR）

| 层级     | 注释                                                       |
|----------|------------------------------------------------------------|
| Control  | …                                                          |
| Agency   | …                                                          |
| Runtime  | …                                                          |

## 区域注释（缰绳 ／ 护栏 ／ 牧场 ／ 梳理）

| 区域    | 注释                                                        |
|---------|-------------------------------------------------------------|
| 缰绳    | …                                                           |
| 护栏    | …                                                           |
| 牧场    | …                                                           |
| 梳理    | …                                                           |

## 3 × 4 打分表

| 格子            | 得分（0–5） | 证据（文件 ／ URL）             |
|-----------------|-------------|----------------------------------|
| SDD × 缰绳      | …           | …                                |
| SDD × 护栏      | …           | …                                |
| SDD × 牧场      | …           | …                                |
| SDD × 梳理      | …           | …                                |
| TDD × 缰绳      | …           | …                                |
| TDD × 护栏      | …           | …                                |
| TDD × 牧场      | …           | …                                |
| TDD × 梳理      | …           | …                                |
| MDD × 缰绳      | …           | …                                |
| MDD × 护栏      | …           | …                                |
| MDD × 牧场      | …           | …                                |
| MDD × 梳理      | …           | …                                |

**均值。** SDD ＝ …，TDD ＝ …，MDD ＝ …，总分 ＝ …

**主要引用。** ``<BibTeX key>``。
```

## 两份已填样本 —— 第 15 章 第一幕 vs 第四幕

下面这两份 HarnessCard，是第 15 章那份实例的"前后对"，并排展示，并附一列 delta。完整卡片住在 `_handson/15-lazy-ai-coder/HarnessCard-Act1.md` 与 `_handson/15-lazy-ai-coder/HarnessCard-Act4.md`。

```{list-table}
:header-rows: 1
:widths: 24 14 14 12 36

* - 格子
  - 第一幕
  - 第四幕
  - Delta
  - 修复（来自 14）
* - SDD × 缰绳
  - 3
  - 3
  - 0
  - 未变
* - SDD × 护栏
  - 1
  - 4
  - +3
  - `make prompts-lint` ＋ schema validator（修复 1）
* - SDD × 牧场
  - 2
  - 2
  - 0
  - 未变
* - SDD × 梳理
  - 1
  - 3
  - +2
  - `sources-of-truth.md` 索引（修复 3）
* - TDD × 缰绳
  - 2
  - 2
  - 0
  - 未变
* - TDD × 护栏
  - 1
  - 4
  - +3
  - MCP schema 检查 ＋ gitleaks（修复 2 ＋ 修复 4）
* - TDD × 牧场
  - 3
  - 3
  - 0
  - 未变
* - TDD × 梳理
  - 2
  - 2
  - 0
  - 未变
* - MDD × 缰绳
  - 1
  - 1
  - 0
  - 不在 14 范围内
* - MDD × 护栏
  - 2
  - 2
  - 0
  - 未变
* - MDD × 牧场
  - 2
  - 2
  - 0
  - 未变
* - MDD × 梳理
  - 1
  - 1
  - 0
  - 未变
```

**SDD 均值。** 1.75 → 3.00（+1.25）。**TDD 均值。** 2.00 → 2.75（+0.75）。**MDD 均值。** 1.50 → 1.50（+0.00）。**总分。** 1.75 → 2.42（+0.67）。

## 评分尺 —— 每一档分数的含义

每一格的得分都是 0–5 的整数。这把评分尺钉在 CAR-HarnessCard v0.2 {cite}`car2025decomposition` 上，十二格通用。

| 得分 | 含义 |
|-------|-------------------------------------------------------------------------------------------|
| **0** | 这一格没有任何形式的制品。这个"护法 × 区域"交点是空缺的。        |
| **1** | 存在一件临时凑的制品，但并未按节奏被调用，也无人署名持有。           |
| **2** | 存在一件已提交的制品；有一位署名角色持有它；评审节奏不规律。           |
| **3** | 制品、所有者、节奏三者俱全；该制品被智能体读取（SDD／TDD 行）或被抓取（MDD 行）。 |
| **4** | 该制品是 *被强制执行* 的 —— 不合格会按情况挡住 commit、合并或发布。      |
| **5** | 被强制执行，**而且** 可被机器验证，**而且** 制品本身按一份声明过的节奏（季度或更快）被修订。 |

拿到 4 分需要一个强制执行机制；拿到 5 分则在此之上还需要一份元评审时间表。指不出"强制执行制品"的团队，应该打 3 分，不是 4 分。