为你的项目找一份 HARNESS.md

浏览 hub 里的全部 3 个条目

HARNESS.md 是什么

HARNESS.md 记录一个项目的 Agent harness 设计:编码 Agent 在哪里运行,读什么,怎样检查自己的工作,什么会拦住一次错误的改动,哪些事它可以不问就做。入口文件、权限文件、Hook 和 CI 配置都照着它来建。

它有两种用法。当作模板:从 hub 里挑一份存到项目根目录,告诉编码 Agent 这个项目要做什么,让它先对照你的项目核对文件里的 Context 一节,再把 harness 建出来;建完可以把文件删掉。当作锚定文档:把它长期留在仓库里,作为项目的设计记录,很少改动,只在检查 harness 有没有漂移或者要改进它的时候才打开。

写 HARNESS.md 时可以对照规范,读懂它不靠规范。Agent 即使从没见过规范,也没装任何插件,照样能读懂这份文件并照着做。

接下来看什么

  • 阅读规范完整的格式定义,一页读完。
  • 浏览 hub可以直接存进项目、当作 HARNESS.md 用的条目。
  • 安装插件一组 skill,在 Claude Code、Codex 和 Antigravity 里设计、构建、提取和审计 harness。

文件里有什么

开头是一段简短的 frontmatter,写明文件的名称和说明;后面是标题、一段导言和正文,正文用哪些标题由设计决定。规范推荐下面十三个标题和这个顺序,没有一个是必选的。

  1. Context影响设计的项目条件:出错的代价、团队、平台
  2. Invariants每个任务都要遵守的规则
  3. Style代码应该是什么样,Agent 才能在里面工作
  4. File Structure设计要求的目录和文件
  5. EnvironmentAgent 在哪里运行,能碰到什么
  6. KnowledgeAgent 读什么,什么时候读
  7. FeedbackAgent 怎样验证自己的工作
  8. Gates拦住缺陷的检查
  9. Authority哪些事 Agent 可以自己做,哪些需要人
  10. Completion怎样对齐目标,怎样算做完
  11. Entropyharness 怎样与代码保持一致
  12. Open Questions还没有决定的事
  13. References这份设计依据的资料