子 agent 全部成功而工作流失败:51 次运行记录中的失败分层
51 次真实运行数据拆解多 agent 工作流的失败分层,以及 1 小时+ 长任务如何设计才能避免空耗。
铸于 Rust · 智无所择 · 迁而无痕
轻舟一叶,不扰清波,渡君至远山。以 Rust 铸就,十三兆之躯, 兼容尔之所习——不为炫技,唯愿助君成事。

四阶段执行循环:Receive → Compact → Reason → Act,每轮压缩上下文,500 次循环上限。
冻结系统提示词 + 边界标记机制,把窗口还给新信息,压缩后继续推理不断链。
JavaScript ESM 脚本驱动的多代理编排:并行扇出、流水线、阶段、条件分支、验证关口、模型分层、收敛循环。
/workflows 实时监控执行:三级树展示、journal 日志、断点续跑,观察和调试工作流。
Agent Client Protocol 双传输层实现——AI 编程工具的通用语言,从 LSP 类比到协议分层。
子代理系统实现多智能体协作:Agent 定义、派发流程、Fork 模式与后台执行,并行不打架。
DeepSeek、GLM、Qwen、Anthropic、OpenAI——不绑定任何一家,国产模型也能驱动 20 万行代码库。
fable / opus / sonnet / haiku 四档 Profile 独立配置 provider、模型与费用策略,各司其职。
聊天中途随时切换模型,无需重启。贵的给推理,便宜的给搜索。
冻结系统提示词 + 边界标记,14 个提示词段落稳定复用,最大限度减少浪费的 token。
缓存策略、自动压缩与渐进式信息加载——理解 Peri 如何管理窗口,用对模型、控制上下文。
截图直接粘贴给 Peri(Ctrl+V),让模型看到界面报错、设计稿、图表数据。
Read/Write/Edit、Glob/Grep、Bash、WebFetch/WebSearch、Agent 委派、TodoWrite……每个工具带别名自动解析。
可复用的专项能力模块,Peri 自动加载适合当前任务的 skill——探索、审查、重构、修 Bug 都是一句话。
explorer / coder / verification / web-researcher / plan / general-purpose,各有权限边界与模型策略。
通过 Model Context Protocol 接入外部工具和服务——文件系统、数据库、API 全部打通。
Agent Loop → Hook Middleware → Claude Code Hook 三层管道,28 个生命周期事件驱动自动化。
从完全自动到逐条审批,四种权限模式保护你的代码和系统安全。
Skills、Hooks、MCP、插件原样可用——你现有的配置直接迁移,零改写。
agm install 任何 skill 或 agent。一把锁文件,所有工具互通。
自然语言注册重复任务:每天早上 9 点的日报、每周一的依赖更新。到点自动执行。
声明目标后持续自动推进——命令用法、验收标准、长会话节奏全覆盖,中途走开也没关系。
Peri + Superpowers 插件:结构化规划、工程化执行、自动化验证的完整工作流。
Spec-driven development——先定规格书再写代码,强制 RFC 2119 标准与验收条件。
文件操作:读文件、写文件、精确字符串替换——不依赖行号,因为行号在模型输出时经常不准。
文件搜索:按文件名模式匹配,按文件内容正则搜索,覆盖日常代码探索。
Shell 执行:超时控制、后台运行,跑测试、构建项目、操作 git。
目录操作:列出内容、创建目录、检查路径,支持深度扫描目录树。
网络工具:抓取网页为文本,搜索引擎查信息,支持指定结果数量。
子代理委派:把独立子任务派发给专用 agent 执行,支持后台运行。
交互与任务跟踪:结构化提问、维护多步任务清单。
技能系统:按名加载技能,按描述搜索可用技能。
干净上下文 + 证据要求 + 独立复核——审查纪律打包成 skill,一句话触发。
Ultracode 并行扇出几十个 agent,探索、规划、实现、验证、汇总全自动。
多代理分片扫描整个仓库,模式识别与风险清单一次到位。
同一问题从性能、安全、架构多角度并行分析,交叉验证结论。
51 次真实运行数据拆解多 agent 工作流的失败分层,以及 1 小时+ 长任务如何设计才能避免空耗。
以性能诊断报告、修复 issue 与 7.6GB 运行日志三方印证,归因单 agent 正常、3 个并发时 CPU 占用 50% 的叠加成因与修复过程。
用 DeepSeek 和 GLM-5.2 驱动 20 万行 Rust 代码库的实际体验——好用的地方、翻车的地方、怎么适配。
79K 条真实消息的 token 消耗分析:巨型搜索、冗余 Read、白搜各占多少上下文窗口,以及如何用提示词约束工具输出。
安装一令而就,无需更张;初启之顷,自有人导君配置模型。
curl -fsSL https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.sh | bash观其全章