# Skill 与验证 Agent

除了四个工作流，插件里的其他 skill 会在任务需要时自动加载。

## 格式 skill

`harness-md` 这个 skill 与插件同名，负责读、写和校验 `HARNESS.md`。
它带着三样东西：一份[规范](https://hoshiori-dev.github.io/harness.md/zh/spec.md)的副本；
一套写作标准，说明一节要写到什么程度，才能单凭文件把 harness 建出来；
还有校验脚本。

校验器只检查单个文件的格式：frontmatter、标题，以及推荐章节的顺序和重复。
它不要求任何章节。它不评判正文写得怎样，插件里也没有比较两份文件的工具。

## 方法论手册

`harness-architecture` 解释每一层为什么存在，一条规则该放在哪里，
以及项目的 Context 怎样决定每一层要做多厚。对方法有疑问时可以问它；
动手建的是工作流和 builder。

## 七个分层 builder

harness 的每一层对应一个 builder。builder 知道这一层怎样设计、怎样建、怎样检查；
这一节必须定下来的每个决定，它都备有默认值。这些名字不用记：
每一层该用哪个 builder，工作流会替你选。

| Builder                | 层          | 这一层管什么                                             |
| ---------------------- | ----------- | -------------------------------------------------------- |
| `environment-building` | Environment | Agent 在哪里运行，手里有哪些工具，能碰到什么             |
| `knowledge-building`   | Knowledge   | 入口文件、知识文件，Agent 什么时候读什么                 |
| `feedback-building`    | Feedback    | Agent 能运行和观察什么来验证自己的工作                   |
| `gates-building`       | Gates       | 确定性的检查：Agent 自己没验证过的缺陷，它们也会拦住     |
| `authority-building`   | Authority   | Agent 可以不问就做什么，以及它怎样提交、分支、合并和发布 |
| `completion-building`  | Completion  | 动手之前怎样对齐目标，怎样算做完                         |
| `entropy-building`     | Entropy     | 怎样让 harness 与代码保持一致                            |

builder 有四种模式。**design** 把这一层的章节写成正文交回；
**extract** 描述项目现在的做法；**build** 创建文件，
也只有这个模式会往项目里写东西；**audit** 报告项目和章节在哪里不一致。

你也可以直接要某一层，比如“给这个仓库把检查配起来”；
这时 builder 先起草这一层的章节，等你批准一次，再动手写文件。

## 日常 skill

这些 skill 用在已经有 harness 的项目里。

| Skill                       | 用途                                              |
| --------------------------- | ------------------------------------------------- |
| `spec-driven-development`   | 先写规范再写代码，并按这个流程走完一次变更        |
| `openspec-workflow`         | 创建、校验和归档 OpenSpec 变更                    |
| `spec-kit-workflow`         | 用 Spec-Kit 把一次变更从规范做到代码              |
| `lightweight-spec-workflow` | 不用框架，靠计划模式或一份 `SPEC.md` 对齐一次变更 |
| `project-skill-building`    | 编写和修复项目留给自己 Agent 用的 skill           |

## 验证 Agent

`harness-verifier` 是一个只读的 Agent。
构建结束后，工作流把新文件交给它，每个文件附一行意图。
它在干净的上下文里读这些文件，就像一个没见过构建过程的 Agent 那样，
然后报告自己会怎样理解，以及文件之间哪里互相矛盾。

它只随 Claude Code 分发，因为 Codex 和 Antigravity 的插件格式里没有放它的位置。
在这两个客户端里，工作流会另找一个干净上下文的子 Agent 来读；
找不到的话，就由 Agent 自己从头重读一遍。