--- title: "NEXUS Handoff Templates" type: source tags: [] date: 2026-05-01 --- ## Source File - [[Agent/agency-agents/strategy/coordination/handoff-templates.md]] ## Summary(用中文描述) - 核心主题:NEXUS 多 Agent 协作框架的标准化交接模板体系——7 种场景化模板覆盖从任务分配、QA 通过/失败、升级、阶段门控、冲刺边界到事故响应的全链路交接 - 问题域:多 Agent 协作中的上下文丢失(交接边界 73% 失败率)和 QA 反馈循环缺失问题 - 方法/机制:7 个标准化 Markdown 模板 + 场景选择指南表格,每个模板包含 metadata/verdict/evidence/next-action 结构化字段 - 结论/价值:一致性交接防止上下文丢失——多 Agent 协调失败的头号原因;与 NEXUS 质量门控([[QualityGate]])体系深度集成;是 NEXUS 战略框架三大交付物之一 ## Key Claims(用中文描述) - 标准化交接防止上下文丢失——多 Agent 协调失败的头号原因 - QA Feedback Loop 强制执行最多 3 次重试,超出则触发 Escalation Report 升级至 [[AgentsOrchestrator]] - Phase Gate Handoff 为每个阶段转换建立门控标准和文档交接机制 - Sprint Handoff 覆盖冲刺边界的所有完成状态、质量指标、待办项和回顾洞察 - Incident Handoff 确保事故响应跨团队协作的可追溯性和上下文连续性 - 7 个模板通过 Usage Guide 表格映射到具体场景,确保 Agent 始终使用正确模板 ## Key Quotes > "Consistent handoffs prevent context loss — the #1 cause of multi-agent coordination failure." — NEXUS Handoff Templates 文档引言 ## Key Concepts - [[Handoff-Boundary]]:交接边界——Agent 之间的上下文传递节点,NEXUS 发现 73% 的失败发生在此处,本文档通过 7 个标准化模板对此进行针对性解决 - [[QualityGate]]:质量门控——本文档中 QA PASS/FAIL 模板是 QualityGate 在验收环节的具体执行机制;Phase Gate Handoff 则是阶段间的 QualityGate 实现 - [[Agent-Handoff]]:Agent 交接——Agent-to-Agent 工作转移的标准格式,通过 Standard Handoff Template (#1) 实现结构化上下文传递 - [[Dev-QA-Loop]]:开发↔QA 循环——QA PASS/FAIL 模板定义了该循环的标准状态转移(PASS → 推进 / FAIL → 最多重试 3 次 → Escalation) - [[Evidence-Over-Claims]]:证据优于主张——QA PASS 模板要求提供多分辨率截图、功能验证清单、品牌一致性/无障碍/性能数据作为决策依据 - [[Sprint-Handoff]]:冲刺交接——Sprint 边界的知识传递模板,覆盖完成状态、质量指标、待办项和回顾洞察 - [[Incident-Response]]:事故响应——Incident Handoff 模板为 P0-P3 事故建立标准化响应和交接流程 ## Key Entities - [[NEXUS]]:The Agency 多 Agent 编排框架,handoff-templates.md 为其三大战略交付物之一(与 Master Strategy/Phase Playbooks 并列) - [[AgentsOrchestrator]]:代理编排器——Escalation Report 的最终升级目标;Phase Gate Handoff 中的 Gate Keeper 决策者 - [[EvidenceQA]]:证据收集者——QA PASS/FAIL 模板中的 QA Agent 角色之一,负责多分辨率截图和功能验证 ## Connections - [[executive-brief]] ← documents_in_detail ← [[handoff-templates]] - [[quickstart]] ← is_simplified_guide ← [[handoff-templates]] - [[nexus-strategy]] ← is_part_of ← [[NEXUS]] - [[handoff-templates]] ← enables ← [[Dev-QA-Loop]] - [[handoff-templates]] ← implements ← [[QualityGate]] - [[handoff-templates]] ← supports ← [[Sprint-Handoff]] - [[handoff-templates]] ← supports ← [[Incident-Response]] ## Contradictions - 与 [[workflow-with-memory]] 的记忆机制对比: - 冲突点:handoff-templates 依赖结构化文档传递上下文,而 [[workflow-with-memory]] 依赖 MCP 持久记忆服务 - 当前观点:标准化交接模板提供显式、可审计的上下文传递路径,适合跨平台协作 - 对方观点:MCP 记忆服务自动化上下文召回,减少手动文档工作,适合长期项目 - 协调方案:两者互补——handoff-templates 定义"交接什么",memory 系统定义"如何持久化",建议在 Phase 3 Build 开始引入 memory 机制