Files
zclaw_openfang/skills/.playbooks/README.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

114 lines
4.9 KiB
Markdown

# 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*