clawteam

clawteam — ClawTeam 运行时操作员路由器

当真正的问题是**“我现在需要哪个 ClawTeam 操作员数据包？”**时，请使用此技能。

clawteam 负责 ClawTeam 专属的运行时功能：

• 团队 / 任务 / 收件箱状态
• 通过 tmux 或 subprocess 启动工作者
• 工作区或 git-worktree 隔离
• 看板可见性和恢复流程
• 模板启动
• 与启动行为相关的提供商 / 预设 / 配置档设置

它不负责通用多 Agent 编排、看板治理或轻量级子任务分发。

在扩大适用范围前，请阅读以下支持文档：

• references/intake-packets-and-route-outs.md
• references/operator-modes-and-route-outs.md
• references/architecture.md
• references/agent-types.md
• references/use-cases.md

何时使用此技能

• 用户明确提到 clawteam，或显然需要 ClawTeam 的团队 / 任务 / 收件箱 / worktree 运行时
• 需要负责人协调具名工作者，并明确任务所有权和消息传递
• 用户需要 ClawTeam 看板命令，例如 board attach、board live 或 board serve
• 用户需要启动内置 ClawTeam 模板
• 真正的阻碍是在启动前配置 ClawTeam 内部 的提供商 / 模型 / 配置档
• 工作流涉及开发交付、产品 / 运营研究、内容运营或游戏开发，并且所选运行时是 ClawTeam

何时不使用此技能

• 包含规划 + QA 的通用多 Agent 实现循环 → jeo、oh-my-claudecode、oh-my-codex 或 oh-my-agent
• ClawTeam 运行时之外的看板 / 工作队列控制 → task-planning
• 无需团队 / 任务 / 收件箱 / worktree 状态的轻量级并行子任务 → 内置委派 / 子 Agent
• 规划或拆解 → task-planning
• 工具比较或平台调研 → survey

说明

步骤 1：从手头已有的数据包开始

使用 references/intake-packets-and-route-outs.md。

首先将请求归一化为一个数据包：

clawteam_packet:
  primary_packet: manual-team | template-launch | monitor-recover | profile-setup | route-out
  backend: tmux | subprocess | unknown
  audience: developer-workflow | product-ops | marketing-content | game-production | mixed
  current_pain: ownership-split | quick-start | stuck-runtime | provider-setup | wrong-tool
  confidence: high | medium | low

只选择一个主要数据包：

• manual-team — 明确的团队生命周期、工作者角色、任务、收件箱和依赖项
• template-launch — 启动预构建的 ClawTeam 团队并监控其运行
• monitor-recover — 检查正在运行或卡住的团队、看板、收件箱、任务、工作区或生命周期状态
• profile-setup — 启动前的预设 / 配置档 / 提供商 / 模型 / 运行时设置
• route-out — 请求实际上与 ClawTeam 运行时无关

规则：如果用户真正想要的是“多个 Agent”，而不是“ClawTeam”，请立即转交。

步骤 2：在提供更深入的命令前，验证最基本的运行时

在假设 ClawTeam 会帮忙解决问题之前，先检查哪些部分已经正常运行。

python3 --version
clawteam --help

tmux -V

# Replace with the agent CLI the user actually wants to run:
claude --version
codex --version

规则：

1. 如果底层 Agent CLI 本身无法运行，不要假装 clawteam spawn 能解决问题。
2. 对于可见的交互式工作者和实时操作员控制，优先使用 tmux。
3. 仅当确实需要无头 / 后台执行时，才优先使用 subprocess。
4. 如果阻碍在于自定义提供商 / 模型配置，请先选择 profile-setup，再提供大型启动示例。

步骤 3：返回最精简且实用的命令数据包

数据包 A — manual-team

当任务所有权和依赖项必须保持明确时使用。

clawteam team spawn-team my-team -d "Build the auth module" -n leader
clawteam spawn tmux claude --team my-team --agent-name architect --task "Design the API schema"
clawteam spawn tmux codex --team my-team --agent-name tester --task "Write integration tests"
clawteam task create my-team "Design the API schema" -o architect
clawteam inbox send my-team tester "Wait for API handoff before final checks"
clawteam board attach my-team

如果用户需要完整的全栈、研究、内容或游戏开发分工示例，请使用 references/use-cases.md。

数据包 B — template-launch

当内置模板已经适用于该任务时使用。

clawteam template list
clawteam launch hedge-fund --team fund1 --goal "Analyze AAPL, MSFT, NVDA for Q2 2026"
clawteam board attach fund1

