# subagent-collab

**Repository Path**: woipanda/subagent-collab

## Basic Information

- **Project Name**: subagent-collab
- **Description**: OpenClaw subagent collaboration skill for complex-task orchestration, role-based worker coordination, verification, and runtime rollout readiness.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-01
- **Last Updated**: 2026-04-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# subagent-collab

一个给 OpenClaw / 小龙虾用的 **子 Agent 协作 Skill**。

它不是单纯“多开几个 agent”，而是把复杂任务变成一套更稳定的协作方式：
- 主 agent 负责编排
- 子 agent 分角色执行
- 结果结构化回收
- 关键任务独立验证

适合你遇到这种情况时用：
- 一个问题太复杂，一个 agent 全做又慢又乱
- 想把任务拆成“调研 / 实现 / 验证”几个角色来处理
- 想让子 agent 不只是帮忙，而是真正按协议协作

---

## 它能解决什么问题

很多多 agent 方案的问题不是“不能开 worker”，而是：
- 不知道什么时候该拆
- 拆完以后谁干什么不清楚
- 结果回来一团乱
- implementer 做完没人独立验证
- runtime 没完全打通时，用户还以为已经是真并发协作

`subagent-collab` 解决的就是这类问题。

它把复杂任务整理成一套更可控的流程：
1. 先判断值不值得拆
2. 再按角色拆
3. 再按任务包派发
4. 子 agent 按结果包回收
5. 关键任务独立 verifier 复核
6. 主 agent 最后统一收口

---

## 适合哪些场景

这类任务最适合：
- 复杂问题拆解
- 多材料分析
- 复杂排障
- implementer + verifier 闭环
- 多阶段任务协作

典型触发语句：
- “分几个 agent 做”
- “并行处理一下”
- “让子 agent 协作起来”
- “这个问题有点复杂，帮我拆开处理”
- “先调研，再实现，再验证”

不太适合：
- 简单单步任务
- 高风险不可逆动作还没确认的时候
- 多个 agent 会频繁改同一对象 / 同一文件区域的时候

---

## 这个 Skill 里面有什么

- **触发判断**：什么时候该进入子 agent 模式
- **任务包模板**：怎么给子 agent 发清楚的任务
- **结果包模板**：怎么把结果收回来，避免散掉
- **角色划分**：explorer / implementer / verifier / synthesizer
- **并发与验证规则**：什么能并行，什么必须串行
- **两个现成 playbook**：
  - complex analysis
  - complex debug
- **运行层映射**：协议层和 OpenClaw runtime 怎么接起来

---

## 当前验证到什么程度了

这版不是只有设计，没有跑。

已经验证通过：
- 起 worker
- 回推结果
- 双 worker 并发回收
- `sessions_send` 继续同一 worker 并复用上下文
- implementer + verifier 基本闭环
- failure injection 下的结构化失败回收

当前最稳的口径是：

> **关键链路已验证通过，已具备较强实用性。**

更具体一点：

> 已验证：`subagent-collab` 已跑通关键链路——起 worker → 继续投递 → 沿用同一会话上下文继续执行。`sessions_send` 能把后续任务送回同一个子 agent 会话，而非新开 worker；同一 worker 可复用前一轮上下文。

### 当前边界
这版结论适用于：
- **同一 session 存活期间**

还没覆盖：
- worker 重启后
- 新 session
- 长时间 idle 后恢复
- 更大规模、更长任务下的长期稳定性

所以现在可以说：
- **已经具备正式使用条件**

但还不建议说：
- **完整稳定性已经全部验证完毕**

---

## 怎么用

把这个目录放进你的 skills 目录后，当用户提到：
- 并行处理
- 分几个 agent 做
- 子 agent 协作
- 复杂任务拆解
- 先调研再实现再验证

就应该优先考虑触发这个 skill。

如果你想看具体规则，核心入口是：
- `SKILL.md`

如果你想看具体模板和 playbook：
- `references/trigger-checklist.md`
- `references/task-package-template.md`
- `references/result-package-template.md`
- `references/complex-analysis-playbook.md`
- `references/complex-debug-playbook.md`

---

## 目录结构

```text
subagent-collab/
├── SKILL.md
├── README.md
├── evals/
│   └── evals.json
└── references/
    ├── trigger-checklist.md
    ├── task-package-template.md
    ├── result-package-template.md
    ├── role-selection.md
    ├── concurrency-and-verification.md
    ├── complex-analysis-playbook.md
    ├── complex-debug-playbook.md
    ├── example-scenarios.md
    └── openclaw-mapping.md
```

---

## License

MIT