AI工具 Skill技能库 关于道场
Meta-Flow 上下文交接 Agent协作 工作流管理

Meta-Flow上下文交接:阶段切换时Agent最小必要上下文装配

hyde-zhao/meta-flow |2026-06-20

Meta-Flow元工作流中的上下文交接技能。当host-orchestrator向meta-pm/meta-se/meta-dev/meta-qa等Agent移交控制权时,自动从工作区筛选最小必要上下文,确保交接简洁、不越权、控制token消耗。支持阶段切换、角色切换、并行任务等多种场景。

【适用场景】

- host-orchestrator向meta-pm/meta-se/meta-dev/meta-qa等Agent的控制权移交 - 阶段切换或Story执行中的角色切换 - requirement-clarification/solution-design启用阶段委托直连用户时 - 并行LLD写作出现实现灰区时的broker handoff/queue摘要生成

【操作步骤】

1. 识别目标Agent的职责边界 2. 读取STATE.md.context_budget,定位当前阶段capsule路径和read_profile 3. 优先装配process/context/*-CONTEXT.yaml;若capsule缺失则写入context_policy.full_doc_read_reason 4. 按must_read、read_if_needed、do_not_read_by_default三类选择文件 5. 显式列出不应加载的历史草稿、中间推理、完整transcript 6. 若存在活跃变更单或当前Story,补入对应上下文 7. Codex下默认fork_context=false,只发送本Skill产出的上下文包

【代码模板】

```yaml

输入文件

- process/STATE.md # 当前阶段、Wave、活跃变更 - process/context/*-CONTEXT.yaml # 若当前阶段已生成 - 目标Agent对应阶段的正式对象

输出结构

must_read: - path: process/context/handoff-CONTEXT.yaml reason: 目标Agent完成当前任务必需 read_if_needed: - path: process/STATE.md reason: 确认当前阶段和Wave do_not_read_by_default: - 历史草稿和中间推理文件 - 无关Story/Wave产物 ```

【复盘要点】

- 交接前必须确认Host Orchestrator已完成process route health check - 目标Agent必须明确,输入文档已生成 - 必须检查process/STATE.md.agent_lifecycle.platform_capabilities.subagent_dispatch - CP2/CP3/CP5/CP6/CP7/CP8阶段前后必须存在对应*CONTEXT.yaml - 上下文包必须简洁,避免传递完整会话历史导致token过度消耗

来源:GitHub https://github.com/hyde-zhao/meta-flow