4.2 KiB
4.2 KiB
title, type, tags, date
| title | type | tags | date |
|---|---|---|---|
| NEXUS Handoff Templates | source | 2026-05-01 |
Source File
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 机制