Skip to content

handoff-templates.md

Latest commit

 

History

History
357 lines (278 loc) · 9.52 KB

handoff-templates.md

File metadata and controls

357 lines (278 loc) · 9.52 KB
Raw

NEXUS 交接模板

NEXUS 流水线中所有智能体之间交接的标准化模板。交接规范做好了，就不会丢上下文——这是多智能体协作失败的头号原因。

1. 标准交接模板

用于任何智能体之间的工作转交。

# NEXUS 交接文档

## 元数据
| 字段 | 值 |
|------|-----|
| **发送方** | [智能体名称]（[部门]） |
| **接收方** | [智能体名称]（[部门]） |
| **阶段** | 第 [N] 阶段 — [阶段名称] |
| **任务引用** | [Sprint 排序师待办列表中的任务 ID] |
| **优先级** | [紧急 / 高 / 中 / 低] |
| **时间戳** | [YYYY-MM-DDTHH:MM:SSZ] |

## 上下文
**项目**：[项目名称]
**当前状态**：[到目前为止做了什么——要具体]
**相关文件**：
- [文件/路径/1] — [内容说明]
- [文件/路径/2] — [内容说明]
**依赖**：[这项工作依赖什么已完成的部分]
**约束**：[技术、时间线或资源约束]

## 交付要求
**需要什么**：[具体的、可衡量的交付物描述]
**验收标准**：
- [ ] [标准 1 — 可衡量]
- [ ] [标准 2 — 可衡量]
- [ ] [标准 3 — 可衡量]
**参考材料**：[需求、设计、之前工作的链接]

## 质量预期
**必须通过**：[该交付物的具体质量标准]
**需要的证据**：[完成证明长什么样]
**下一个接收方**：[谁接收产出，需要什么格式]

2. QA 反馈循环 — 通过

当证据收集者或其他 QA 智能体通过一个任务时使用。

# NEXUS QA 判定：通过

## 任务
| 字段 | 值 |
|------|-----|
| **任务 ID** | [ID] |
| **任务描述** | [描述] |
| **开发智能体** | [智能体名称] |
| **QA 智能体** | [智能体名称] |
| **第几次** | 第 [N] 次，共 3 次 |
| **时间戳** | [YYYY-MM-DDTHH:MM:SSZ] |

## 判定：通过

## 证据
**截图**：
- 桌面端（1920x1080）：[文件名/路径]
- 平板（768x1024）：[文件名/路径]
- 手机（375x667）：[文件名/路径]

**功能验证**：
- [x] [验收标准 1] — 已验证
- [x] [验收标准 2] — 已验证
- [x] [验收标准 3] — 已验证

**品牌一致性**：已验证 — 颜色、字体、间距符合设计系统
**无障碍**：已验证 — 键盘导航、对比度、语义化 HTML
**性能**：[实测加载时间] — 在可接受范围内

## 备注
[任何观察、后续可改进的小建议、或值得表扬的地方]

## 下一步行动
→ 智能体编排者：标记任务完成，进入待办列表中的下一个任务

3. QA 反馈循环 — 不通过

当证据收集者或其他 QA 智能体打回一个任务时使用。

# NEXUS QA 判定：不通过

## 任务
| 字段 | 值 |
|------|-----|
| **任务 ID** | [ID] |
| **任务描述** | [描述] |
| **开发智能体** | [智能体名称] |
| **QA 智能体** | [智能体名称] |
| **第几次** | 第 [N] 次，共 3 次 |
| **时间戳** | [YYYY-MM-DDTHH:MM:SSZ] |

## 判定：不通过

## 发现的问题

### 问题 1：[分类] — [严重度：紧急/高/中/低]
**描述**：[问题的准确描述]
**预期**：[按验收标准应该是什么样]
**实际**：[实际是什么样]
**证据**：[截图文件名或测试输出]
**修复指引**：[具体的、可执行的修复说明]
**需要改的文件**：[准确的文件路径]

### 问题 2：[分类] — [严重度]
**描述**：[...]
**预期**：[...]
**实际**：[...]
**证据**：[...]
**修复指引**：[...]
**需要改的文件**：[...]

[所有发现的问题都列出来]

## 验收标准状态
- [x] [标准 1] — 通过
- [ ] [标准 2] — 不通过（见问题 1）
- [ ] [标准 3] — 不通过（见问题 2）

## 重试说明
**给开发智能体**：
1. 只修上面列出的问题
2. 不要加新功能或做其他改动
3. 所有问题修完后重新提交 QA
4. 当前是第 [N] 次，最多 3 次

**如果第 3 次还不通过**：任务将升级给智能体编排者

4. 升级报告

当一个任务超过 3 次重试时使用。

# NEXUS 升级报告

## 任务
| 字段 | 值 |
|------|-----|
| **任务 ID** | [ID] |
| **任务描述** | [描述] |
| **开发智能体** | [智能体名称] |
| **QA 智能体** | [智能体名称] |
| **重试已用完** | 3/3 |
| **升级给** | [智能体编排者 / 工作室制片人] |
| **时间戳** | [YYYY-MM-DDTHH:MM:SSZ] |

## 失败历史

### 第 1 次
- **发现的问题**：[摘要]
- **做了什么修复**：[开发者改了什么]
- **结果**：不通过 — [为什么还是没过]

### 第 2 次
- **发现的问题**：[摘要]
- **做了什么修复**：[开发者改了什么]
- **结果**：不通过 — [为什么还是没过]

### 第 3 次
- **发现的问题**：[摘要]
- **做了什么修复**：[开发者改了什么]
- **结果**：不通过 — [为什么还是没过]

