MiniCode多智能体编排：3个只读子Agent并行干活，Root Agent把住所有代码-北京尧图网络

【免费下载链接】MiniCodeA lightweight terminal coding assistant with Claude Code-like workflow, tool loop, and TUI architecture, built for learning and experimentation. Multi-language support: TypeScript , Python and Rust implementations available now.项目地址https://gitcode.com/gh_mirrors/mi/MiniCode点击查看免费下载MiniCode 是一个轻量级终端编码助手内置一套可直接观察的多智能体multi-agent编排机制Root Agent 作为唯一写代码的角色最多同时派 3 个只读子 Agent 并行调研。本文带你读懂它的分工、并行上限与安全边界适合想入门 AI 编程 Agent 的同学。一句话看懂 MiniCode 的多智能体设计把整个流程想象成一次分头侦查Root Agent主脑接收你的需求拆解任务负责所有真正的代码修改与命令执行。只读子 Agent侦查员并行处理互相独立的调研任务只读文件、检索信息产出报告绝不改代码。这种独立上下文受限工具集后台 Promise 生命周期控制的组合是理解 MiniCode 多智能体架构的四个核心概念完整描述见 ARCHITECTURE_ZH.md 的Multi-agent MVP一节。关键约束同时最多 3 个running子 Agent超过就会报错拦截。3 个子 Agent 如何并行干活MiniCode 在 src/agents/types.ts 里用两个常量钉死了边界export const MAX_SUB_AGENTS 3 export const MAX_SUB_AGENT_STEPS 20MAX_SUB_AGENTS 3并发上限保证资源可控。MAX_SUB_AGENT_STEPS 20每个子 Agent 最多执行 20 个工具/模型步骤防止无限空转。当 Root Agent 调用spawn_agent时SubAgentManager 会先检查runningCount是否已到达上限一旦超过立即抛出错误并终止At most ${this.maxConcurrent} sub-agents may run at the same time每个被拉起的子 Agent 都拥有独立的消息数组与 Root Agent 上下文完全隔离独立的AbortController可随时取消正在进行的模型请求后台 Promise不阻塞主回合主 TUI 仍保持单前台交互节奏这套生命周期管理集中在 src/agents/manager.ts 的SubAgentManager类中spawn / wait / close / closeAll四个方法覆盖了创建、等待、关闭的完整闭环。Root Agent 如何把住所有代码这是整套设计里最妙的一笔——只读保障是硬编码的而非靠提示词自觉。第一道锁工具白名单在 src/tools/index.ts 中子 Agent 能拿到的工具被显式限制为 6 个只读工具export const SUB_AGENT_TOOL_NAMES [ list_files, grep_files, read_file, load_skill, web_fetch, web_search, ]注意没有write_file、edit_file、patch_file、run_command。子 Agent 物理上就拿不到写文件与执行命令的能力。第二道锁系统提示词兜底buildSubAgentPrompt 生成的系统提示词进一步在语义层面强化角色You are a read-only sub-agent helping the root coding agent.You cannot modify files, run commands, ask the user questions, or create other agents.Do not claim to have changed code. The root agent is the only agent allowed to make edits.同时Root Agent 自身的系统提示词在 src/prompt.ts 里被明确告知You are the root agent and the only agent allowed to edit files or run commands that change the project. 双端约定边界清晰。Root Agent 手里的 4 个编排工具Root Agent 通过 src/tools/sub-agents.ts 暴露的 4 个工具来调度子 Agent形成一个完整控制回路工具作用典型场景spawn_agent拉起一个只读子 Agent 处理独立调研任务分头查找不同模块list_agents列出所有子 Agent 及当前状态巡检进度wait_agent等待指定子 Agent 结束并回收报告汇总结果close_agent关闭某个运行中的子 Agent发现它空转/不再需要wait_agent默认等待 30 秒超时则返回最新状态而不关闭 Agent最大可设到 120 秒。close_agent会取消正在进行的模型请求并阻止子 Agent 进入下一步骤避免继续消耗模型调用。一个典型的并行编排时序spawn_agent(任务A) → agent_1 running spawn_agent(任务B) → agent_2 running spawn_agent(任务C) → agent_3 running wait_agent([1,2,3]) → 收集三份报告 close_agent(剩余) → 收尾确保无遗留 worker在终端里看到子 Agent 在跑子 Agent 运行时MiniCode 的 TUI 底栏会显示醒目的状态提示实现位于 src/tty-app.ts 的renderSubAgentFooter●SUB-AGENTS 2/3 RUNNING一眼就能知道当前有几个 worker 在后台干活、距离 3 个并发上限还剩多少余量无需打断主回合。这套设计值得学什么MiniCode 故意把多智能体实现成一个可读的最小闭环非常适合用来学习上下文隔离每个 worker 独立消息数组互不污染工具隔离白名单硬编码只读能力不依赖提示词自觉⏱️生命周期控制AbortController可随时取消进行中的模型请求并发与步数上限MAX_SUB_AGENTS 3、MAX_SUB_AGENT_STEPS 20双重兜底相关源码路径供延伸阅读生命周期管理src/agents/manager.ts常量与状态类型src/agents/types.ts只读 worker 提示词src/agents/worker-prompt.ts4 个编排工具src/tools/sub-agents.ts只读工具白名单src/tools/index.tsRoot Agent 协调规则src/prompt.ts架构总览Multi-agent MVPARCHITECTURE_ZH.md当前 MVP 暂不持久化 worker、不允许嵌套 Agent、不读取自定义 agent 定义这样能把教学重点完整聚焦在上述四个核心概念上。小结MiniCode 用1 个能写的 Root Agent 最多 3 个只读子 Agent的极简组合把多智能体编排讲得又轻又透——并行调研交给后台 worker写代码的权柄始终牢牢握在 Root Agent 手里。赞分享【免费下载链接】MiniCodeA lightweight terminal coding assistant with Claude Code-like workflow, tool loop, and TUI architecture, built for learning and experimentation. Multi-language support: TypeScript , Python and Rust implementations available now.项目地址https://gitcode.com/gh_mirrors/mi/MiniCode点击查看免费下载相关推荐Hope Agent多Agent协作完全指南子Agent、Agent Team与后台任务并行干活Hope Agent多Agent协作完全指南子Agent、Agent Team与后台任务并行干活希望帮你把复杂的活并行摊开Hope Agent 是开源的跨agent-orchestrator Agent-Owned Model Catalogs把模型目录的所有权交还给每个编码 Agentagent orchestrator Agent Owned Model Catalogs把模型目录的所有权交还给每个编码 Agent 本篇技术指南围绕 agpi_agent_rust 子智能体编排指南用 subagent 构建并行多 Agent 工作流的 7 个实用技巧pi_agent_rust 子智能体编排指南用 subagent 构建并行多 Agent 工作流的 7 个实用技巧 pi_agent_rust 是一个用 Ru人工智能大模型AI Agent代码智能体CLI开发工具工具调用MCP Clients创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

MiniCode多智能体编排：3个只读子Agent并行干活，Root Agent把住所有代码

相关推荐

零售企业做AI，不是先上模型，而是先让数据能支撑决策

从信息聚合到热度感知：buzz 工具的开发实践与算法细节

7ZIP源码集成实战：LZMA压缩率调优与避坑指南

更多资讯

SAP固定资产减值与增值配置实操指南

【粉丝福利社】神券福利，实测有效，附攻略

Linux系统篇--重定向与文件操作命令

故障原因竟然这么简单——(维修实例NO.13,14，说明书的重要性）

USB矢量网络分析仪VNA2：1MHz到6GHz宽频段设计、校准与TDR实践

期刊AI率合格线是多少？知网和维普AIGC检测该怎么选？

今日更新

防关联浏览器哪个好？三款产品实测差异解析

2026钢铁行业AI转型系统选型对比：多基地排产、大宗原燃料采购与质量追溯，六家厂商能力差异在哪里

影刀RPA深度实战：大模型Fine-tuning定制RPA专用Prompt与指令生成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？