harness
为 Claude Code 设计的 meta-skill，输入简短领域描述即可自动生成专属的 agent 团队定义与技能文件。内置 6 种团队架构模式（流水线、扇出/扇入、专家池等），支持子 agent 与验证测试，配合 Claude Code 的 agent 团队功能使用。作者实测 A/B 测试显示质量提升 60%（n=15，第三方待复现），适合复杂软件开发、研究等需要多 agent 协作的场景。Apache 2.0 许可。
README
Harness — 面向 Claude Code 的团队架构工厂
Harness 是一个团队架构工厂。 在 Claude Code 中输入 "build a harness for this project"（英文）或 "하네스 구성해줘"（韩文）或 "ハーネスを構成して"（日文），该插件会将你的领域描述转化为一个智能体（Agent）团队以及他们使用的技能——这些均从六种预定义的团队架构模式中选取。
概述
Harness 利用 Claude Code 的 Agent Team（智能体团队）系统，将复杂任务分解为协调运作的专项智能体团队。输入"为这个项目构建一个 harness"，它将自动生成适配你领域的智能体定义（.claude/agents/）和技能定义（.claude/skills/）。
分类——Harness 所处的位置
Harness 位于 Claude Code 生态系统的 L3 元工厂层——这一层不是生成一个 harness，而是生成其他 harness。在 L3 内部，我们选择了一个特定的子层：团队架构工厂。
| 层级 | 功能 | 我们与之共存的相邻项目 |
|---|---|---|
| L3 — 元工厂 / 团队架构工厂（我们） | 领域描述 → 智能体团队 + 技能，基于 6 种预定义团队模式 | — |
| L3 — 元工厂 / 运行时配置工厂 | 确定性、可重复的运行时配置 | coleam00/Archon |
| L3 — 元工厂 / Codex 运行时移植 | 相同概念，Codex 运行时 | SaehwanPark/meta-harness |
| L2 — 跨 Harness 工作流 | 跨多个 harness 标准化技能/规则/钩子 | affaan-m/ECC |
Archon 生成确定性的运行时配置。Harness 生成团队架构（Pipeline（流水线）、Fan-out/Fan-in（扇出/扇入）、Expert Pool（专家池）、Producer-Reviewer（生产-审核）、Supervisor（监督者）、Hierarchical Delegation（层次化委派））以及智能体使用的技能。它们是同一 L3 层的不同子层。需要运行时确定性选 Archon，需要团队架构选 Harness，或者也可以组合使用。
星标历史
主要特性
- 智能体团队设计 — 6 种架构模式：Pipeline（流水线）、Fan-out/Fan-in（扇出/扇入）、Expert Pool（专家池）、Producer-Reviewer（生产-审核）、Supervisor（监督者）、Hierarchical Delegation（层次化委派）
- 技能生成 — 自动生成技能，采用渐进式披露（Progressive Disclosure）实现高效的上下文管理
- 编排（Orchestration） — 智能体间的数据传递、错误处理和团队协调协议
- 验证（Validation） — 触发器验证、试运行测试、带技能 vs 不带技能的比较测试
工作流
阶段 1：领域分析
↓
阶段 2：团队架构设计（Agent Teams vs Subagents）
↓
阶段 3：智能体定义生成（.claude/agents/）
↓
阶段 4：技能生成（.claude/skills/）
↓
阶段 5：集成与编排
↓
阶段 6：验证与测试
安装
通过市场安装
添加市场
/plugin marketplace add revfactory/harness
安装插件
/plugin install harness@harness-marketplace
直接安装为全局技能
# 将技能目录复制到 ~/.claude/skills/harness/
cp -r skills/harness ~/.claude/skills/harness
插件结构
harness/
├── .claude-plugin/
│ └── plugin.json # 插件清单
├── skills/
│ └── harness/
│ ├── SKILL.md # 主技能定义（6 阶段工作流）
│ └── references/
│ ├── agent-design-patterns.md # 6 种架构模式
│ ├── orchestrator-template.md # 团队/子智能体编排器模板
│ ├── team-examples.md # 5 个真实团队配置案例
│ ├── skill-writing-guide.md # 技能编写指南
│ ├── skill-testing-guide.md # 测试与评估方法
│ └── qa-agent-guide.md # QA 智能体集成指南
└── README.md
用法
在 Claude Code 中通过如下提示触发：
为这个项目构建一个 harness
为这个领域设计一个智能体团队
设置一个 harness
执行模式
| 模式 | 描述 | 推荐场景 |
|---|---|---|
| Agent Teams（智能体团队）（默认） | TeamCreate + SendMessage + TaskCreate | 需要协作的 2 个以上智能体 |
| Subagents（子智能体） | 直接调用 Agent 工具 | 一次性任务，无需智能体间通信 |
架构模式
| 模式 | 描述 |
|---|---|
| Pipeline（流水线） | 顺序执行的相关任务 |
| Fan-out/Fan-in（扇出/扇入） | 并行执行的独立任务 |
| Expert Pool（专家池） | 根据上下文选择性调用 |
| Producer-Reviewer（生产-审核） | 生成后接质量审核 |
| Supervisor（监督者） | 中央智能体动态分配任务 |
| Hierarchical Delegation（层次化委派） | 自上而下的递归委派 |
输出
Harness 生成的文件：
your-project/
├── .claude/
│ ├── agents/ # 智能体定义文件
│ │ ├── analyst.md
│ │ ├── builder.md
│ │ └── qa.md
│ └── skills/ # 技能文件
│ ├── analyze/
│ │ └── SKILL.md
│ └── build/
│ ├── SKILL.md
│ └── references/
使用案例 —— 试试这些提示
在安装 Harness 后，将以下任何一条提示复制到 Claude Code 中：
深度研究
为深度研究构建一个 harness。我需要一个智能体团队，能够从多个角度调查
任何主题——网络搜索、学术来源、社区情绪——然后交叉验证发现并生成综合报告。
网站开发
为全栈网站开发构建一个 harness。团队应处理设计、前端（React/Next.js）、后端（API）
和 QA 测试，串联起从线框到部署的流程。
网络漫画 / 漫画制作
为网络漫画剧集制作构建一个 harness。我需要负责故事写作、角色设计提示、
分镜布局和对话编辑的智能体。他们应相互审查以确保风格一致性。
YouTube 内容规划
为 YouTube 内容创建构建一个 harness。团队应研究热门话题、撰写脚本、
优化标题/标签以利 SEO，并规划缩略图概念——全部由监督智能体协调。
代码审查与重构
为全面代码审查构建一个 harness。我希望并行智能体检查架构、安全漏洞、
性能瓶颈和代码风格——然后将所有发现合并为一份报告。
技术文档
基于此代码库构建一个生成 API 文档的 harness。智能体应分析端点、编写描述、
生成使用示例，并审查完整性。
数据管道设计
为数据管道设计构建一个 harness。我需要负责模式设计、ETL 逻辑、
数据验证规则和监控设置的智能体，以层次化方式委派子任务。
营销活动
为营销活动创建构建一个 harness。团队应研究目标市场、撰写广告文案、
设计视觉概念，并制定 A/B 测试计划，附带迭代质量审核。
共存 —— Harness 与邻近项目
Harness 并非孤立于 Claude Code / 智能体框架生态系统。以下仓库位于相邻层级；每个都以"X 是……，Harness 是……"的并行形式描述，以便你根据需要选择合适的项目或组合使用多个项目。
| 仓库 | 他们的定位 | 与 Harness 的关系 |
|---|---|---|
| coleam00/Archon | "harness 构建器" —— 确定性、可重复的运行时配置 | 同一 L3 层，相邻子层。 Archon 是运行时配置工厂，Harness 是团队架构工厂。需要运行时确定性选 Archon，需要团队架构选 Harness，或者组合使用。 |
| SaehwanPark/meta-harness | 同一概念的 Codex 移植版本 | 同一 L3 层，不同运行时。 在 Claude Code 上用 Harness，在 Codex 上用 meta-harness。 |
| affaan-m/ECC | "智能体 harness 性能与工作流层"（位于现有 harnesses 之上） | 不同层级。 ECC 是跨 harness 的标准化层；Harness 是生成 harness 的工厂。可以串联使用。 |
| wshobson/agents | 子智能体 / 技能目录（182 个智能体，149 个技能） | 工厂 ↔ 零件供应。 wshobson 是可供挑选的目录；Harness 设计团队。可以将 wshobson 的条目作为零件吸收到 Harness 生成的团队中。 |
| LangGraph | 状态图编排，不依赖特定 LLM | 不同路线。 LangGraph 适用于长时间运行、可恢复状态的编排；Harness 适用于快速的 Claude Code 原生团队设计。 |
用 Harness 构建的项目
Harness 100
revfactory/harness-100 —— 100 个生产就绪的智能体团队 harness，覆盖 10 个领域，提供英文和韩文版本（共 200 个包）。每个 harness 包含 4-5 个专项智能体、一个编排器技能和领域特定技能——全部由此插件生成。共 1,808 个 markdown 文件，涵盖内容创作、软件开发、数据/AI、业务战略、教育、法律、健康等领域。
研究：A/B 测试 Harness 有效性
revfactory/claude-code-harness —— 一项控制实验，涵盖 15 个软件工程任务，测量结构化预配置对 LLM 代码智能体输出质量的影响。
| 指标 | 无 Harness | 有 Harness | 提升 |
|---|---|---|---|
| 平均质量评分 | 49.5 | 79.3 | +60% |
| 胜率 | — | — | 100%（15/15） |
| 输出方差 | — | — | -32% |
关键发现：有效性随任务复杂度递增——任务越难，提升越大（基础任务 +23.8，高级任务 +29.6，专家任务 +36.2）。
各处使用的精确表述： 平均质量 +60%（49.5 → 79.3），15/15 胜率，方差 −32%（n=15，作者测量 A/B，第三方复现待进行）。
完整论文：Hwang, M. (2026). Harness: Structured Pre-Configuration for Enhancing LLM Code Agent Output Quality.
系统要求
- 启用 Agent Teams：
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
常见问题
Q1. "+60%" 是否过度宣传？A. +60% 数据来自作者测量的 A/B 测试（n=15，15 个任务，在姊妹仓库 claude-code-harness 上测量）。本仓库中每处引用该数字时，均在相同句子中附有说明"n=15，作者测量，第三方复现待进行"。对于是否采用的决定，我们建议进行 2-4 周的内部试点，并测量你自己的数据。
证据：
- 作者 A/B 测试：revfactory/claude-code-harness
- 论文：Hwang, M. (2026). Harness: Structured Pre-Configuration for Enhancing LLM Code Agent Output Quality.
A. Archon 生成确定性的运行时配置——它是一个运行时配置工厂。Harness 生成智能体团队架构（团队结构、消息协议、审查关卡）——它是一个团队架构工厂。它们是同一 L3 元工厂的相邻子层，服务于不同需求。需要运行时确定性选 Archon，需要团队架构模式选 Harness，或者组合使用（用 Harness 设计架构 → 用 Archon 部署运行时）。
证据：
- Archon 自身定义：clawfit docs/reference-levels.md
- 子层声明：参见上文分类——Harness 所处的位置章节
- Archon 仓库：github.com/coleam00/Archon
A. 目前官方运行时仅支持 Claude Code。同一概念的 Codex 移植版本——SaehwanPark/meta-harness——已经公开，Codex 团队可以从此处开始。Harness 选择了"面向 Claude Code 原生，深度集成"而非"多运行时，浅层覆盖"；与姊妹仓库（meta-harness、harness-init、OpenRig）的跨运行时协作已列入路线图。
证据：
- Codex 移植版本：github.com/SaehwanPark/meta-harness
- 跨运行时脚手架：github.com/Gizele1/harness-init
许可证
Apache 2.0