## 根因分析
**为什么任务一直过不了**：[对底层问题的分析]
**系统性问题**：[这是偶发还是有规律？]
**复杂度评估**：[任务本身的范围定义是否合理？]

## 建议处理方式
- [ ] **重新分配**给别的开发智能体（[建议的智能体]）
- [ ] **拆分**成更小的子任务（[建议的拆分方案]）
- [ ] **换思路**——架构/设计需要调整
- [ ] **接受**当前状态，记录已知限制
- [ ] **推迟**到后面的 Sprint

## 影响评估
**阻塞**：[什么其他任务被这个堵住了]
**时间线影响**：[对整体排期的影响]
**质量影响**：[如果接受当前状态，有什么质量上的妥协]

## 需要决策
**决策者**：[智能体编排者 / 工作室制片人]
**截止时间**：[什么时候需要做决定才不会进一步延误]

5. 阶段门禁交接

在 NEXUS 阶段转换时使用。

# NEXUS 阶段门禁交接

## 转换
| 字段 | 值 |
|------|-----|
| **来源阶段** | 第 [N] 阶段 — [名称] |
| **目标阶段** | 第 [N+1] 阶段 — [名称] |
| **门禁守门人** | [智能体名称] |
| **门禁结果** | [通过 / 不通过] |
| **时间戳** | [YYYY-MM-DDTHH:MM:SSZ] |

## 门禁标准结果
| # | 标准 | 阈值 | 结果 | 证据 |
|---|------|------|------|------|
| 1 | [标准] | [阈值] | 通过 / 不通过 | [证据引用] |
| 2 | [标准] | [阈值] | 通过 / 不通过 | [证据引用] |
| 3 | [标准] | [阈值] | 通过 / 不通过 | [证据引用] |

## 带入下一阶段的文档
1. [文档名称] — [下一阶段用途]
2. [文档名称] — [下一阶段用途]
3. [文档名称] — [下一阶段用途]

## 下一阶段的关键约束
- [本阶段发现的约束 1]
- [本阶段发现的约束 2]

## 下一阶段智能体激活
| 智能体 | 角色 | 优先级 |
|--------|------|--------|
| [智能体 1] | [下一阶段的角色] | [立即 / 第 2 天 / 按需] |
| [智能体 2] | [下一阶段的角色] | [立即 / 第 2 天 / 按需] |

## 带入的风险
| 风险 | 严重度 | 缓解措施 | 负责人 |
|------|--------|---------|--------|
| [风险] | [P0-P3] | [缓解方案] | [智能体] |

6. Sprint 交接

在 Sprint 边界使用。

# NEXUS Sprint 交接

## Sprint 总结
| 字段 | 值 |
|------|-----|
| **Sprint** | [编号] |
| **持续时间** | [开始日期] → [结束日期] |
| **Sprint 目标** | [目标描述] |
| **速度** | [计划] / [实际] 故事点 |

## 完成状态
| 任务 ID | 描述 | 状态 | QA 次数 | 备注 |
|---------|------|------|---------|------|
| [ID] | [描述] | 完成 | [N] | [备注] |
| [ID] | [描述] | 完成 | [N] | [备注] |
| [ID] | [描述] | 顺延 | [N] | [原因] |

## 质量指标
- **首次通过率**：[X]%
- **平均重试次数**：[N]
- **完成任务数**：[X/Y]
- **交付故事点**：[N]

## 顺延到下一个 Sprint
| 任务 ID | 描述 | 原因 | 优先级 |
|---------|------|------|--------|
| [ID] | [描述] | [为什么没完成] | [RICE 分数] |

## 回顾洞察
**做得好的**：[主要成功点]
**可以改进的**：[主要改进点]
**行动项**：[下个 Sprint 的具体改变]

## 下一个 Sprint 预览
**Sprint 目标**：[拟定目标]
**重点任务**：[最高优先级的事项]
**依赖**：[跨团队的依赖]

7. 事故交接

在事故响应期间使用。

# NEXUS 事故交接

## 事故
| 字段 | 值 |
|------|-----|
| **严重度** | [P0 / P1 / P2 / P3] |
| **发现者** | [智能体或系统] |
| **发现时间** | [时间戳] |
| **负责人** | [智能体名称] |
| **状态** | [排查中 / 止血中 / 已解决 / 事后复盘] |

## 描述
**发生了什么**：[对事故的清楚描述]
**影响范围**：[谁/什么受影响，影响多严重]
**时间线**：
- [HH:MM] — [事件]
- [HH:MM] — [事件]
- [HH:MM] — [事件]

## 当前状态
**受影响的系统**：[列表]
**有没有临时方案**：[有/没有——有的话描述一下]
**预计修复时间**：[估计]

## 已采取的措施
1. [做了什么，结果是什么]
2. [做了什么，结果是什么]

## 交接上下文
**给下一位响应人**：
- [试过什么了]
- [还没试什么]
- [怀疑的根因]
- [要查的相关日志/指标]

## 利益相关方通知
**最近一次更新**：[时间戳]
**下次更新时间**：[时间戳]
**通知渠道**：[更新发布在哪]

使用指南

场景 用哪个模板
把工作交给另一个智能体 标准交接（#1）
QA 通过一个任务 QA 通过（#2）
QA 打回一个任务 QA 不通过（#3）
任务超过 3 次重试 升级报告（#4）
阶段之间切换 阶段门禁交接（#5）
Sprint 结束 Sprint 交接（#6）
系统事故 事故交接（#7）