项目介绍
Harness v2 是一个面向 Claude Code 的团队架构生成插件。它先读取项目里已有的 Agent、Skill 和 CLAUDE.md,再根据任务是否需要固定流程、持续对话或一次性结果,生成新的专业 Agent、配套 Skill 与编排器。它适合已有复杂重复任务、愿意维护项目级 Agent 配置的团队。首次使用最好放在测试分支,先看清它准备新增和修改的文件,再运行最小团队流程。
核心功能
项目级团队设计
Harness 会检查现有 Agent、Skill 和 CLAUDE.md,判断是新建、扩展还是维护已有配置,再为项目拆分专业角色。
三种执行方式
固定列表和验证流程可用 Workflow,长期协作可用有名字的 Agent 与 SendMessage,只需一次结果时可采用并行子 Agent。
团队模式与质量检查
文档提供六种团队模式,并要求加入失败处理、结构校验、调用条件测试、实际请求测试和至少一条错误场景。
运行反馈迭代
evolve Skill 会读取 Harness 文件、git 变更和中间产物,把重复出现的反馈归纳成可复用规则,再逐项修改和验证。
v1 配置迁移
迁移指南说明如何移除 TeamCreate、TeamDelete 和实验功能标记,并改用 Workflow、Agent、SendMessage 与共享任务。
安装与使用
先在测试项目里通过 Claude Code Marketplace 安装 Harness v2,再让插件为一个范围明确的小任务设计团队。确认它生成的文件、调用条件和执行方式都符合预期后,再把配置扩展到主项目。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我安装 Harness v2。项目地址是 https://github.com/revfactory/harness。请先阅读 README、docs/quickstart.md、.claude-plugin/plugin.json 和 skills/harness/SKILL.md,核对当前 Claude Code 版本与现有 .claude 配置,再使用仓库提供的 Marketplace 命令安装。安装后运行 /plugin list,并只在测试项目中生成一个最小 Harness,列出新增和修改的文件。遇到凭据、额外权限、Workflow 调用、覆盖现有文件或大规模并行 Agent 时先询问我。- 最新版 Claude Code
- 能够访问 github.com
- 一个允许新增或修改 .claude/agents、.claude/skills 与 CLAUDE.md 的测试项目
- 为多 Agent 测试预留足够的令牌与调用额度
/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace- 1添加 Marketplace 并安装插件
在 Claude Code 中依次运行 /plugin marketplace add revfactory/harness 和 /plugin install harness@harness-marketplace。完成后运行 /plugin list,确认 harness 已经出现。
- 2检查项目现有配置
进入测试项目后,先查看 .claude/agents、.claude/skills 与 CLAUDE.md 是否已有内容。记录不能覆盖的文件和需要保留的调用条件。
- 3生成一个最小团队
向 Claude Code 提出范围明确的请求,例如为当前项目建立代码实现和审查 Harness。让插件先说明团队角色、执行方式和准备写入的路径,再确认生成。
- 4审查并运行最小验证
检查新 Agent、Skill、编排器与 CLAUDE.md 记录是否一致,确认没有旧版 TeamCreate、TeamDelete 或实验标记。只运行一条小任务,核对中间产物、失败处理和最终结果。
- 5按反馈逐项调整
真实运行后再调用 evolve Skill。一次只改一类问题,保留修改原因与测试结果,避免把单次反馈直接写成只适用于一个案例的规则。
安装后运行 /plugin list,确认 harness 已列出。随后在测试项目中请求“build a harness for this project”,检查是否生成 .claude/agents、.claude/skills 和 CLAUDE.md 记录;先审查差异,不要直接运行大规模 Agent 团队。
- README 没有给出卸载命令,本页不推测卸载方式。
- Workflow 需要用户明确同意,生成配置也应在写入前核对冲突和覆盖范围。
- 多 Agent 测试可能消耗数万到数十万令牌,先从两到三个角色的小流程开始。
使用场景
实现与审查分离
为开发任务建立生成与验证角色,让实现者产出改动,审查者按独立标准检查,再由编排器汇总。
批量研究与汇总
把预先列出的资料分给多个 Agent 处理,并用结构化返回值或文件把结果交给汇总阶段。
长期专家协作
为需要多轮反馈的架构或内容任务建立有名字的 Agent,让它们通过消息和共享任务保持上下文。
旧版 Harness 迁移
检查 v1 配置中的 TeamCreate、TeamDelete 和实验标记,再按 v2 的三种执行方式重新连接 Agent 与 Skill。
使用评价
这项判断来自 README、Quickstart、两个 Skill、迁移文档和 CHANGELOG,没有把文档审阅写成亲自使用。Harness v2 的长处在于把团队设计、Skill 编写、编排、测试和后续迭代放进同一套项目文件中,规则也明确要求先检查重复角色和旧配置。它的成本同样直观。生成过程会接触项目级配置,多 Agent 运行会增加令牌消耗,最终效果还取决于宿主模型、工具权限和维护者是否认真审查生成内容。
值得一试的地方
- 安装入口简短,插件清单、核心 Skill、迁移说明和更新记录都可公开核验
- 执行方式和团队模式有具体选择标准,生成物路径与验证清单清楚
- evolve Skill 给出了从运行反馈到逐项修改和回归检查的完整路径
使用前要知道
- 功能只在仓库文档层面核验,没有完成安装或端到端测试
- 生成内容会改动项目配置,采用者需要自己处理覆盖、权限和版本控制
- 作者的 v1 小样本对比不能证明 v2 在不同代码库中稳定提升质量
README
Harness v2
Overview
为 Claude Code 分析项目需求并生成专用 Agent、Skill 与编排规则的社区插件,支持工作流、持续型协作和一次性子 Agent 三种执行方式。 A meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.
Getting started
- 先在测试项目里通过 Claude Code Marketplace 安装 Harness v2,再让插件为一个范围明确的小任务设计团队。确认它生成的文件、调用条件和执行方式都符合预期后,再把配置扩展到主项目。
- Harness v2 根据项目领域设计 Agent 团队,并把角色定义、工作方法和调用条件写进项目级配置。
- 它提供工作流编排、持续型 Agent 协作和一次性子 Agent 三种执行方式,允许按阶段混合使用。
- 安装后运行 /plugin list,确认 harness 已列出。随后在测试项目中请求“build a harness for this project”,检查是否生成 .claude/agents、.claude/skills 和 CLAUDE.md 记录;先审查差异,不要直接运行大规模 Agent 团队。
Configuration
/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace在 GitHub 阅读完整 README →