# ZClaw Agent Playbooks

> 分阶段工作手册 - 指导多 Agent 协作的标准化流程

---

## 概述

Playbooks 定义了项目从发现到运营的完整生命周期，每个阶段有明确的目标、活动和交付物。

## 阶段总览

```
┌─────────────────────────────────────────────────────────────────────────┐
│                    ZClaw 项目生命周期                                     │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   Phase 0          Phase 1          Phase 2          Phase 3           │
│   ┌────────┐      ┌────────┐      ┌────────┐      ┌────────┐          │
│   │Discovery│ ──→ │Strategy │ ──→ │Foundation│ ──→ │  Build  │          │
│   │        │      │        │      │         │      │        │          │
│   │ 2-3 天  │      │ 3-5 天  │      │ 3-5 天   │      │ 2-4 周  │          │
│   └────────┘      └────────┘      └─────────┘      └────────┘          │
│                                                                         │
│        ↑                                              │                │
│        │                                              ↓                │
│        │         Phase 6          Phase 5          Phase 4             │
│        │        ┌────────┐      ┌────────┐      ┌────────┐            │
│        └─────── │Operate │ ←─── │ Launch │ ←─── │Harden  │            │
│   持续改进      │        │      │        │      │        │            │
│                 │持续运营 │      │ 1-2 天  │      │ 1 周   │            │
│                 └────────┘      └────────┘      └────────┘            │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

## Playbook 列表

| Phase | 名称 | 文件 | 主要目标 |
|-------|------|------|----------|
| 0 | Discovery | [phase-0-discovery.md](./phase-0-discovery.md) | 理解需求、定义范围 |
| 1 | Strategy | [phase-1-strategy.md](./phase-1-strategy.md) | 架构设计、任务规划 |
| 2 | Foundation | [phase-2-foundation.md](./phase-2-foundation.md) | 项目搭建、基础实现 |
| 3 | Build | [phase-3-build.md](./phase-3-build.md) | 功能开发、Dev↔QA 循环 |
| 4 | Hardening | [phase-4-hardening.md](./phase-4-hardening.md) | 性能优化、安全加固 |
| 5 | Launch | [phase-5-launch.md](./phase-5-launch.md) | 部署发布、上线验证 |
| 6 | Operate | [phase-6-operate.md](./phase-6-operate.md) | 持续运营、监控维护 |

## 核心原则

### 1. 阶段门禁 (Phase Gates)

每个阶段结束前必须通过质量门禁，确保：
- 所有必需的交付物完成
- 质量指标达标
- 文档更新完整

### 2. Dev↔QA 循环

```
Developer 实现 → Reality Checker 验证 → PASS/FAIL 决策
                    ↑                        │
                    └────── FAIL (< 3次) ────┘
                              │
                    FAIL (= 3次) → ESCALATE
```

### 3. 证据驱动

所有质量评估需要可验证的证据：
- 截图证据
- 测试报告
- 性能指标
- 安全扫描结果

### 4. 持续文档

每个阶段结束时更新：
- 项目文档
- API 文档
- 运维手册
- 知识库

## 快速开始

### 启动新项目

1. 阅读 [Phase 0: Discovery](./phase-0-discovery.md)
2. 激活相关 Agents
3. 按阶段执行

### 加入进行中的项目

1. 确定当前阶段
2. 阅读对应 Playbook
3. 检查阶段门禁状态
4. 继续执行

### 处理事件

1. 参考 [Phase 6: Operate](./phase-6-operate.md) 的事件响应流程
2. 按严重程度分级处理
3. 完成事后复盘

## 相关文档

- [协作协议](../.coordination/handoff-templates.md) - Agent 间交接格式
- [激活提示](../.coordination/agent-activation.md) - Agent 激活模板
- [Skill 模板](../.templates/skill-template.md) - Skill 定义格式

---

*ZClaw Multi-Agent Collaboration Framework*