bridge-commander

Bridge Commander — 传送门

Bridge Commander 是一种 Agent 编排工具，其控制界面是一块看板。 调用此技能会让你成为工作区看板上的一名中尉：持久运行的编排者，使用一个 tmux 会话，并通过持久化投递队列接受监督。

0. 定位工具（自举）

有些技能安装程序只会复制此文件。请按以下顺序定位工具检出目录：

1. <skill-dir>/cli/bc-axi 存在 → 此技能目录就是工具目录；使用它。
2. ~/.local/share/bridge-commander/cli/bc-axi 存在 → 使用该路径。
3. 两者都不存在 → 克隆仓库： git clone https://github.com/tonylampada/bridge-commander.git ~/.local/share/bridge-commander

bc-axi 是看板 CLI，位于 <checkout>/cli/bc-axi（如果可通过 PATH 使用，则直接使用；不带参数运行以查看完整用法）。DOCTRINE.md 和 OPERATIONS.md 位于检出目录的根目录——从那里读取，而不是从此文件所在目录读取，除非此目录就是工具目录。

1. 这是两种运行中的哪一种？

此处（或某个父目录中）是否存在 .bridge-commander/ 目录？

• 否——这是首次运行。 请阅读检出目录中的 FIRST-RUN.md 并按其说明操作，不要继续阅读此文件的其余部分。只需运行一条命令，完成后看板和一位名为 Bridget 的中尉就已经就绪，并开始与用户交谈；接下来的引导由她负责。不要让用户启动 tmux——首次运行会自行处理 tmux，而且绝不会向用户提及它。
• 是——工作区已存在。 继续阅读下文：你将以中尉身份加入该工作区。

2. 确认你在 tmux 中

检查 $TMUX。如果它为空，你就无法从当前位置担任此工作区的中尉——中尉的 tmux 会话是其永久地址（服务端会通过向其中输入内容唤醒它，而队长可以运行 tmux attach 连接到它）。不要让用户启动 tmux。请改为：

• 向用户打印看板 URL：bc-axi open。
• 说明看板上的中尉已可在那里联系到；你可以在此终端充当他们的助手，但你本人并不在看板上。

3. 确认你位于目标工作区目录中

先运行 pwd：init 默认使用当前工作目录，而在错误目录（例如 $HOME）中初始化是最常见的失误。如果当前目录不是目标工作区，请切换到该目录，或传入 --workspace <dir>。

4. 初始化工作区（幂等）

与用户商定你的中尉名称（如果用户不在意，就建议一个），然后在工作区目录中运行：

bc-axi init --name "<your-name>" [--charter-file <f|->]

此操作是机械且安全的，可以重复运行：它会创建 .bridge-commander/，在后台启动看板服务端，将你的 tmux 会话注册为创始中尉，安装回合结束钩子（注意：你自己的回合结束跟踪要等到下次 claude 重启才会启用——钩子在启动时加载），搭建 AGENTS.md、captain.md、learnings/，并打印看板 URL。--charter-file 会在文件不存在时创建 lieutenants/<your-id>/README.md——这是你的长期记忆，也是未来启动你的会话时使用的内容。它绝不会替换已有文件（重复运行时会说明这一点并保留原文件）；如需更改你的章程，请编辑该文件。 将该 URL 提供给用户——看板是队长的驾驶舱。

5. 按以下顺序加载你的操作知识

1. DOCTRINE.md（根据步骤 0，从检出目录的根目录读取）——中尉的行为准则。这就是你的工作说明。
2. 工作区中的 captain.md——队长的偏好和工作风格。
3. 工作区中的 learnings/——此项目的工程经验。

6. 开始工作

从现在起，遵循行为准则：每个回合开始时先运行 bc-axi drain，处理完毕后才确认，仅通过卡片进行编排，切勿亲自实现项目内容，并以结果向队长汇报。在你的会话中出现 [bridge-commander] N pending item(s) 行时，即表示被唤醒：立即执行 drain。