CodeWhale子代理教程用agent工具委托后台任务【免费下载链接】CodewhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodewhaleCodeWhale 是一款用 Rust 编写的开源终端编码智能体coding agent。它的子代理Sub-agent机制允许主代理通过内置的agent工具把探索、审查、验证等后台任务委托给多个小鲸鱼并行处理——你只需说一句自然语言就能让多个子代理同时开工父代理负责最终决策与汇总。本教程面向新手带你从零看懂并上手 CodeWhale 子代理。 什么是 CodeWhale 子代理可以把它想象成一个主编程师带团队干活的模式父代理Parent理解你的真实需求做架构、安全与验收决策最后向用户汇报子代理Sub-agent领到一份聚焦的任务简报在后台独立运行自己的模型回合、调用工具、产出证据完成后把结果交回父代理。关键特性一览特性说明单个委托用agent工具启动一次聚焦任务多项编排用workflow工具编排有依赖关系的多阶段工作权限收敛子代理权限永远不超过父代理只读父代理不能变出写权限可恢复中断/超时会保留检查点可用followup继续持久记录worker 记录保存在.codewhale/state/subagents.v1.json完整的机制说明见官方文档docs/SUBAGENTS.md英文版和 docs/zh_hans/SUBAGENTS.md简体中文版。 30 秒上手一句话委托后台任务你不需要记任何命令。在 CodeWhale 会话里直接用自然语言提出委托需求即可例如派一个 explore 子代理只读地帮我找出Foo的每个调用点给我文件:行号证据。父代理会自动调用agent工具、选择合适的角色、启动后台 worker并在你继续对话时并行等待其完成。想手动查看各角色的实际路由配置可以在会话里输入/config subagents status。 小贴士一次可以委托多个相互独立的子代理比如同时开 2-3 个 explore 去摸不同模块它们会并行执行。 8 个内置角色按需挑选岗位agent工具的type字段决定子代理的工作姿态。每个角色不只是标签而是对写不写文件、能不能跑 shell的明确约定角色姿态可写典型用途general灵活听父代理安排✅默认角色多步任务explore只读快速摸清代码❌找到Foo的每个调用点planner分析并产出策略❌设计迁移方案不要执行reviewer带严重度评分的评审❌审计这个 PR 的 bugimplement最小改动落地变更✅把bar.rs重写为做 Xtest跑测试/验证并报告❌运行测试并报告 PASS/FAILadvisor高推理密度咨询❌这个设计我们漏掉了什么custom显式窄工具白名单继承在父代理姿态上精选工具何时选哪个简单口诀任务是把整件事做完 →general需要证据再决策 →explore便宜、快适合并行已有变更要打分 →reviewer变更已定稿只需落地 →implement要权威的通过/失败结论 →test各角色的完整系统提示词在 crates/tui/src/tools/subagent/mod.rs 中搜索*_AGENT_INTRO旧的拼写如scout、builder、review仍可作为别名被解析。 写好一份委派简报Delegation Brief子代理干得好不好很大程度取决于父代理交给它的简报。官方推荐的结构化简报包含问题QUESTION、范围SCOPE、已知事实ALREADY_KNOWN、投入档位EFFORT: quick/medium/thorough、停止条件STOP_CONDITION和输出格式OUTPUT。官方内置的delegate技能对什么该自己做、什么该委托给出了黄金法则见 crates/tui/assets/skills/delegate/SKILL.md保留在父代理理解用户真实需求、架构/安全/发布风险决策、跨模块集成、最终验收委托给子代理有界的只读探索、边界清晰的机械改动、聚焦的测试/lint 运行、样板代码生成不要委托一两步就完的小事、模糊的产品决策、没有验收标准的危险操作、最终验证。弱提示 vs 强提示的对比弱提示强提示修一下配置的 bug。只负责settings.rs及其测试保留现有配置键名加一个回归测试证明 provider API key 变更不会重启 onboarding返回改动路径和测试输出。⚡ 并发、深度与预算后台任务有多猛子代理默认火力很足但全部有界可控控制项默认值硬上限说明并发子代理数64128[subagents].max_concurrent可调队列容量1024—运行中 排队中的总量上限嵌套深度38子代理可以再生子代理但代际受限单步 API 超时600 秒3600 秒超时自动退避重试最多 5 次心跳超时约 5 分钟3600 秒停止输出进度的卡死子代理会被自动取消常用调节项都写在~/.codewhale/config.toml的[subagents]段里并发、token_budget、max_steps、wall_time_secs等常量定义在 crates/tui/src/config/subagent_limits.rs。进阶玩法还包括Worktree 隔离给子代理加worktree: trueCodeWhale 会为它创建独立的 git worktree 和分支默认codex/agent-name-id位于.codewhale-worktrees/多个子代理并行改代码互不干扰父仓库保持干净上下文分叉fork_context: true让子代理继承父代理当前的对话前缀与 To-do 快照适合接着上文继续做的任务独立探索则建议用全新会话按角色配模型[subagents.roles.role]可为不同角色固定不同的 provider/模型比如让reviewer用大模型、explore用便宜快速的模型。 怎么检查进度、结果和失败子代理的生命周期是Pending → Running → Completed / Failed / Cancelled / Interrupted / BudgetExhausted。查看名单agent(actionstatus)返回当前会话所有子代理的状态页深度、耗时、token 用量、最近活动追问/续跑followup可唤醒运行中的子代理或从可继续的检查点恢复被中断的任务交付文件在委托时声明deliverables完成后会自动核对文件是否存在、非空、在作用域内给出present / missing / empty / out_of_scope等判定输出契约非 explore 子代理的汇报固定以五个小节收尾——SUMMARY做了什么、EVIDENCE文件:行号证据、CHANGES改了哪些文件、RISKS风险、BLOCKERS卡点explore 角色只交SUMMARYEVIDENCE。⚠️ 注意子代理的汇报本质是自报。父代理或你在依赖其结论前应复核关键EVIDENCE引用和verification.status必要时本地再跑一次测试。❓ 新手常见问题Q1子代理会拿到比父代理更多的权限吗不会。权限是求交集的子代理的有效写/网/ shell 权限永远是父代理当前姿态的上限之内拒绝列表还会向上合并角色名或标志都变不出新权限。Q2父代理回完一句话后台子代理会被杀掉吗不会。健康的子代理在父代理正常响应后继续运行完成通知通过同一个 Engine 收件箱返回还可以唤醒父代理进入下一回合显式中断/取消始终有效。Q3任务必须扛过进程重启、休眠或远程执行怎么办会话内委托的agent适合短期工作需要持久化的长跑任务优先使用 Fleet 或 Workflow 支撑的 fleet 运行见 docs/FLEET.md 与 docs/WORKFLOW_AUTHORING.md。Q4子代理的记忆是隔离的吗子代理保留各自的私有 To-do 列表互不可读当记忆功能开启时[memory] enabled true它们可以通过remember工具向父代理共享的记忆存储追加持久备注。 延伸阅读官方子代理文档英文docs/SUBAGENTS.md官方子代理文档简体中文docs/zh_hans/SUBAGENTS.md内置 delegate 委托技能crates/tui/assets/skills/delegate/SKILL.md子代理运行时源码crates/tui/src/tools/subagent/mod.rs并发/准入限制配置crates/tui/src/config/subagent_limits.rs一句话总结在 CodeWhale 中把要证据的活儿交给子代理把做决策的活儿留在父代理。用一句话委托、用角色定姿态、用简报划边界你就能在终端里跑起一支并行工作的 AI 工程小队。【免费下载链接】CodewhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/Codewhale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
