用途
run-teamwork 用于“一次成型”地组建并运行一个 AI 智能体团队，根据用户给出的项目描述从零构建项目。它负责设计团队、生成智能体、等待任务完成并交付结果，全程不做分析或优化循环。
主要能力
- 解析项目描述与可选参数（如 --port，默认 3013）。
- 确定项目名称（短 kebab-case）并统计独立工作域数量。
- 按“1 个智能体 = 1 个独立工作域 = 1 个目录”的原则设计团队，避免两个智能体写入同一目录。
- 生成项目经理（PM）系统提示词，写入 /tmp/vibehq-run-pm-prompt.md。
- 启动 hub、清理旧状态、生成各智能体并等待完成。
- 轮询任务状态，直到全部完成或超时（约 20 分钟）。
团队规模参考
- 1 个域：PM + 1（仅 API、CLI、单一技术栈）
- 2 个域：PM + 2（典型全栈：后端 + 前端）
- 3 个域：PM + 3（全栈 + 独立数据/基础设施域）
- 4+ 个域：PM + 4（最多 5 个成员）
反模式包括：两个智能体在同一目录、按“功能”拆分同一代码库、没有大量 UI 交付物却设置设计师智能体。
使用方式
- 解析与设计：从 $ARGUMENTS 提取项目描述与标志，确定项目名与团队，生成 PM 提示词，打印团队设计。
- 启动：创建目录（项目目录位于用户主目录 ~/<project-name>），启动 hub（node dist/bin/hub.js --port <port> --team <project-name> &，后台运行并等待 3 秒），删除旧 hub 状态，写入并运行生成脚本 /tmp/vibehq-run-spawn.js 来生成智能体。
- 等待完成：写入并运行轮询脚本 /tmp/vibehq-run-poll.js，每 30 秒检查一次任务状态，直到 COMPLETE 或 20 分钟超时。
- 完成：打印摘要，包括项目名、耗时、任务完成数、输出目录，以及查看/停止智能体的 tmux 命令。
适用场景
适合需要快速从提示词生成一个完整项目、且希望由多个智能体分工协作的场景。典型如全栈应用、CLI 工具、单一技术栈 API 等。
限制与规则
- 一次成型：不迭代、不分析、不循环。
- 必须使用 --auto-kickstart，智能体需立即开始工作。
- macOS/Linux 使用 tmux，Windows 使用 Windows Terminal，不可混用。
- 智能体通常需要 8-15 分钟，需耐心等待。
- hub 必须先于智能体启动，启动后等待 3 秒。
- 项目目录位于主目录 ~/<project-name>。
- 项目经理是协调者，绝不写代码，只使用 MCP 协调工具。
- 工作智能体不生成自定义系统提示词，使用生成器内置角色预设。
- 研究任务必须先于实现任务完成，实现任务需引用研究输出（consumes 字段），并要求真实集成而非模拟数据。
暂未提供
关于收费、价格、平台支持细节、效果保证等信息，资料中暂未提供。