ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Claude Code 扩展点:子 Agent

Claude Code 扩展点:子 Agent 内置子 Agent 类型仅供参考Explore / Plan / general-purpose / code-reviewer 等superpowers 插件自带code-reviewer等 agent 定义。1. 子 Agent 是什么子 AgentSubagent CC 主会话派出去的分身用独立上下文处理子任务。核心价值并行 隔离。维度主会话Claude子 Agent上下文共享主对话独立不互相污染执行串行处理可并行同时跑多个定位统筹全局干一件具体的活干完汇报类比主会话是项目经理子 Agent 是干活的专员——各自带各自的资料互不干扰干完交结果。2. 工作原理2.1 调度方式通过Agent 工具派发主会话 → Agent(description..., prompt..., subagent_typeExplore) │ └─► 子 Agent 以独立上下文执行 → 返回结果默认后台运行2.1.198 起子 Agent 跑的时候主会话可以继续干别的跑完通知可嵌套2.1.172 起子 Agent 还能再派子 Agent最多 5 层Agent Teams 简化2.1.178 起每个会话隐式有一个 team用name参数给子 Agent 命名之后用 SendMessage 继续对话2.2 返回结果子 Agent 的最终消息返回给主会话不直接展示给用户。主会话负责汇总、转述、把关。所以给子 Agent 的 prompt 要明确返回什么格式的结果如列出所有调用点而非帮我看看。3. 内置子 Agent 类型类型定位用途Explore只读搜索跨文件/目录找结论只回结论不吐文件Plan架构规划设计实施方案、识别关键文件、权衡取舍general-purpose通用多步复杂任务、搜索执行claude-code-guide官方问答问 CC / SDK / API 的功能与用法code-reviewersuperpowers代码审查按计划与规范审查已完成实现每个类型有独立的工具权限配置在 agent 定义文件的 frontmatter 里指定。Explore 只能读不能写就是靠这个保证的。4. 典型场景4.1 并行调研一个任务评估 A、B、C 三个库可以让三个 Explore 子 Agent 并行各查一个同时回来汇总对比。比串行快 3 倍。4.2 代码审查实现完成后派code-reviewer子 Agent 对照计划审查见配置与插件主题里的 superpowers 工作流。审查在一个独立上下文里进行不会污染主会话的实现视角更容易发现盲点。4.3 大任务拆分迁移整个模块这类大活主会话规划成 N 个独立子任务并行派 N 个子 Agent 分头实现每层独立上下文互不干扰最后主会话合并验收。2.1.198 起后台子 Agent 还能自动 commit / push / 开 draft PR。4.4 Dynamic Workflows高阶Opus 4.8 配套的 dynamic workflows一个会话内规划后跑数百个并行子 Agent验证输出后汇报。适合代码库级迁移、大规模重构。5. 如何自定义子 Agent5.1 存储位置位置路径生效范围全局~/.claude/agents/名字.md所有项目项目级项目/.claude/agents/名字.md该项目5.2 定义文件结构--- name: agent名 description: 何时用这个 agent、擅长什么。主会话据此判断派谁 tools: Read, Edit, Write, Bash, Grep # 允许的工具白名单 model: sonnet # 可选指定模型 --- system prompt 正文这个 agent 的行为准则、技能、返回格式要求5.3 示例--- name: log-analyzer description: 分析日志文件找异常。当需要从大日志里定位错误/性能问题时使用。 tools: Read, Grep, Bash --- # Log Analyzer 你负责分析日志。规则 1. 用 grep 先定位 ERROR/WARN 关键字不要整篇 Read 大文件 2. 找到异常后给出时间戳、日志级别、关联上下文 3. 按时间线 根因格式返回不要贴原始日志5.4 最佳实践description 决定派发写清楚什么时候用 擅长什么主会话才能正确选择工具白名单收窄只给需要的能力不给多余权限安全 聚焦prompt 明确返回格式子 Agent 的结果是数据不是聊天要求结构化任务要独立子 Agent 之间不要共享可变状态否则并行会打架并行派发多个独立子 Agent 用一条消息多个 Agent 调用并发执行6. 与其它扩展点的关系子 Agent 内部也能用 skill / MCP子 Agent 继承主会话的工具与 MCP 能力SubagentStart / SubagentStop hook子 Agent 启动/结束时触发见扩展点 Hooks 主题superpowers 的 subagent-driven-development把子 Agent 开发固化成工作流 skill执行独立任务和 Dynamic Workflows 的区别Agent 工具是手动派 1~N 个Workflow 是脚本化编排确定性的多 Agent 流水线后者需要显式启用
返回列表