Harness Agent类型选型指南general-purpose、Explore、Plan与自定义怎么选新手完整版【免费下载链接】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 的「Agent 团队工厂」你只需描述一个项目领域它就会自动为你搭建一支分工协作的 Agent 团队agent team和它们各自使用的技能。团队搭好后新手最常卡住的一个问题是给每个 Agent 调用时到底该选哪种 Agent 类型这篇文章基于 Harness 内置的选型标准带你一次讲透general-purpose、Explore、Plan三种内置类型和自定义 Agent 类型的用法并附一张可直接照抄的选型决策表。一分钟看懂什么是 Agent 类型在 Claude Code 中每个 Agent 都由 Agent 工具发起其工种由subagent_type参数决定。类型分为两大类内置类型general-purpose、Explore、Plan开箱即用自定义类型通过.claude/agents/{name}.md文件自己定义可访问全部工具Harness 的选型哲学只有一句话Agent 需要的权限越少越好——只读探索就别给写权限防止误改文件需要动工具的全能角色才用自定义类型并把角色写进文件以便跨会话复用。三种内置 Agent 类型对照表这是 Harness 官方给出的速查表原文见 agent-design-patterns.md类型工具权限适合场景general-purpose全部工具含 WebSearch、WebFetch网络调研、通用任务Explore只读无 Edit/Write代码库探索、分析Plan只读无 Edit/Write架构设计、计划制定general-purpose全能型瑞士军刀 它拥有全部工具权限包括联网搜索WebSearch / WebFetch是三者中能力上限最高的类型。推荐场景需要上网收集资料的调研类任务竞品分析、资料搜集角色复杂、横跨多种操作类型的大杂烩工作需要执行验证脚本的 QA 检查这一点新手最容易忽略见后文避坑第 1 条使用建议如果只是简单的信息收集甚至不需要创建 Agent 定义文件——直接在调用时写一段详细的提示词即可。Explore只读的代码探索专家 Explore的核心特征就两个字只读。它没有 Edit 和 Write 权限物理上无法修改你的文件。推荐场景接手陌生代码库快速摸清技术栈、数据模型、主要模块代码分析、Code Review 这类只看不改的工作需要安全隔离的探索阶段——你完全不用担心它顺手改坏什么东西为什么值得单独用它让看代码的 Agent 天然失去改代码的能力是最省心的安全边界。Plan只读的架构设计规划师 Plan同样是只读类型但定位与Explore不同它不追求看得广而是专注于分析与设计。推荐场景大型重构前的方案设计与影响面评估团队架构设计、任务拆解与排期任何先出蓝图、后动代码的规划环节Explore 与 Plan 怎么选一个口诀摸清现状用 Explore规划未来用 Plan。两者都是只读但提示词重心完全不同——前者要广而全后者要深而准。如何创建自定义 Agent 类型内置类型解决通用工种自定义类型解决专职工种。当你的 Agent 需要文件修改权限或高度专业化时就轮到自定义类型出场了。创建方式在项目下创建.claude/agents/{name}.md文件定义完成后即可用subagent_type: {name}调用自定义 Agent 拥有全部工具权限。Harness 的强制原则是所有 Agent 都必须有定义文件内置类型也不例外。用general-purpose时subagent_type指定为general-purpose但仍要生成一个定义文件把角色、工作原则、团队通信协议写进去。原因是定义落盘后下个会话才能直接复用团队协作模式下通信协议必须显式声明才能保证协作质量Harness 的核心价值就是Agent谁来做与Skill怎么做的分离一个最小可用的结构参考agent-design-patterns.md--- name: agent-name description: 一句话角色描述 触发关键词 --- # 角色一句话定位 ## 核心角色 ## 工作原则 ## 输入/输出协议Agent 类型选型5 种情况快速决策表不确定怎么选时直接对照这张表源自 agent-design-patterns.md 选型标准你的情况推荐类型原因角色复杂、要跨多个会话复用自定义类型人格与原则落文件长期可维护简单调研/信息收集一段提示词就够general-purpose省一个定义文件提示词直接写要求只读代码分析/ReviewExplore从权限上杜绝误改文件只做设计与规划Plan专注分析防止顺手改代码需要修改文件的实现类工作自定义类型全工具权限 专业化指令⚠️ 新手三大高频坑坑 1用Explore做需要执行脚本的 QA 检查Explore是只读的无法运行验证脚本。Harness 明确规定QA 类 Agent 必须使用general-purpose类型且重点是接口交叉比对同时读 API 响应和前端代码对比形状在每个模块完成后增量式执行而不是等全部完成才验一次。详见 qa-agent-guide.md。坑 2只把角色写在提示词里不落定义文件这样 Agent 只能活在一次调用里下个会话就失忆了。Harness 明确禁止这种做法所有 Agent含内置类型都必须生成.claude/agents/{name}.md。坑 3调用时漏掉模型参数Harness 要求所有 Agent 调用都显式指定model: opus参数——团队产出质量直接取决于 Agent 的推理能力这是写死在编排规范里的。快速上手5 分钟跑通 Harness安装很简单克隆仓库后把技能目录复制到全局技能路径即可git clone https://gitcode.com/GitHub_Trending/harness/harness cp -r skills/harness ~/.claude/skills/harness完整步骤含 Agent Teams 实验开关请看官方 5 分钟速通文档docs/quickstart.md。之后一句build a harness for a fintech risk-assessment team就能让 Harness 按本文的选型标准为你的领域生成整套 Agent 团队。延伸阅读 类型选型与六大团队架构模式原文skills/harness/references/agent-design-patterns.md五个真实团队配置实例含各 Agent 的 subagent_type 用法skills/harness/references/team-examples.mdHarness 主技能完整工作流Phase 0–7skills/harness/SKILL.md团队编排模板内含 Agent 类型分配表skills/harness/references/orchestrator-template.md总结一张图记住选型逻辑需求首选类型要联网、要动手、要跑脚本general-purpose只看代码、绝不修改Explore只出方案、不碰代码Plan要改文件 长期复用 专业化自定义类型.claude/agents/记住 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），仅供参考