57 lines
4.2 KiB
Markdown
57 lines
4.2 KiB
Markdown
---
|
||
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 机制
|