Blog

# 三行速读 外部能力（MCP）接入后，控制面仍必须统一。 插件负责发现，server 负责提供能力，tool 负责执行动作。 native 与 mcp 工具走同一路由与权限门，系统才可控。 # 先修知识 已完成 s07 权限管道与 s02 工具路由理解。 对进程通信和 “工具名标准化” 有基本概念。 # 读完后你应该能做到（可检验清单） 接入一个 MCP server 并完成一次工具调用。 解释 mcp__{server}__{tool} 前缀的两重作用。 验证外部工具没有绕过统一权限决策。 #...

# 三行速读 任务回答 “做什么”，worktree 回答 “在哪做”。 并行协作要靠目录隔离车道，不能只靠口头分工。 enter/closeout 生命周期记录决定后续可维护性。 # 先修知识 已理解 s17 的并行自治推进背景。 熟悉 Git worktree 基础概念。 # 读完后你应该能做到（可检验清单） 为不同任务分配独立 worktree 并并行推进。 解释 closeout 记录为什么是治理关键。 通过事件日志定位一次车道异常。 # 本篇要解决什么 并行任务一多，最常见冲突是 “同一目录互相覆盖改动”。s18 的核心是把任务目标和执行车道分离： task 管...

# 三行速读 自治不是 “放飞”，而是 “按规则自动认领与续跑”。 空闲轮询、角色过滤、认领日志是自治三件套。 可观测与可刹车能力决定自治是否可上线。 # 先修知识 已理解 s16 的协议与状态治理。 已掌握 s12 任务图与 owner 概念。 # 读完后你应该能做到（可检验清单） 让队友自动认领符合角色的任务。 通过 claim 事件回放一次认领链路。 设计一个自治暂停 / 恢复开关流程。 # 本篇要解决什么 s15、s16 的团队依然偏 “被动分派”。s17 让队友可以在空闲时自己找活、自己认领、自己续跑。 核心目标：自治推进，但仍受规则约束。 #...

# 三行速读 团队有消息还不够，关键动作需要协议化。 request_id 让请求与响应可关联、可追踪、可审计。 这章把协作从 “能沟通” 提升到 “可治理”。 # 先修知识 已理解 s15 的队友与 inbox 模型。 知道状态机基本概念（pending/approved/rejected 等）。 # 读完后你应该能做到（可检验清单） 创建并完成一次带 request_id 的审批流程。 解释协议请求与普通消息的本质差别。 设计一个可验证的状态迁移规则。 # 本篇要解决什么 s15 有了团队消息流，但高风险动作（关机、审批）不能只靠普通消息。s16 要解决的是...

# 三行速读 这章把 “一次性子任务” 升级为 “持久队友协作”。 队友有身份、状态、收件箱，可反复接活。 多 Agent 的第一步不是复杂框架，而是可追踪消息流。 # 先修知识 已理解 s04 的委派思想。 已掌握 s12/s13 的任务与运行时基础。 # 读完后你应该能做到（可检验清单） 启动两个队友并完成一次消息协作。 解释 inbox drain 语义对一致性的作用。 追踪一个队友从 idle 到 working 再回 idle 的完整过程。 # 本篇要解决什么 s04 的 subagent 是一次性委派，适合临时任务。s15 引入长期队友，让协作从 “临时分包” 升级到...

# 三行速读 这章让 “时间” 成为工作触发入口。 调度器只负责触发，执行仍回到统一主循环。 durable + lock + 过期策略是调度稳定性的三件套。 # 先修知识 已理解 s13 的后台执行与通知回流。 了解 cron 表达式基础语法。 # 读完后你应该能做到（可检验清单） 创建一个可触发且可清理的 cron 任务。 解释 session-only 与 durable 调度的差别。 说明为何需要锁来避免重复触发。 # 本篇要解决什么 s13 让任务能后台运行，但触发入口仍偏 “被动”—— 通常要等用户当前轮输入。s14...

# 三行速读 这章把慢任务从主循环剥离到后台执行槽位。 后台任务结果通过通知队列回流，主 loop 不被阻塞。 任务目标（s12）与运行槽位（s13）是两层不同状态。 # 先修知识 已理解 s12 的持久任务图。 熟悉线程 / 异步基础概念（至少知道 “后台执行” 含义）。 # 读完后你应该能做到（可检验清单） 区分 task record 与 runtime slot 的职责。 把慢命令改造成后台执行并回流结果。 排查一条 stalled 任务并解释其成因。 # 本篇要解决什么 s12 解决 “任务目标持久化”，s13 解决...

# 三行速读 这章把工作目标从会话内 todo 升级成持久任务图。 关键是依赖关系：谁阻塞谁、谁解锁谁。 任务状态能跨会话延续，是后续运行时与团队协作基础。 # 先修知识 已理解 s03 todo 的会话内边界。 知道 JSON 持久化与状态同步基本逻辑。 # 读完后你应该能做到（可检验清单） 创建并维护一个有依赖关系的任务链。 解释 completed 与 deleted 的语义差异。 在重启后验证任务图完整恢复。 # 本篇要解决什么 s03 的 todo 只适合会话内计划。s12 要解决的是跨会话、跨阶段的工作协调：任务需要持久化，并且要有依赖关系。 核心变化：从 “临时清单”...

# 三行速读 高完成率系统的关键差异在 “失败后是否能继续”。 恢复策略必须按失败类型分层，而不是统一重试。 退出条件同样属于恢复设计的一部分。 # 先修知识 已理解 s06 压缩策略（恢复会复用 compact）。 知道网络失败、超长输入、输出截断是不同问题。 # 读完后你应该能做到（可检验清单） 为三类失败匹配正确恢复动作。 解释 backoff + jitter 为什么比固定重试更稳。 在日志中复盘一次 “失败 -> 恢复 -> 继续” 链路。 # 本篇要解决什么 一个能落地的 Agent，不能只会在顺风局工作。s11...

# 三行速读 system prompt 应该是分段装配管道，不是超长静态字符串。 静态段与动态段分离，才能兼顾稳定性与时效性。 输入工程做得好，后续扩展（技能、记忆、协议）都更顺滑。 # 先修知识 已读 s05、s09，理解技能与记忆都可能注入输入面。 知道 “模型看到的是拼装结果，不是你脑中的逻辑图”。 # 读完后你应该能做到（可检验清单） 画出本项目 prompt 分段装配顺序。 解释为什么 dynamic 信息不该混进 static core。 独立改一个 prompt section 且不影响其他 section。 # 本篇要解决什么 很多新手把 system...