GSD三大内置子代理揭秘Scout侦察、Researcher研究、Worker执行的上下文工程之道【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址: https://gitcode.com/gh_mirrors/gs/gsd-2GSDspec-driven development 系统内置了三款开箱即用的子代理——Scout 侦察、Researcher 研究、Worker 执行。它们各自拥有独立的上下文窗口与精简工具集是 GSD 让 AI 智能体长时间自主工作而不迷路的上下文工程核心。本文面向新手用通俗语言带你读懂这三位专职员工的分工之道。为什么需要子代理上下文工程的第一课想象一位工程师同时负责翻遍整个代码库、上网查最新资料、动手写代码。他很快会大脑过载——对话越长AI 的上下文窗口越满注意力被无关信息稀释产出质量随之下降。GSD 的答案是分而治之主会话父代理不亲自干活而是把有边界的工作委派给子代理。每个子代理独立上下文窗口——只装载完成任务必需的信息精简工具集——Scout 只能读和搜Worker 才有完整能力结构化回报——最终答案、用量数据、可复查的运行记录交回父会话。子代理的运行状态会被持久化到本地 JSON 记录即使中途中断也能status查看、resume续接详见官方文档 subagents.md。上图是 GSD 在 VS Code 中的实际工作画面右侧 Chat 面板里GSD Agent 正以结构化表格汇报项目进度——这正是子代理协作成果的最后一公里。三位子代理的简历一览子代理定位工具权限典型任务Scout快速代码库侦察read、grep、find、ls、bash只读为主找出与任务相关的文件与关键代码Researcher网络信息研究员联网搜索、bash、记忆查询搜索并综合最新资料附来源引用Worker全能执行者全部工具在隔离上下文中完成实现类任务它们都定义在项目的 agents 目录下scout.md、researcher.md、worker.md。用/subagent命令可随时列出当前会话可用的所有代理。Scout 侦察代理给下一个代理压缩过的地图Scout 的系统提示一句话点题你的输出将交给一个从未看过这些文件的代理scout.md。这正是最精髓的上下文工程思维——侦察成果必须自包含、可压缩、可直接交接三档侦察深度Quick只查关键文件、Medium顺藤摸瓜看关键片段、Thorough追全部依赖并核对测试固定输出结构## Files Retrieved精确到行号的文件清单→## Key Code关键类型与函数→## Architecture组件如何连接→## Start Here从哪个文件入手为什么。为什么强调行号与Start Here因为下一个代理拿到这份地图后无需重复全库扫描直接跳到要害位置——上下文从整个代码库压缩为一份带坐标的简报。Researcher 研究代理只讲有出处的信息当项目涉及外部知识最新 API、框架新版本、行业最佳实践时Researcher 上场。它的策略在 researcher.md 中写得非常克制用 2–3 个精准查询获取广度综合成连贯的摘要每条关键结论都附来源 URL。输出严格遵循## Summary2–3 句概览→## Key Findings带来源的要点→## Sources编号来源列表。它还有一条铁律Be factual. Do not speculate beyond what the sources say.只陈述来源所支持的事实冲突信息要如实标注。这种事实锚定让研究报告可以放心地进入下游规划上下文而不污染后续推理。Worker 执行代理全能但绝不越权Worker 是三者中唯一拥有完整工具能力的子代理在隔离的上下文窗口里自主完成实现、测试、修复等实际编码工作。它的设计亮点是明确的权力边界见 worker.md❌ 不得擅自启动子代理或扮演编排者❌ 若任务看起来像 GSD 编排、侦察或并行派发应立即停止并上报提示父级改用专职代理✅ 完成后按## Completed/## Files Changed/## Notes结构汇报交接时附上精确文件路径与触碰的关键函数。一句话Worker 是执行者而非指挥官。这种能力全开 职权收紧的组合让主会话的编排上下文永远干净不被执行细节淹没。链式协作Scout → Researcher → Worker 的上下文流水线GSD 的subagent工具支持三种调用形态单发single、并行parallel最多 8 个任务、链式chain。链式模式用{previous}占位符把上一步输出注入下一步任务天然构成一条上下文流水线{ chain: [ { agent: scout, task: Map the checkout flow. }, { agent: researcher, task: Research current best practices for {previous} }, { agent: worker, task: Implement the plan based on: {previous} } ] }三个上下文模式细节值得新手留意subagents.md参数作用context: fresh默认子代理从零开始只带自身提示词与任务——上下文最干净context: fork从父会话分叉继承完整对话状态——适用于需要先前决策的任务isolated: true在 git worktree 隔离区执行改动以补丁形式合并回主检出在 GSD 的 auto 模式自动驾驶中这条流水线被自动化了规划阶段被策略锁定为只读侦察类代理scout、planner、researcher 等实现类工作则留给 Worker 单元执行——读写分离由运行时策略硬性保证而非仅靠提示词约束auto-mode.md。上下文工程之道三条可复用的经验GSD 三位子代理的分工浓缩了三条对任何 AI 工作流都成立的上下文工程经验上下文最小化——每个代理只拿完成任务必需的上下文fresh 为默认侦察结果压缩成带行号的简报是交接的黄金范式工具权限与角色对齐——Scout 无写权限所以绝不越权Worker 权限全开但被禁止再派发能力边界即行为边界结构化输出即接口——每个代理都遵循固定输出格式让下游代理能免解析地消费上游成果。快速上手三步走第一步启动 GSD 会话输入/subagent查看可用代理清单确认 scout、researcher、worker 均在列第二步从最简单的单发任务练手例如让 Scout 侦察登录流程涉及哪些文件观察其四段式输出第三步尝试 chain 模式把 Scout 的产出接力给 Worker 执行小改动体会{previous}如何串联上下文。更多细节可查阅官方文档 subagents.md 与 auto-mode.md子代理工具实现位于 extensions/subagent/。核心心法AI 自主工作的瓶颈不是模型能力而是上下文管理。Scout 负责少而准地读Researcher 负责有出处地查Worker 负责隔离而专注地写——三位一体让主会话始终握有全局而不陷于细节。【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址: https://gitcode.com/gh_mirrors/gs/gsd-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
