Agent 插件 · 社区项目

Harness v2

为 Claude Code 分析项目需求并生成专用 Agent、Skill 与编排规则的社区插件,支持工作流、持续型协作和一次性子 Agent 三种执行方式。

9.1k StarsApache-2.04 天前更新
01

项目介绍

Harness v2 是一个面向 Claude Code 的团队架构生成插件。它先读取项目里已有的 Agent、Skill 和 CLAUDE.md,再根据任务是否需要固定流程、持续对话或一次性结果,生成新的专业 Agent、配套 Skill 与编排器。它适合已有复杂重复任务、愿意维护项目级 Agent 配置的团队。首次使用最好放在测试分支,先看清它准备新增和修改的文件,再运行最小团队流程。

02

核心功能

01

项目级团队设计

Harness 会检查现有 Agent、Skill 和 CLAUDE.md,判断是新建、扩展还是维护已有配置,再为项目拆分专业角色。

02

三种执行方式

固定列表和验证流程可用 Workflow,长期协作可用有名字的 Agent 与 SendMessage,只需一次结果时可采用并行子 Agent。

03

团队模式与质量检查

文档提供六种团队模式,并要求加入失败处理、结构校验、调用条件测试、实际请求测试和至少一条错误场景。

04

运行反馈迭代

evolve Skill 会读取 Harness 文件、git 变更和中间产物,把重复出现的反馈归纳成可复用规则,再逐项修改和验证。

05

v1 配置迁移

迁移指南说明如何移除 TeamCreate、TeamDelete 和实验功能标记,并改用 Workflow、Agent、SendMessage 与共享任务。

03

安装与使用

先在测试项目里通过 Claude Code Marketplace 安装 Harness v2,再让插件为一个范围明确的小任务设计团队。确认它生成的文件、调用条件和执行方式都符合预期后,再把配置扩展到主项目。

AI AGENT INSTALL

让 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 时先询问我。
01开始前准备
  • 最新版 Claude Code
  • 能够访问 github.com
  • 一个允许新增或修改 .claude/agents、.claude/skills 与 CLAUDE.md 的测试项目
  • 为多 Agent 测试预留足够的令牌与调用额度
02复制安装命令或配置
/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace
03按步骤完成安装
  1. 1
    添加 Marketplace 并安装插件

    在 Claude Code 中依次运行 /plugin marketplace add revfactory/harness 和 /plugin install harness@harness-marketplace。完成后运行 /plugin list,确认 harness 已经出现。

  2. 2
    检查项目现有配置

    进入测试项目后,先查看 .claude/agents、.claude/skills 与 CLAUDE.md 是否已有内容。记录不能覆盖的文件和需要保留的调用条件。

  3. 3
    生成一个最小团队

    向 Claude Code 提出范围明确的请求,例如为当前项目建立代码实现和审查 Harness。让插件先说明团队角色、执行方式和准备写入的路径,再确认生成。

  4. 4
    审查并运行最小验证

    检查新 Agent、Skill、编排器与 CLAUDE.md 记录是否一致,确认没有旧版 TeamCreate、TeamDelete 或实验标记。只运行一条小任务,核对中间产物、失败处理和最终结果。

  5. 5
    按反馈逐项调整

    真实运行后再调用 evolve Skill。一次只改一类问题,保留修改原因与测试结果,避免把单次反馈直接写成只适用于一个案例的规则。

如何确认安装成功

安装后运行 /plugin list,确认 harness 已列出。随后在测试项目中请求“build a harness for this project”,检查是否生成 .claude/agents、.claude/skills 和 CLAUDE.md 记录;先审查差异,不要直接运行大规模 Agent 团队。

使用前注意
  • README 没有给出卸载命令,本页不推测卸载方式。
  • Workflow 需要用户明确同意,生成配置也应在写入前核对冲突和覆盖范围。
  • 多 Agent 测试可能消耗数万到数十万令牌,先从两到三个角色的小流程开始。
04

使用场景

SCENARIO 01

实现与审查分离

为开发任务建立生成与验证角色,让实现者产出改动,审查者按独立标准检查,再由编排器汇总。

SCENARIO 02

批量研究与汇总

把预先列出的资料分给多个 Agent 处理,并用结构化返回值或文件把结果交给汇总阶段。

SCENARIO 03

长期专家协作

为需要多轮反馈的架构或内容任务建立有名字的 Agent,让它们通过消息和共享任务保持上下文。

SCENARIO 04

旧版 Harness 迁移

检查 v1 配置中的 TeamCreate、TeamDelete 和实验标记,再按 v2 的三种执行方式重新连接 Agent 与 Skill。

05

使用评价

这项判断来自 README、Quickstart、两个 Skill、迁移文档和 CHANGELOG,没有把文档审阅写成亲自使用。Harness v2 的长处在于把团队设计、Skill 编写、编排、测试和后续迭代放进同一套项目文件中,规则也明确要求先检查重复角色和旧配置。它的成本同样直观。生成过程会接触项目级配置,多 Agent 运行会增加令牌消耗,最终效果还取决于宿主模型、工具权限和维护者是否认真审查生成内容。

值得一试的地方

  • 安装入口简短,插件清单、核心 Skill、迁移说明和更新记录都可公开核验
  • 执行方式和团队模式有具体选择标准,生成物路径与验证清单清楚
  • evolve Skill 给出了从运行反馈到逐项修改和回归检查的完整路径

使用前要知道

  • 功能只在仓库文档层面核验,没有完成安装或端到端测试
  • 生成内容会改动项目配置,采用者需要自己处理覆盖、权限和版本控制
  • 作者的 v1 小样本对比不能证明 v2 在不同代码库中稳定提升质量
06

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 →