Files
zclaw_openfang/skills/.coordination/handoff-templates.md
iven d64903ba21 feat(skills): complete multi-agent collaboration framework
## Skills Ecosystem (60+ Skills)
- Engineering: 7 skills (ai-engineer, backend-architect, etc.)
- Testing: 8 skills (reality-checker, evidence-collector, etc.)
- Support: 6 skills (support-responder, analytics-reporter, etc.)
- Design: 7 skills (ux-architect, brand-guardian, etc.)
- Product: 3 skills (sprint-prioritizer, trend-researcher, etc.)
- Marketing: 4+ skills (growth-hacker, content-creator, etc.)
- PM: 5 skills (studio-producer, project-shepherd, etc.)
- Spatial: 6 skills (visionos-spatial-engineer, etc.)
- Specialized: 6 skills (agents-orchestrator, etc.)

## Collaboration Framework
- Coordination protocols (handoff-templates, agent-activation)
- 7-phase playbooks (Discovery → Operate)
- Standardized skill template for consistency

## Quality Improvements
- Each skill now includes: Identity, Mission, Workflow, Deliverable Format
- Collaboration triggers define when to invoke other agents
- Success metrics provide measurable quality standards

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:07:31 +08:00

4.5 KiB

📋 ZClaw Agent 协作交接模板

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


1. 标准任务交接

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

# ZClaw 任务交接

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

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

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

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

2. QA 验证通过

# QA 验证: PASS ✅

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

## 验证结果: PASS

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

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

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

3. QA 验证失败

# 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 次重试。

# 🚨 升级报告

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

## 失败历史

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

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

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

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

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

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

5. 阶段性交接

用于项目阶段转换。

# 阶段性交接

## 转换
| 字段 | 值 |
|------|-----|
| **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)