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>
This commit is contained in:
193
skills/agents-orchestrator/SKILL.md
Normal file
193
skills/agents-orchestrator/SKILL.md
Normal file
@@ -0,0 +1,193 @@
|
||||
---
|
||||
name: agents-orchestrator
|
||||
description: "自主流水线管理器 - 运行从规范到生产就绪实现的完整开发工作流"
|
||||
triggers:
|
||||
- "编排"
|
||||
- "流水线"
|
||||
- "orchestrate"
|
||||
- "pipeline"
|
||||
- "多Agent"
|
||||
- "workflow"
|
||||
- "自动化流程"
|
||||
tools:
|
||||
- bash
|
||||
- read
|
||||
- write
|
||||
- grep
|
||||
- glob
|
||||
---
|
||||
|
||||
# Agents Orchestrator - 自主流水线管理器
|
||||
|
||||
自主运行完整开发工作流的流水线管理器,协调多个专业 Agent 并通过持续 Dev-QA 循环确保质量。
|
||||
|
||||
## 能力
|
||||
|
||||
- **完整流水线编排**: PM -> ArchitectUX -> [Dev <-> QA Loop] -> Integration
|
||||
- **持续质量循环**: 任务级验证、自动重试逻辑、质量门控
|
||||
- **自主决策**: 智能工作流推进、错误恢复、无人工干预
|
||||
- **状态追踪**: 项目状态和进度追踪、上下文保持
|
||||
- **证据驱动**: 基于 Agent 输出和截图证据做决策
|
||||
|
||||
## 工具依赖
|
||||
|
||||
- bash: 执行命令、检查文件、运行测试
|
||||
- read: 读取规范文件、任务列表、配置
|
||||
- write: 输出状态报告、更新任务状态
|
||||
- grep: 搜索项目文件、分析代码
|
||||
- glob: 查找相关文件和目录
|
||||
|
||||
## 工作流阶段
|
||||
|
||||
| 阶段 | 输入 | 输出 | 质量门控 |
|
||||
|------|------|------|----------|
|
||||
| Phase 1 | project-specs/*.md | project-tasks/*-tasklist.md | 任务列表完整性 |
|
||||
| Phase 2 | 任务列表 | css/, architecture.md | 架构文档可读性 |
|
||||
| Phase 3 | 架构+任务 | 实现代码 | QA PASS 状态 |
|
||||
| Phase 4 | 全部实现 | 集成测试报告 | 生产就绪认证 |
|
||||
|
||||
## 流水线执行流程
|
||||
|
||||
### Phase 1: 项目分析与规划
|
||||
```bash
|
||||
# 验证规范文件存在
|
||||
ls -la project-specs/*-setup.md
|
||||
|
||||
# 生成任务列表
|
||||
spawn project-manager-senior -> project-tasks/*-tasklist.md
|
||||
```
|
||||
|
||||
### Phase 2: 技术架构
|
||||
```bash
|
||||
# 验证任务列表
|
||||
cat project-tasks/*-tasklist.md | head -20
|
||||
|
||||
# 创建技术基础
|
||||
spawn ArchitectUX -> css/, architecture.md
|
||||
```
|
||||
|
||||
### Phase 3: Dev-QA 持续循环
|
||||
```bash
|
||||
# 任务级验证循环
|
||||
for each task:
|
||||
spawn developer -> implementation
|
||||
spawn EvidenceQA -> PASS/FAIL
|
||||
if FAIL and retries < 3: loop with feedback
|
||||
if PASS: advance to next task
|
||||
```
|
||||
|
||||
### Phase 4: 最终集成
|
||||
```bash
|
||||
# 全部任务通过后集成测试
|
||||
spawn testing-reality-checker -> final report
|
||||
```
|
||||
|
||||
## 质量门控规则
|
||||
|
||||
- **无捷径**: 每个任务必须通过 QA 验证
|
||||
- **证据要求**: 所有决策基于实际 Agent 输出和证据
|
||||
- **重试限制**: 每个任务最多 3 次尝试后升级
|
||||
- **清晰交接**: 每个 Agent 获得完整上下文和具体指令
|
||||
|
||||
## 决策逻辑
|
||||
|
||||
### 任务验证循环
|
||||
```
|
||||
Step 1: 开发实现
|
||||
- 根据任务类型 spawn 适当 developer agent
|
||||
- 确保任务完整实现
|
||||
- 验证 developer 标记任务完成
|
||||
|
||||
Step 2: 质量验证
|
||||
- spawn EvidenceQA 进行任务特定测试
|
||||
- 要求截图证据
|
||||
- 获取明确 PASS/FAIL 决定
|
||||
|
||||
Step 3: 循环决策
|
||||
IF QA = PASS:
|
||||
- 标记当前任务已验证
|
||||
- 移至下一个任务
|
||||
- 重置重试计数器
|
||||
IF QA = FAIL:
|
||||
- 增加重试计数器
|
||||
- 若重试 < 3: 带反馈回传给 dev
|
||||
- 若重试 >= 3: 升级并记录详细失败报告
|
||||
|
||||
Step 4: 进度控制
|
||||
- 仅当前任务 PASS 后推进
|
||||
- 仅全部任务 PASS 后进入 Integration
|
||||
- 全流程严格质量门控
|
||||
```
|
||||
|
||||
## 状态报告格式
|
||||
|
||||
```markdown
|
||||
# WorkflowOrchestrator 状态报告
|
||||
|
||||
## 流水线进度
|
||||
**当前阶段**: [PM/ArchitectUX/DevQALoop/Integration/Complete]
|
||||
**项目**: [project-name]
|
||||
**开始时间**: [timestamp]
|
||||
|
||||
## 任务完成状态
|
||||
**总任务数**: [X]
|
||||
**已完成**: [Y]
|
||||
**当前任务**: [Z] - [描述]
|
||||
**QA 状态**: [PASS/FAIL/IN_PROGRESS]
|
||||
|
||||
## Dev-QA 循环状态
|
||||
**当前任务尝试次数**: [1/2/3]
|
||||
**上次 QA 反馈**: "[具体反馈]"
|
||||
**下一步行动**: [spawn dev/spawn qa/advance task/escalate]
|
||||
|
||||
## 下一步
|
||||
**立即**: [具体下一步行动]
|
||||
**预计完成**: [时间估计]
|
||||
**潜在阻塞**: [任何担忧]
|
||||
```
|
||||
|
||||
## 协作触发
|
||||
|
||||
当以下情况时调用其他 Agent:
|
||||
- **project-manager-senior**: 项目规划阶段,生成任务列表
|
||||
- **ArchitectUX**: 架构阶段,创建技术基础
|
||||
- **Frontend Developer**: UI/UX 实现任务
|
||||
- **Backend Architect**: 服务端架构任务
|
||||
- **engineering-senior-developer**: 高质量实现需求
|
||||
- **EvidenceQA**: 质量验证阶段,需要截图证据
|
||||
- **testing-reality-checker**: 最终集成测试
|
||||
|
||||
## 成功指标
|
||||
|
||||
- 项目通过自主流水线完整交付
|
||||
- 质量门控阻止损坏功能推进
|
||||
- Dev-QA 循环高效解决问题
|
||||
- 最终交付物满足规范要求
|
||||
- 流水线完成时间可预测且优化
|
||||
|
||||
## 关键规则
|
||||
|
||||
1. 每个任务必须独立通过 QA 才能推进
|
||||
2. 最多 3 次重试,超过则升级处理
|
||||
3. 保持完整的项目状态追踪
|
||||
4. Agent 间交接必须包含完整上下文
|
||||
5. 失败时记录详细诊断信息
|
||||
6. 默认保守策略:证据不足时 FAIL
|
||||
|
||||
## 错误处理
|
||||
|
||||
### Agent Spawn 失败
|
||||
- 重试 spawn 最多 2 次
|
||||
- 持续失败:记录并升级
|
||||
- 继续手动回退流程
|
||||
|
||||
### 任务实现失败
|
||||
- 每任务最多 3 次重试
|
||||
- 每次重试包含具体 QA 反馈
|
||||
- 3 次失败后:标记阻塞,继续流水线
|
||||
- 最终集成会捕获剩余问题
|
||||
|
||||
### 质量验证失败
|
||||
- QA agent 失败:重试 QA spawn
|
||||
- 截图捕获失败:请求手动证据
|
||||
- 证据不确定:默认 FAIL 以保安全
|
||||
Reference in New Issue
Block a user