Harness：开源Claude元技能框架，智能编排多Agent标准化AI代码开发

一、Harness是什么

Harness 是一款面向Claude Code环境的开源元技能（Meta-Skill）多智能体编排框架，依托Anthropic Claude Code运行环境深度定制开发，核心定义为：依靠自然语言需求自动完成智能体团队架构设计、专属子智能体角色划分、配套可落地技能（Skill）代码自动生成的工程化开发工具。

传统Claude Code在代码开发时存在无标准化流程、AI自由编写代码缺乏分工校验、代码杂乱无规范、多人协作开发无角色约束等痛点，Harness从元技能层面改造Claude运行逻辑，把单体AI编程拆分为规划Agent、开发Agent、审核Agent、发布Agent等多角色协同模式，落地「Plan→Work→Review→Release」标准化软件工程闭环。项目采用MIT开源协议，无商用授权门槛，个人开发者、小型研发团队均可免费部署使用，项目代码轻量化，无重型依赖，仅依赖Claude Code原生运行环境，无需额外配置容器、数据库等中间件。

二、功能特色

2.1 六大预设智能体协作架构（内置开箱即用）

框架底层预置6套经过工程验证的智能体协作架构，开发者输入业务需求即可一键选用架构自动生成Agent配置：

• 串行流水线架构：规划→编码→代码评审→打包发布线性流转，适配中小型单体项目开发；

• 并行任务拆分架构：多开发Agent同步拆分功能模块并行编码，适合多模块大型前后端项目；

• 专家顾问架构：主开发Agent搭配专项技术专家Agent（数据库专家、安全专家、前端专家），疑难问题定向调用专项智能体；

• 迭代复盘架构：每轮开发结束自动生成复盘Agent，汇总BUG、代码缺陷并优化下一轮开发规范；

• 故障兜底架构：配置应急纠错Agent，代码编译报错、逻辑异常时自动介入修复，中断开发流程自动回滚；

• 自定义混合架构：用户自由组合上述架构规则，按需新增、删减智能体角色，适配非标定制化项目。

2.2 自动目录与配置文件生成

Harness接入项目后，自动在项目根目录生成.claude/专属配置文件夹，目录结构代码示例：

项目根目录
└── .claude
  ├── agents/    # 全部智能体角色配置YAML文件
  └── skills/    # 智能体绑定的可执行技能脚本

• agents目录：每个Agent独立.yaml配置文件，定义角色名称、工作职责、权限范围、输入输出约束；

• skills目录：绑定对应Agent的执行代码，包含接口调用、文件读写、代码编译、单元测试等落地技能。

2.3 自然语言驱动智能体全生命周期配置

无需手动编写YAML配置文件，开发者仅用自然语言描述项目需求（例如：开发一个基于Python的记账后端项目，分为用户模块、账单模块），Harness自动解析需求：

1. 拆分项目职能，新建对应功能智能体；

2. 为每个智能体分配专属技能脚本；

3. 生成架构流转规则，配置智能体之间消息通信逻辑。

2.4 内置代码评审与规范约束能力

框架自带代码校验规则库，开发Agent输出代码后，评审Agent自动执行：代码格式校验、安全漏洞扫描、逻辑合理性检查、单元测试用例生成四项工作，不合规代码直接驳回重写，从源头约束Claude无规范乱写代码的问题。

2.5 轻量化无侵入接入项目

接入项目无需修改原有业务代码，仅在Claude Code环境引入Harness元技能即可生效，支持Python、JS/TS、Go、Java等主流编程语言项目，全平台兼容本地IDE Claude插件、云端Claude Code工作区。

三、技术细节

3.1 底层运行依赖

Harness无第三方SDK、无容器依赖，完全基于Claude Code原生Meta-Skill机制实现，依托Anthropic官方提供的Skill调用协议、Agent上下文隔离API实现智能体调度，核心运行环境仅需满足：

1. Claude Code可用环境（Cursor、Claude Web Code、Claude Desktop插件等）；

2. 本地文件读写权限（用于生成.claude目录配置）。

3.2 配置文件规范

所有智能体配置统一使用YAML格式，单Agent配置示例：

name: BackendDevAgent
role: 后端开发工程师
duty: 负责Python接口编写、数据库CRUD开发
bind_skills:
 - skill/db_operate
 - skill/api_build
review_rule: auto_check_code_safety

• name：智能体唯一标识；

• role：角色定义；

• duty：岗位职责自然语言描述；

• bind_skills：绑定skills目录下对应技能文件名；

• review_rule：绑定内置评审规则。

3.3 智能体上下文隔离技术

Harness通过Claude上下文分片机制实现多Agent环境隔离，不同智能体拥有独立会话窗口，避免角色信息混淆；智能体之间消息交互采用标准化JSON消息体中转，统一通信格式：

{
 "from_agent": "PlanAgent",
 "to_agent": "DevAgent",
 "task_content": "完成用户登录接口开发",
 "task_status": "pending"
}

3.4 规则引擎实现