除非模板明显不合适，否则不要把它埋进完整的 manual-team 演示流程中。

数据包 C — monitor-recover

当团队已经存在，或问题的核心在于确认运行时的实际状态时使用。

clawteam team discover
clawteam team status my-team
clawteam board show my-team
clawteam task list my-team --status blocked
clawteam inbox peek my-team
clawteam workspace list my-team

使用此数据包检查卡住的工作者、被阻塞的任务、缺失的收件箱活动或工作区偏移。

数据包 D — profile-setup

当运行时/提供方设置才是真正的阻碍时，使用此数据包。

clawteam preset list
clawteam preset show moonshot-cn
clawteam preset generate-profile moonshot-cn claude --name claude-kimi
clawteam profile doctor claude
MOONSHOT_API_KEY=*** clawteam profile test claude-kimi
clawteam spawn tmux --profile claude-kimi --team my-team --agent-name researcher --task "Compare onboarding flows"

如果问题实际涉及提供方/模型/运行时配置，请在给出大型团队示例之前使用此数据包。

第 4 步：如实说明运行时情况

ClawTeam 风格的工作流仍然需要操作人员投入大量精力。

在相关情况下说明以下实际情况：

• tmux 和 worktree/会话检查通常是实际工作流的一部分，而非实现细节
• 在某些流程中，长时间运行的工作进程可能无法稳定持续运行；不要夸大其可靠性
• 信任提示、权限流程和特定后端的特性仍可能暴露在抽象层之外
• 运行后可能仍需手动清理、合并或整理工作区

上游的重要注意事项：

• issue #148 记录了持续作业子进程模式中的工作进程保活问题
• issue #146 记录了解析出的 Agent 定义/配置与实际应用的运行时行为之间的差异

如果用户需要通用编排策略、看板治理或轻量级内置委派，请转向其他方案，而不是扩展此技能。

第 5 步：给出一份简洁的操作说明

首选格式：

# ClawTeam Operator Brief

## Packet
- Packet:
- Why it fits:
- Backend:

## Preconditions
- Verified:
- Missing / risky:

## Commands
1. ...
2. ...
3. ...

## Monitoring / recovery
- ...

## Caveats
- ...

## Route-outs kept out of scope
- ...

简短、真实的数据包胜过冗长的命令清单。

示例

示例 1：全栈功能拆分

输入

使用 ClawTeam 将一个全栈功能拆分给一名负责人和两名工作进程。

良好的输出方向

• 选择 manual-team
• 首先验证运行时和工作进程 CLI
• 创建团队、启动工作进程、创建明确的任务，并以一条看板命令结束
• 将规划/审核策略留在此技能之外

示例 2：优先使用模板

输入

启动一个内置的 ClawTeam 团队，让我能观察它。

良好的输出方向

• 选择 template-launch
• 如有需要，使用 template list
• 使用 launch ... --team ... --goal ...
• 使用 board attach 或 board serve 进行监控

示例 3：运行时恢复

输入

一个 ClawTeam 工作进程在完成第一轮后就不断退出。我该检查什么？

良好的输出方向

• 选择 monitor-recover
• 检查团队、看板、任务、收件箱和工作区状态
• 说明长时间运行的工作进程并非在所有流程中都能保证持续运行
• 不要假装通用编排技能能够解决这个问题

示例 4：坦诚地引导至其他方案

输入

我只需要一个包含规划和 QA 的通用多 Agent 实现循环。

良好的输出方向

• 选择 route-out
• 推荐 jeo、oh-my-claudecode、oh-my-codex 或 oh-my-agent
• 说明 clawteam 是 ClawTeam 的运行时/操作界面，并非所有多 Agent 需求的通用答案

最佳实践

1. 先选择一个数据包，不要一次性罗列所有 ClawTeam 命令类别。
2. 启动工作进程前，先验证底层 Agent CLI 和后端。
3. 优先使用 tmux 进行可见的操作控制；仅在确实需要无头执行时才使用 subprocess。
4. 仅在内置原型确实适用时，才使用模板启动。
5. 将提供方/配置文件设置视为独立路径。
6. 明确说明工作进程持续运行和配置应用方面的注意事项。
7. 将 clawteam 与编排路由器、规划技能和看板治理工具区分开来。
8. 触发条件的措辞发生实质性变化时，更新精简版和发现界面。

参考资料

• ClawTeam README
• PyPI：clawteam
• references/intake-packets-and-route-outs.md
• references/operator-modes-and-route-outs.md
• references/architecture.md
• references/agent-types.md
• references/use-cases.md