1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | harness |
| 作者/维护者 | Minho Hwang(GitHub 账号 revfactory;资料公开注明供职于 Kakao;账号注册于 2012 年,299 个公开仓库) |
| 来源链接 | https://github.com/revfactory/harness |
| 许可证 | Apache-2.0(GitHub API 验证) |
| GitHub Stars | 8,421(GitHub API 实测,2026-07-20) |
| Forks | 1,149(GitHub API 实测) |
| 最新版本 | 1.2.0(插件清单 .claude-plugin/plugin.json 标注;仓库未使用 GitHub Release/Tag) |
| 安装方式 | Claude Code 插件市场一键安装,或直接拷贝 skill 目录 |
项目自述名称为「Harness」,与正式名称一致。
2. 功能介绍与亮点
harness 是一个“元技能”:它自己不直接干活,而是根据你用一句话描述的领域/项目需求,设计一整套专属的 Agent 团队架构,并生成这些 Agent 各自要用的技能文件。核心工作流分六个阶段:① 领域分析 → ② 团队架构设计(在 Agent Team 与子 Agent 两种执行模式之间选择,并从流水线、扇出扇入、专家池、生成-校验、监督者、层级委派六种架构模式中挑选)→ ③ 生成 Agent 定义文件 → ④ 生成配套技能(遵循渐进式信息披露原则)→ ⑤ 整合编排 → ⑥ 验证测试。
亮点:① 内置“存量检测”机制——每次调用都会先审计项目里已有的 Agent 与技能,避免重复搭建同类角色;② 生成结果落地为标准 .claude/agents/ 与 .claude/skills/ 文件,可版本控制、可跨会话复用;③ 全仓库仅由 SKILL.md 与 Markdown 参考文档构成,不含任何可执行脚本;④ 提供英语、韩语、日语三语 README;⑤ 被第三方策展的 Awesome Claude Code 列表收录。
3. 适用场景
固定分类:元技能与Agent增强。
面向已经在使用 Claude Code、需要为不同项目或领域反复搭建专属多智能体协作团队的开发者与团队负责人——例如需要并行开展深度研究、全栈开发流水线、内容生产、代码评审多维核查或数据管道设计等复杂任务时,用一句话描述需求即可生成对应的 Agent 团队与技能集,而不必每次手工设计角色分工。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——明确基于 Claude Code 的 Agent Team 系统构建,工作流直接依赖 TeamCreate / SendMessage / TaskCreate 等原生工具
- Codex:❌ 不支持——仓库 README 说明 Codex 版本由另一个独立项目(
SaehwanPark/meta-harness)单独提供,本仓库不含 Codex 适配 - OpenClaw:❓ 未验证——仓库文档与 Issues 均未提及 OpenClaw
- Hermes Agent:❓ 未验证——仓库文档与 Issues 均未提及 Hermes Agent
判断依据:以上结论均基于仓库 README「Coexistence」章节与已抓取的 Issue 讨论,未就兼容性单独发起搜索。
5. 推荐理由
让Claude Code从单智能体升级为按需生成的专属多智能体协作团队。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | GitHub 8,421 星、1,149 fork(API 实测);被第三方 Awesome Claude Code 列表收录,且列表维护者在 Issue 中确认亲自试用可用 |
| 可用性 | 8 | 插件市场一条命令即可安装,SKILL.md 附 6 份参考文档,近期仍有提交维护,无付费依赖;但多智能体团队编排概念本身有一定门槛,非纯模板类技能可比 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单逐项:①仓库内容为 SKILL.md + 参考 Markdown 文档,不含任何可执行脚本或 shell 命令,生成的文件产出全部通过 Claude Code 原生 Agent/TeamCreate/SendMessage/TaskCreate 工具完成 ②无独立网络外发,唯一的联网行为来自 Claude Code 自身工具按需调用 ③不要求任何 API Key 或账号凭据 ④已直接读取 SKILL.md 全文及全部参考文档,未发现提示注入或可疑指令 ⑤作者身份公开可查(GitHub 账号 2012 年注册,299 个仓库,供职于 Kakao),仓库结构干净 ⑥Apache-2.0 许可证明确(GitHub API 验证)⑦最近一次提交为 2026-07-20,持续活跃维护
综合评分:8.7(三项均值,四舍五入至一位小数)
7. 跟同类 Skills 相比的优势
| 名称 | Star | 定位 | 与 harness 的差异 |
|---|---|---|---|
| harness(本次推荐) | 8,421 | 一句话领域描述 → 生成专属 Agent 团队架构 + 配套技能,6 种预定义团队模式 | 面向“团队架构设计”这一件事,产出是可版本控制的 .claude/agents/ 与 .claude/skills/ 文件 |
| Archon (coleam00/Archon) | 22,952 | “harness 构建器”——生成确定性、可重复的运行时配置 | 关注运行时配置的确定性与可复现性,不负责设计多 Agent 团队分工;二者可组合使用 |
| BMad-Method (bmad-code-org/bmad-method) | 50,854 | 面向敏捷 AI 驱动开发的完整方法论框架,含预定义角色与流程模板 | 提供一套固定的敏捷开发角色体系,而非按任意领域动态生成团队架构;更偏向“方法论落地”而非“团队生成器” |
| wshobson/agents | 38,080 | 多 harness 通用的 Agent/技能市场,收录 182 个 Agent、149 个技能供直接选用 | 定位是“零件供应商”——提供现成 Agent/技能目录直接挑选安装;harness 是“工厂”——根据需求现场设计并生成新的团队与技能 |
差异化总结:Archon 和 wshobson/agents 分别解决“运行时确定性”与“现成零件供应”,BMad-Method 提供固定的敏捷方法论角色体系;harness 的差异化定位是——不预设任何领域,用一句话描述就能现场设计出针对性的 Agent 团队分工与技能集,四者可以分层组合使用而非互斥选择。
8. 用户评价
Awesome Claude Code 列表维护者 hesreallyhim 在仓库 Issue #2 中留言:“found your resource and added you to the list… they still seemed to work when I tried them”——说明其在收录前亲自试用过该技能并确认可正常工作(来源:GitHub Issue,https://github.com/revfactory/harness/issues/2 )。除此之外,尚未找到其他已验证的独立第三方具名评价。
9. 其他补充
作者关联项目 revfactory/harness-100 提供 100 套基于 harness 预生成的领域团队包(中英双语共 200 份)。仓库 README 引用了一份作者自撰的效果评估(revfactory/claude-code-harness 仓库内,15 项软件工程任务的 A/B 对比,自评“质量分数从 49.5 提升至 79.3”);经查该文献未见于 arXiv 或同行评审期刊,仅托管在作者自己的仓库中,属自测数据,尚无第三方复现记录。
10. 安装使用方式
# 方式一:插件市场安装
/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace
# 方式二:直接拷贝为全局技能
cp -r skills/harness ~/.claude/skills/harness
安装后无需重启,直接在 Claude Code 对话中输入类似“Build a harness for this project”或“帮这个项目搭建一个 harness”即可触发;触发后会先审计项目内已有的 .claude/agents/、.claude/skills/ 与 CLAUDE.md,再决定走全新搭建还是增量扩展流程。
11. 注意事项
- 该技能的工作流要求所有生成的 Agent 统一使用
model: "opus",实际使用成本高于普通对话或轻量技能,需评估是否符合自身用量预算 - 仓库历史 Issue 显示曾出现插件市场安装命令与 README 描述不一致导致安装失败的问题(Issue #20),目前 README 已更新为可用命令,但如遇安装报错可参考该 Issue 的社区修复方案
- Codex 的适配由作者名下另一个独立仓库(
SaehwanPark/meta-harness)提供,并非本仓库自带能力;OpenClaw、Hermes Agent 的兼容性均未见任何文档或社区讨论提及 - README 引用的自测效果数据(+60% 质量提升等)为作者自评,未经同行评审或第三方复现,使用时不宜直接当作保证值
- 仓库以单一作者为主要维护者,长期维护的连续性依赖其个人投入