Vibe Squad 是 Markdown 驱动的多模型 AI 编排系统 | 极客的赛博空间

根据 Vibe Squad 的官方仓库，这是一个 Markdown 驱动的多模型 AI 编排系统，通过一个协调器（Chrono）在隔离的 Git worktree 中调度 68 个角色化专家代理。以下是完整的部署与使用教程。

🧭 核心概念与工作流程

Vibe Squad 专为喜欢“Vibe Coding”（自然语言驱动编程）但希望比单次聊天更结构化的用户设计。其核心思想是：你只需与协调器 Chrono 对话，它负责规划、分派和监督。

Chrono（协调器）：你唯一的对话入口。它将你的目标转化为计划，为每个子任务选择最合适的专家（Specialist）和模型（Model），并管理整个生命周期。
专家（Specialists）：68 个通过 Markdown 文件定义的“角色”（如前端开发专家、安全审计员）。每个专家都绑定了最适合其工作的模型系列（如 Codex、Claude、Gemini 或 Kimi），而非统一使用一个模型。
隔离执行（Sandboxed Execution）：每个任务都在一个独立的 Git worktree 中运行，拥有明确的读写范围声明。这确保了不同任务间的环境隔离，避免交叉污染。
跨家族审查（Cross-Family Review）：关键工作会由不同模型家族的专家进行独立审查（例如，Claude 写的工作由 Gemini 审查），避免模型自我认可其推理。
持久化记忆（Durable Memory）：Chrono 会将每个任务的学习成果记录在本地私有的 Markdown 保险库中，并在未来任务中检索调用，让经验不断累积。

两种工作模式：

Project（项目模式）：涵盖软件开发、研究、内容创作等。生命周期为：范围界定 → 计划 → 构建 → 验证 →（如需）审查 → 交付 → 记忆。
Bounty（赏金模式）：用于授权的安全测试工作。强制要求明确的测试范围、目标清单和可复现的证据，并需通过跨家族审查。

📦 部署与安装

前提要求

操作系统：目前仅支持 macOS。
必需工具：tmux, fswatch, jq, curl, Python 3.13, uv。
模型 CLI 认证：需要安装并认证 Claude、Codex、Gemini 和 Kimi 的原生 CLI 工具。Gemini 使用 API Key 认证，其他为订阅或托管登录路径。

安装步骤

创建私有记忆保险库（必须）：记忆数据需要存放在公共仓库之外。

1
2
3

mkdir -p "$HOME/Obsidian-Chrono"
printf '%s\n' '{"vault_id":"my-private-vault","schema_version":1}' > "$HOME/Obsidian-Chrono/.chrono-vault"
export CHRONO_VAULT_ROOT="$HOME/Obsidian-Chrono"

克隆与初始化：

1
2
3

git clone https://github.com/mtarcure/claude-vibe-squad.git
cd claude-vibe-squad
uv sync  # 创建 Python 3.13 环境

激活 Git Hooks（关键安全步骤）：这会在提交前运行检查，防止泄露私有数据。
1
git config core.hooksPath .githooks
运行健康检查并启动：
1
2
bin/squad doctor # 检查环境配置
bin/squad up # 启动 tmux 控制室
bin/squad up 会打开一个带有 Chrono 和状态窗口的 tmux 会话。你可以用 Ctrl-b d 脱离，用 bin/squad attach 重新进入。

注意：bin/squad up 会提示可选的 launchd 后台守护进程。该守护进程非必需，它仅用于 tmux 状态栏的 ● daemon 显示和 MCP HTTP 桥接。核心调度、隔离和记忆功能均不依赖它。

🚀 日常使用

在 Chrono 聊天窗口中用自然语言提出请求：

1	帮我构建一个时尚的落地页，在浏览器中测试，并展示结果。

或

1	研究这个产品创意，对比竞争对手，并生成一份带引用的简报。

Chrono 自动处理：
- 它会将请求映射到 Project 或 Bounty 模式。
- 生成一个 Markdown 计划，并从 68 个专家中路由选择。
- 在隔离的 worktree 中启动一个原生 CLI 进程（如 Claude Code）来执行任务。
- 任务完成后，如果风险较高，会触发另一模型家族的专家进行独立审查。
- 结果被原子性地写回，并由 Chrono 总结呈现给你。
记住原则：
- 你只和 Chrono 对话，不直接与专家或模型交互。
- 专家的行为由编辑 Markdown 文件改变（位于 departments/ 和 shared/specialists/ 目录），无需修改代码。
- 私有数据永不进入仓库：凭证、目标数据、私有记忆都在仓库外。

⚙️ 理解关键组件

分派包（Dispatch Packet）：一个带 YAML 头部的 Markdown 文件，是任务的合同。它指定了使用哪个专家、哪个模型、读写范围以及完成标准。这个设计使得任何任务都可以事后重建和诊断。
记忆机制：Chrono 使用 FTS5/BM25 索引进行检索，召回的记忆会附带来源、敏感度等级和“争议”标志（当被后续笔记反驳时）。你也可用 Obsidian 作为这些 Markdown 文件的图形化查看界面。
专家与模型绑定：每个专家的 Markdown 文件定义了其绑定的模型家族。这是质量优先的路由，而非随机或单一模型。
工具与探针：系统使用原生 CLI 与四个模型家族通信。任何声称可用的工具，只有通过一次实时探针（Live Probe） 验证后才被视为真正可用。

❓ 状态与扩展

当前状态：项目处于 v1.1.2 活跃开发状态，维护者日常使用。包含超过 1900 个测试用例，覆盖了分派、隔离、记忆等核心功能。
贡献：欢迎通过 PR 贡献，请先阅读 CONTRIBUTING.md。核心是添加或修改专家只需编辑 Markdown 文件，无需编写 Python 代码。务必遵守私有数据保护规则。
未声称的特性：完整的旧记忆迁移、自动故障转移、完全的新工人工具支持等仍为开放计划，项目诚实标注了这些未完成项。

总结

Vibe Squad 为希望结构化、可审计地管理多模型 AI 代理协作的用户提供了一个独特的命令行工作流。部署的核心是在 macOS 上准备好 Python 3.13 和四个模型的 CLI，并务必要设置 git config core.hooksPath .githooks 来激活预提交检查。日常使用中，你只需和 Chrono 聊天即可完成复杂任务的分发与整合。如果你愿意将开发流程迁移到 tmux 和 Markdown 环境中，它将提供比单一 AI 聊天更强大的团队级开发能力。