想找 Harness 的官方入口，直接认准这个 GitHub 仓库地址就行：https://github.com/revfactory/harness。别把它和名字相近的脚手架、自动化测试 harness 或者别的 Agent 项目搞混，这个仓库的核心关键词是 Claude Code、agents、skills、team architecture。

进入仓库后先看哪里

首先看 README 顶部的项目定位。项目名底下标着 Team-Architecture Factory for Claude Code，看到这句话就说明你没找错地方。

接着看 Plugin Structure 部分。里面能看到 `.claude-plugin/plugin.json`、`skills/harness/SKILL.md` 还有 references 目录。从这个结构就能看出来，Harness 不是那种单文件的提示词，而是一整套包含插件清单、主 skill 和设计参考文件的组合。

最后看 Installation 部分。官方给了两种安装方式：从 marketplace 安装，或者直接复制 skill 文件。只是想快速上手试试的话走 marketplace 就行；要是想搞懂内部逻辑，就把仓库克隆下来看 skill 文件更清楚。

它自动生成什么

Harness 生成的内容会分两类目录存放。Agent 文件写进 `.claude/agents/`，用来定义团队成员角色；Skill 文件写进 `.claude/skills/`，用来沉淀可触发的工作流程。

生成的时候它会先检查项目已有的结构，避免重复创建同类型的 agent；再决定用 Agent Teams、subagents 还是混合模式。要是任务需要协作、传递上下文、互相复核，默认会选 Agent Teams 模式。

怎样触发生成

最简单的触发指令就写这句：

Build a harness for this project

想要结果更贴合需求的话，可以把项目领域也加上：

Build a harness for a documentation-heavy TypeScript SDK.
Design an agent team for release QA, migration docs, and regression testing.

第二种写法出来的结果更实用。毕竟 Harness 得知道项目里反复出现的任务、质量标准、交付对象和协作方式，才能生成更合适的内容。

读 references 时抓三件事

第一是 agent-design-patterns。里面列了六种模式：流水线、并行汇总、专家池、生产者审稿人、监督者、层级委派。

第二是 orchestrator-template。这里说明了团队怎么创建、怎么派发任务、怎么通过 `_workspace/` 保存中间产物。

第三是 skill-writing-guide。里面强调了 Progressive Disclosure 原则：先用 description 触发，核心流程写在 SKILL.md 里，复杂细节都放到 references 里。

使用时别急着全自动

更稳妥的做法是先让 Harness 生成草案，然后人工核对三项：agent 名称是不是贴合项目，skill 触发描述会不会误触发，orchestrator 有没有把中间文件和验证步骤说清楚。

要是生成的团队太臃肿，就把边界模糊的角色删掉；要是 skill 内容太长，就把细节挪到 references 里；要是所有事都压给同一个 agent，就让 Harness 重新评估下是不是该用 pipeline 或 producer-reviewer 模式。这么调整完，你得到的不是一堆文件，而是一套能长期维护的团队工作方法。