Harness 是什么？Claude Code Agent 团队架构生成器介绍

要是你已经在 Claude Code 里写过 agents 和 skills，就会知道 Harness 干的不是“多写几个配置文件”的活——它是把一整套专家团队的构想，直接变成能落地的目录结构。官方 README 里给它的定位也很直白：Team-Architecture Factory for Claude Code，说白了就是给 Claude Code 做团队架构的生成工厂。

一句话先讲清楚

你给 Harness 一段项目领域的描述，比如跟它说“给这个项目 build a harness”，它就会先分析这个任务需要哪几类专家、这些专家之间怎么配合、哪些固定流程可以沉淀成 skill，最后直接生成 `.claude/agents/` 和 `.claude/skills/` 目录下的对应文件。

所以它跟普通的提示词模板完全不是一回事。提示词模板一般只能改单次对话的输出风格；Harness 更像是给你的项目装了一套能反复用的工作组织逻辑——下次再碰到同类任务，不用你再一遍遍说谁负责调研、谁负责实现、谁来做复核。

它生成的两类东西

它生成的东西主要分两类。第一类是 Agent，也就是角色，管的是身份定位、判断标准和行动边界，比如研究员、实现工程师、审查员、协调者都属于这类。第二类是 Skill，也就是技能，管的是可重复的流程、检查清单、工具使用路径和上下文的展开方式。

很多人容易把这两个概念搞混。其实 Agent 对应的是“谁来做”，Skill 对应的是“怎么做”。Harness 的核心价值就在于能同时搞定这两样，还能直接放到 Claude Code 能识别的对应目录里。

为什么叫团队架构生成器

为啥它要叫“团队架构生成器”呢？因为它不会随便问你“需要几个助手”就完事了。官方 README 里把它的工作流程拆成了 Domain Analysis、Team Architecture Design、Agent Definition Generation、Skill Generation、Integration & Orchestration、Validation & Testing 好几步。说白了就是，它先摸清楚项目是什么性质，再搭对应的团队结构，然后才写配置文件，最后还要验证触发逻辑和执行模式对不对。

这可比你自己手写一个 agent 文件多了一层设计思考：它会判断哪些任务需要多个 agent 来回传信息协作，哪些任务只是单次找专家咨询就行；哪些流程适合走流水线一步步来，哪些更适合并行收集信息再汇总。

适合谁用

它更适合已经把 Claude Code 用到真实项目里的人。比如你长期维护一个代码库，要反复写测试、做安全审查、生成文档、处理发布流程，这类项目慢慢都会形成固定的分工模式，Harness 就能把这种固定分工给结构化沉淀下来。

要是你只是临时想问个问题，直接调一个 subagent 就够了，更轻便。Harness 更适合那种“以后还会不断出现”的复杂工作——先花点时间把团队搭好，后面就能靠这套团队持续处理同类任务。

要注意的边界

这里也要说清楚它的边界：目前官方文档明确说它只针对 Claude Code 环境，而且 Agent Teams 功能需要开实验特性开关。它不是什么通用 AI 平台，也不是能把随便什么工具一键变成“自动公司”的神器。它干的是一件很窄但很明确的事：在 Claude Code 项目里，生成 agents、skills 和对应的编排说明。

搞懂这些，你就明白 Harness 的定位了。它不是帮你把所有开发工作都做完，而是先把“该找哪些专家、怎么协作”这件事设计好，再交给 Claude Code 去落地执行。