Harness快速开始5步详解从一句话提示词到完整Agent团队【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harnessHarness 是一款面向 Claude Code 的「团队架构工厂」插件Meta-Skill只需一句描述领域的提示词它就能自动为你生成一支由多个专业 Agent 组成的协作团队以及配套的技能文件。本文带你用5 步、约 5 分钟完成 Harness 快速开始从零搭建出你的第一个 Agent 团队。准备工作3 个前提条件开始之前请确认✅ 已安装Claude Code v2.x 或更高版本用claude --version检查Agent Teams 功能在 2.0 才引入✅ 使用 bash / zsh / fish 等能持久化环境变量export的终端✅ 当前目录是你的项目根目录 完整流程见官方文档docs/quickstart.md5 步全部走完后你将得到一个包含 3~5 个领域专家的.claude/agents/目录。5 步快速开始流程总览步骤做什么预计耗时第 1 步添加 plugin marketplace60 秒第 2 步安装插件 开启 Agent Teams 实验开关40 秒第 3 步用一句话提示词生成 Harness2 分钟第 4 步验证生成的 Agent 与技能文件30 秒第 5 步用真实任务跑通 Agent 团队90 秒第 1 步添加 marketplace60 秒claude plugin marketplace add revfactory/harness这一步把harness插件市场注册到 Claude Code让系统发现 revfactory 发布的插件。执行成功会看到Added marketplace: revfactory/harness的提示。第 2 步安装插件并开启实验开关40 秒claude plugin install harnessharness export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1第二条命令是关键开启Agent Teams 实验特性。Harness 内部依赖TeamCreate、SendMessage、TaskCreate三个实验 API 来组建和调度多 Agent 团队没有这个开关生成的团队会静默退化为单 Agent 执行流水线、监督者等协作模式都会失效。想要永久生效可把export一行追加到~/.zshrc或~/.bashrc。为什么必须依赖这个实验开关项目有一份专门文档讲清楚了背景与未来路线图docs/experimental-dependency.md⚠️ 如果执行第 3 步后发现「团队没组建起来」先回到这一步检查 Claude Code 版本是否 ≥ 2.0。第 3 步一句话提示词生成 Harness2 分钟现在输入 Harness 最核心的用法——一句话描述你的领域claude build a harness for a fintech risk-assessment team这句话会触发 skills/harness/SKILL.md 中定义的元技能它内部按 6 个阶段工作领域分析 → 团队架构设计 → 生成 Agent 定义 → 生成技能文件 → 编排整合 → 验证测试。你只需等待流式输出几分钟后它会把 3~5 个 Agent 的.md定义文件和配套技能写入.claude/agents/与.claude/skills/。✨可以换成任何领域例如build a harness for an e-commerce fraud-detection workflow电商风控design an agent team for deep research with cross-validation深度研究build a harness for full-stack website development全栈网站开发第 4 步验证生成的 Agent 与技能文件30 秒ls -la .claude/agents/ ls -la .claude/skills/以金融风控为例你应看到类似risk-analyst.md、compliance-reviewer.md、portfolio-monitor.md的命名文件。生成的目录结构长这样your-project/ ├── .claude/ │ ├── agents/ # Agent 定义文件谁来做 │ │ ├── analyst.md │ │ └── qa.md │ └── skills/ # 技能文件怎么做 │ ├── analyze/SKILL.md │ └── build/SKILL.mdHarness 的核心设计是把「谁来做Agent」和「怎么做Skill」彻底分离。如果想了解 6 种团队架构模式Pipeline 流水线、Fan-out/Fan-in 扇出扇入、专家池、生成-审核、监督者、层级委托的设计原理推荐阅读skills/harness/references/agent-design-patterns.md⚠️ 若目录为空运行claude plugin list确认harnessharness已安装已安装但无效则执行claude plugin enable harnessharness后重试第 3 步。第 5 步用真实任务跑通你的 Agent 团队90 秒最后把一个真实工单扔给新团队例如「某中型制造企业申请 500 万美元营运资金融资请产出风险评审(1) 信用历史红旗项 (2) 行业集中度 (3) 监管暴露。输出一页纸的 go/no-go 建议备忘录。」Claude Code 会自动检测到新 Agent把任务路由进 Harness 生成的协作模式风控类任务通常是「生成-审核」或「专家池」模式最终返回一份结构化备忘录——这就是完整 Agent 团队协作的效果。常见问题速查症状原因解决办法团队没组建 / 只有一个 Agent 响应新开了终端实验开关丢失在当前 shell 重新export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1什么文件都没生成插件未安装或未激活claude plugin list检查必要时重跑第 2 步API 调用次数暴涨多 Agent 团队单任务可并发 5 次调用单次只跑一个任务避免链式调用多个 Harness下一步从 5 分钟到深度定制完成快速开始后推荐按这个顺序深入看实例— 浏览 5 个真实团队配置示例skills/harness/references/team-examples.md学编排— 理解团队/子 Agent/混合三种执行模式与数据传递协议skills/harness/references/orchestrator-template.md写技能— 掌握技能编写与渐进式信息暴露Progressive Disclosureskills/harness/references/skill-writing-guide.md做测试— 学习 with-skill vs without-skill 对比测试方法论skills/harness/references/skill-testing-guide.md 记住一点Harness 生成的团队不是静态产物而是会随你的反馈持续进化的系统。跑几次任务、提点改进意见你的 Agent 团队会越来越懂你的业务。【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考