建议收藏，用到时照着做。做完你能得到一个只读代码的“审查员”子代理，主对话不被撑爆，还不会乱改文件。 这是通义千问 Qwen Code 官方文档 Subag… · @swordBluesy · TwKit

@swordBluesy

建议收藏，用到时照着做。做完你能得到一个只读代码的“审查员”子代理，主对话不被撑爆，还不会乱改文件。 这是通义千问 Qwen Code 官方文档 Subagents 一页，页面标注最后更新 2026 年 10 月 22 日。先说结论：官方建议一个子代理只干一件事，描述要写成“什么时候该用我”，工具要用 tools 白名单锁住。 官方列的好处有七个：任务专门化、上下文隔离、可复用、受控权限、进度可见，以及 fork 子代理能继承上下文并共享缓存。 先说清词。 子代理（Subagent），是在 Qwen Code 里专门干一类活的小助手，有自己的提示词、工具和对话记录，不占用你主对话的篇幅。 fork（分叉），是子代理的一种，继承主对话的全部上下文，在后台跑，适合并行调研。 白名单（allowlist），是 tools 字段里只列允许用的工具，没列的一律不能用。 先把话说全： 官方说命名子代理从零开始，看不到主对话历史；fork 才继承历史。 顶层的普通子代理默认在后台运行，结果靠完成通知送回；需要当场等结果时设 run_in_background: false。 fork 共享父对话的工作目录，没有 worktree 隔离，几个 fork 同时改文件可能冲突。 官方页面没写能同时开几个子代理，以官方文档为准。 一、第一步：用向导建第一个子代理 在 Qwen Code 里输入 /agents create，按向导走。官方还有 /agents manage，用来查看和管理已有的子代理。 二、第二步：知道文件放哪 子代理就是带 YAML 头的 Markdown 文件。项目级放 .qwen/agents/，优先级最高；用户级放 ~/.qwen/agents/，是备用；扩展也可以自带子代理。 三、第三步：写文件头 官方基本结构有这些字段：name 名字，description 什么时候用，model 选模型，approvalMode 审批模式，tools 白名单，disallowedTools 黑名单。头后面的正文就是它的系统提示词。 四、第四步：选模型 model 写 inherit 或不写，就用主对话的模型；写 fast，用你配置的 fastModel；写模型名如 glm-5，或写 provider:模型名 如 openai:gpt-4o，就换成指定模型。官方提醒，换了提供商，这个子代理的请求和数据就发给那家，要确认合适。 五、第五步：选审批模式 default 每次要你批准；plan 只分析不改动；auto-edit 自动批准工具，官方说推荐大多数子代理用；yolo 全自动含破坏性操作；bubble 把后台审批弹回父会话。不写的话，父会话是 yolo 或 auto-edit 就继承，是 plan 就保持 plan，是 default 且文件夹受信任则给 auto-edit。 六、第六步：锁工具 tools 是白名单，不写就继承全部；disallowedTools 是黑名单，想要“除了某几个都行”时用。两个都写，先白名单再黑名单。MCP 工具规则相同，黑名单支持 mcp__服务器名 整个屏蔽。 七、第七步：直接复制一个只读审查员 文件头写：name 填 cautious-reviewer，description 填 Reviews code for security vulnerabilities, performance issues, and maintainability concerns，approvalMode 填 plan，tools 只列 read_file、grep_search、glob。正文写：You are a code reviewer. Analyze the code and report findings. Do not modify any files. 完整可复制的文件在赠品里。 八、第八步：怎么叫它干活 官方说两种：自动委派，直接说“给认证模块写完整测试”，主 AI 会交给匹配的测试专家；或者明说，让某个子代理去做。想分叉就明确 subagent_type: "fork"，省略这个字段不会分叉。fork 还能用 fork_turns 只带最近几轮，用 fork_tools 限制工具。 九、第九步：官方最佳实践 单一职责：testing-expert 好，general-helper 什么都干不好。专业要具体：react-performance-optimizer 比 frontend-developer 好。描述要可执行：写“审查安全漏洞、性能和可维护性”，别写“一个有用的审查员”。提示词要写具体专长、分步做法和输出标准。 十、安全 官方提醒：子代理继承父会话的权限模式；plan 会话不能通过子代理升级成 auto-edit；不受信任的文件夹里 auto-edit 和 yolo 被拦截；别把密钥写进子代理配置；生产和开发环境最好分开建。 常见坑 3 条 一，描述写得太宽，主 AI 不知道什么时候该叫它。二，fork 同时改同一个文件会冲突，让它们只读调研。三，换了 provider 的模型，代码会发给那一家，先想清楚。 收藏版：5 步速查 一，输入 /agents create 建一个 二，描述写成“什么时候用” 三，tools 白名单只给读文件 四，approvalMode 先用 plan 五，一个子代理只干一件事 参考：通义千问 Qwen Code 官方文档 Subagents（S1哥 整理） S1哥观点 这篇文档最值得看的，是官方自己写了一对反例：general-helper 和 frontend-developer 都被标成“避免”。大多数人建子代理的第一反应，恰恰就是这两种。 真正的信号是权限默认向上继承，只有 plan 锁得住。给弱者设计的流程，强者穿上就是紧身衣，但对子代理，紧一点是保护。 就像请装修队，你要给每个工种发不同的门禁卡。评论区说一下，你的第一个子代理打算干什么？你卡在第几步？同系列前几篇在我主页。

曝光 127 · 评论 5 · 点赞 0 · 书签 0