# 📋 ZClaw Agent 协作交接模板

> 标准化的 Agent 间交接格式，确保上下文不丢失。

---

## 1. 标准任务交接

用于任何 Agent 间的工作转移。

```markdown
# ZClaw 任务交接

## 元数据
| 字段 | 值 |
|------|-----|
| **From** | [Agent 名称] ([类别]) |
| **To** | [Agent 名称] ([类别]) |
| **任务 ID** | [任务标识] |
| **优先级** | [Critical / High / Medium / Low] |
| **时间戳** | [YYYY-MM-DD HH:MM] |

## 上下文
**项目**: [项目名称]
**当前状态**: [已完成的工作]
**相关文件**:
- [文件路径 1] — [内容说明]
- [文件路径 2] — [内容说明]

## 交付请求
**需求**: [具体、可衡量的交付物描述]
**验收标准**:
- [ ] [标准 1]
- [ ] [标准 2]
- [ ] [标准 3]

## 质量期望
**必须通过**: [质量标准]
**证据要求**: [完成证明]
**交接给**: [下游 Agent 和格式要求]
```

---

## 2. QA 验证通过

```markdown
# QA 验证: PASS ✅

## 任务
| 字段 | 值 |
|------|-----|
| **任务 ID** | [ID] |
| **开发者** | [Agent 名称] |
| **QA Agent** | [Agent 名称] |
| **尝试次数** | [N]/3 |

## 验证结果: PASS

## 证据
**截图**:
- 桌面端 (1920x1080): [文件路径]
- 平板端 (768x1024): [文件路径]
- 移动端 (375x667): [文件路径]

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

## 下一步
→ Agents Orchestrator: 标记任务完成，进入下一任务
```

---

## 3. QA 验证失败

```markdown
# QA 验证: FAIL ❌

## 任务
| 字段 | 值 |
|------|-----|
| **任务 ID** | [ID] |
| **开发者** | [Agent 名称] |
| **QA Agent** | [Agent 名称] |
| **尝试次数** | [N]/3 |

## 验证结果: FAIL

## 发现的问题

### 问题 1: [类别] — [严重程度]
**描述**: [问题描述]
**期望**: [应该发生什么]
**实际**: [实际发生什么]
**修复指示**: [具体的修复步骤]
**文件**: [需要修改的文件路径]

## 验收标准状态
- [x] [标准 1] — 通过
- [ ] [标准 2] — 失败 (见问题 1)
- [ ] [标准 3] — 未测试 (依赖标准 2)

## 重试指示
**给开发者**:
1. 只修复上述列出的问题
2. 不要添加新功能
3. 修复完成后重新提交
4. 这是第 [N]/3 次尝试

**如果第 3 次失败**: 任务将升级到 Agents Orchestrator
```

---

## 4. 升级报告

用于任务超过 3 次重试。

```markdown
# 🚨 升级报告

## 任务
| 字段 | 值 |
|------|-----|
| **任务 ID** | [ID] |
| **开发者** | [Agent 名称] |
| **QA Agent** | [Agent 名称] |
| **尝试次数** | 3/3 已用尽 |
| **升级给** | [Agents Orchestrator / Project Manager] |

## 失败历史

### 尝试 1
- **发现问题**: [摘要]
- **应用修复**: [修改内容]
- **结果**: FAIL — [原因]

### 尝试 2
- **发现问题**: [摘要]
- **应用修复**: [修改内容]
- **结果**: FAIL — [原因]

### 尝试 3
- **发现问题**: [摘要]
- **应用修复**: [修改内容]
- **结果**: FAIL — [原因]

## 根因分析
**持续失败原因**: [分析]
**系统性问题**: [是否为模式性问题]
**复杂度评估**: [任务是否合理划分]

## 建议解决方案
- [ ] **重新分配** 给其他开发者 ([推荐 Agent])
- [ ] **拆分** 为更小的子任务
- [ ] **修改方案** 需要架构/设计变更
- [ ] **接受** 当前状态并记录限制
- [ ] **推迟** 到下一个迭代

## 影响评估
**阻塞**: [被阻塞的其他任务]
**时间影响**: [对整体进度的影响]
```

---

## 5. 阶段性交接

用于项目阶段转换。

```markdown
# 阶段性交接

## 转换
| 字段 | 值 |
|------|-----|
| **From Phase** | Phase [N] — [名称] |
| **To Phase** | Phase [N+1] — [名称] |
| **Gate Result** | [PASSED / FAILED] |

## 阶段门禁结果
| # | 标准 | 阈值 | 结果 | 证据 |
|---|------|------|------|------|
| 1 | [标准] | [阈值] | ✅/❌ | [证据] |
| 2 | [标准] | [阈值] | ✅/❌ | [证据] |

## 携带文档
1. [文档名称] — [用途]
2. [文档名称] — [用途]

## 下一阶段 Agent 激活
| Agent | 角色 | 优先级 |
|-------|------|--------|
| [Agent 1] | [角色] | [立即 / Day 2 / 按需] |
| [Agent 2] | [角色] | [立即 / Day 2 / 按需] |
```

---

## 使用指南

| 场景 | 使用模板 |
|------|----------|
| 分配工作给其他 Agent | 标准任务交接 (#1) |
| QA 通过任务 | QA PASS (#2) |
| QA 拒绝任务 | QA FAIL (#3) |
| 任务超过 3 次重试 | 升级报告 (#4) |
| 阶段转换 | 阶段性交接 (#5) |