内置简易规则引擎，使用自然语言转规则解析器，将用户输入的约束（禁止使用原生SQL、必须使用ORM框架）转化为评审规则写入Agent配置，评审阶段规则引擎自动读取配置校验代码。

3.5 项目源码分层结构

harness/
├── core/    # 核心调度引擎，架构选择、Agent创建逻辑
├── parser/   # 自然语言解析模块，需求拆分、角色识别
├── template/  # Agent、Skill配置模板文件
├── rules/    # 内置代码评审规则库
└── entry/    # 项目入口，Meta-Skill注册代码

四、应用场景

1. 个人独立开发者AI编程管控
   独立开发者使用Claude写项目时，利用Harness拆分规划、编码、自测角色，避免AI一次性生成大量混乱无结构代码，规范个人项目目录与编码规范，降低后期维护成本。

2. 小型研发团队协作开发
   小团队依托Harness标准化AI辅助开发流程，统一团队编码规范，不同开发人员共用一套智能体架构，AI生成代码统一经过评审智能体校验，减少团队代码风格杂乱问题。

3. 实训教学场景
   编程培训机构用于AI编程实训，通过固定智能体分工让学员理解软件工程分工逻辑，借助Harness标准化开发流程，规范学员基于AI的编码习惯。

4. 快速原型项目落地
   产品原型、MVP最小产品快速开发，自然语言描述产品需求后，Harness自动拆分开发任务、分配智能体并行开发，大幅缩短原型落地周期。

5. 存量项目迭代维护
   老旧项目迭代时，配置专项维护智能体、安全审计智能体，AI修改存量代码时自动校验兼容性与安全性，避免AI改动引发线上BUG。

五、使用方法

5.1 环境前置准备

确保本地IDE（Cursor、VS Code Claude插件）已经安装并启用Claude Code能力，项目目录具备文件读写权限。

5.2 项目接入部署

1. 克隆开源项目源码到本地：

git clone https://github.com/revfactory/harness.git

2. 将harness目录内核心文件作为Meta-Skill导入当前Claude Code工作空间；

3. 在项目根目录启用Harness元技能，Claude自动初始化框架环境。

5.3 初始化项目智能体架构

在对话窗口输入自然语言指令示例：

启用流水线架构，开发一个基于Node.js的博客后台系统，分为用户、文章、评论三个模块

Harness自动解析指令，在.claude/agents生成规划、后端开发、代码评审、发布四类智能体配置，同步在skills目录生成对应接口开发、单元测试技能脚本。

5.4 发起项目开发任务

继续下发细分开发指令，各智能体自动流转执行，评审Agent完成代码校验后输出最终可用代码；如需调整架构，输入「切换为并行开发架构」即可一键重构全部Agent配置。

5.5 自定义新增智能体

输入自然语言：「新增安全审计Agent，绑定漏洞扫描技能，所有接口代码必须经过该Agent审核」，框架自动生成对应配置文件与技能脚本。

六、竞品对比

选取AutoGPT、Devika、Claude Crew三款主流AI编程智能体框架做参数对比：

总结差异：Harness聚焦Claude生态做轻量化嵌入，主打现有项目AI开发规范化；AutoGPT、Devika偏向独立完整智能体应用，部署重、无法无缝嵌入已有Claude开发环境。

七、常见问题解答

Q1：Harness只能在Claude Code环境使用吗？

A：是的，Harness基于Claude官方Meta-Skill接口开发，原生仅适配搭载Claude Code的客户端（Cursor、VSCode Claude插件、Claude云端工作台），暂不兼容GPT、通义千问等其他大模型代码环境。

Q2：接入Harness会修改项目原有业务代码吗？

A：不会，框架仅在项目根目录新增.claude配置文件夹，不会改动任何原有业务源码，如需卸载直接删除该目录即可恢复原始项目结构。

Q3：自定义智能体技能需要手动编写代码吗？

A：不需要，使用自然语言描述技能功能，Harness自动生成对应技能代码写入skills目录，复杂技能可在自动生成基础上少量微调。

Q4：Harness支持移动端IDE使用吗？

A：目前仅适配PC端搭载Claude Code的编辑器，移动端Claude客户端不开放Meta-Skill挂载接口，暂无法接入框架。

Q5：框架内置评审规则能否自定义扩充？

A：可以，用户在rules目录新增规则配置文件，通过自然语言指令绑定至指定评审Agent，即可拓展个性化代码校验规范。

八、相关链接

• GitHub仓库地址：https://github.com/revfactory/harness

九、总结

Harness作为聚焦Claude Code生态的轻量化开源元技能多智能体框架，精准抓住了AI辅助代码开发缺少流程约束、代码杂乱无分工协作的行业痛点，依托自然语言驱动快速生成多角色智能体与配套执行技能，凭借无侵入接入、零部署成本、多套成熟协作架构的产品优势，既可以帮助个人开发者规范AI编码习惯，又能满足中小型团队标准化AI协同开发需求，依托MIT宽松开源协议进一步降低落地门槛，成为Claude生态内针对性极强的代码工程化辅助工具。