Control Tower

外觀

相容版本對照 ​

CT 不會先檢查 BAT 版本才決定要不要用某個功能。它一律照常呼叫，失敗時才依 exit code 降級，所以下表不是「用之前要先確認的條件」，而是「BAT 太舊時你會看到什麼」。

原則 ​

  • 照常呼叫，失敗才降級。BAT 太舊時，新參數通常會讓 helper 回 exit 1；CT 依各功能的規則降級（例如去掉參數重派一次、改走工單檔往返、改用 git 計算），不會因此擋住整個流程。
  • 不以錯誤訊息的字串判斷版本。版本判斷只看 exit code 與回傳欄位有沒有出現。
  • 任一邊較舊，就是那個功能不啟用，其餘流程照舊。
  • 塔台和 Worker 要同批升級。新版塔台派工給舊版 Worker 時，應該看到明確的 PARTIAL／BLOCKED 或升級提示，不能當成 YOLO 自動回報已經生效。

每個功能需要的版本 ​

「CT 起始版本」是這個功能在 CT 出現的版本；「BAT 最低版本」與「codex」是功能完整生效需要的版本。BAT 的最低門檻從 0.5.9-pre.1 一路提高到 0.7.1-pre.1；v5.10 到 v5.13 沒有再提高門檻。v5.14.2 只有「Codex 用 plugin 安裝又接 BAT 派工」需要 0.7.2-pre.1，其他功能的門檻不變。v5.14.3 是文件配置，v5.14.4 是 bmad-guide 偵測的規則修正，v5.15.0 改的是 yolo 提問的送法與處理，都沒有新門檻（v5.15.0 用到的 --ask --no-pty-write，BAT 0.7.0-pre.7 起就是這個行為，0.7.2-pre.4 起列為正式契約）。6.0.0 的 BAT 介面同 v6.0.0-pre.1，最低 BAT 版本也不變，沒有新門檻；只有選用的「塔台收單時補記 Worker 的 session id」用到 BAT >= 0.7.1-pre.1 與 BAT MCP，沒有就跳過補記。

相容版本對照
功能CT 起始版本BAT 最低版本codex說明出處
帶前綴的工單 ID 走結構化派工（--workorder 帶前綴）v5.0.6>= 0.5.9-pre.1—這個 BAT 版本出自 BAT 的 fork 版。舊 BAT：塔台單次降級為 --prompt 派工，並明示「已降級」與原因；不以錯誤訊息字串判斷版本。auto-session.md § 舊版 BAT 降級規則（帶前綴 --workorder）；yolo-mode.md § 相容性 › BAT / Worker 版本相容
收單後回收 Worker 分頁（--close-worker、worker_auto_close）v5.1.0>= 0.6.1-pre.4—舊 BAT 回 exit 1：一行警告，照常收單。worker_auto_close 預設 off，不受影響。pre.3 已有這個指令，但分頁剛有輸出會回 BUSY；等輸出安靜再關自 pre.4 起（CT v5.12.3 更正，原寫 0.6.1-pre.3）。CHANGELOG.md [5.1.0]、[5.12.3]；work-order-system.md § 收單後回收 Worker 分頁（worker_auto_close，v5.1.0+）；Guide bat-integration.md § 版本對照表
塔台分頁角色宣告（--set-role tower）v5.2.0>= 0.6.1-pre.6—更舊的 BAT 回 exit 1，視為不支援：面板記「不支援（BAT 太舊）」，塔台照常啟動。auto-session.md § 依賴的 BAT 基礎設施、§ 塔台分頁角色宣告（--set-role tower，v5.2.0+）
每分頁範圍權杖與分頁角色權限v5.2.4>= 0.7.0-pre.1—BAT_REMOTE_TOKEN 改成分頁專屬：Worker 分頁只能通知綁定的塔台，不能派工。舊 BAT 沒有角色限制，行為與 v5.2.3 相同。auto-session.md § 依賴的 BAT 基礎設施、§ 範圍權杖與分頁角色
worktree 隔離派工（--isolation worktree、CT_HOME 等 CT_* 變數）與合併工單v5.3.0>= 0.7.0-pre.2—選用。舊 BAT 上隔離工單回 exit 1 時停下等使用者，不自動改成非隔離；非隔離工單不受影響。auto-session.md § 依賴的 BAT 基礎設施、§ worktree 隔離派工（--isolation worktree，v5.3.0+）
隔離工單回收（--worktree keep／remove）與 --worktree-statusv5.3.0>= 0.7.0-pre.2—--worktree-status 失敗時，改用 git 計算直接合併的判準。auto-session.md § 依賴的 BAT 基礎設施；Guide bat-integration.md § 版本對照表
BAT MCP 唯讀 tool（mcp__bat__*）v5.3.0>= 0.7.0-pre.2—選用通道，目前沒有任何 CT 規則必須用它；沒有這組 tool 就直接走 helper 或讀檔案。BAT README 另註 Codex 分頁要 >= 0.7.0-pre.3。auto-session.md § 依賴的 BAT 基礎設施、§ BAT MCP 唯讀 tool（選用通道，v5.3.0+）
Worker 分頁回收後仍可查 --worktree-status（回傳帶 source）v5.4.0>= 0.7.0-pre.4—成功回傳沒有 source 時，照舊在回收分頁之前查；回收後查不到（exit 3）就改用 git。auto-session.md § 依賴的 BAT 基礎設施；Guide bat-integration.md § 版本對照表
yolo 提問通道（Worker 送「T#### 提問」，在工單檔往返）v5.5.0——沒有新的 BAT 門檻，只用工單檔與 bat-notify.mjs。舊 Worker 不會提問，行為不變。yolo-mode.md § Worker 向塔台提問（v5.5.0+）、§ 相容性 › BAT / Worker 版本相容
斷點 D：查到 Worker 在等人（MCP 回報 blocked）v5.5.0>= 0.7.0-pre.4—回傳沒有 blockedDetection 或 MCP 不可用時，斷點 D 不啟用，流程照常。yolo-mode.md § 斷點 D：Worker 等待使用者（v5.5.0+）、§ 相容性 › BAT / Worker 版本相容
blockedReason 準確（AskUserQuestion 回報 question、回答後立即清除）v5.5.1>= 0.7.0-pre.5—0.7.0-pre.4 把提問報成 permission；CT 照原值顯示、措辭中性，邏輯相同。yolo-mode.md § 相容性 › BAT / Worker 版本相容；Guide bat-integration.md § 版本對照表
Worker 啟動確認（--wait-started、exit 8、MCP agentStarted）v5.6.0>= 0.7.0-pre.6—舊 helper 回 exit 1 加 Unknown option '--wait-started'（沒有建立分頁）時，去掉參數重派一次，本 session 之後不再帶。exit 8 表示分頁已建立，不重派。auto-session.md § 依賴的 BAT 基礎設施、§ Worker 啟動確認（--wait-started，v5.6.0+）
yolo 提問走 BAT 結構化通道（--ask、--answer、bat_wait_question、bat_list_questions、blockedReason: tower）v5.7.0>= 0.7.0-pre.7—題目仍先寫進工單（雙寫）。--ask 失敗、tool 不存在或沒有 pendingQuestions 時，回到工單檔往返，行為同 v5.6.1。auto-session.md § 依賴的 BAT 基礎設施；yolo-mode.md § Worker 向塔台提問 › BAT 通道（v5.7.0+）
codex 分頁的 OSC 7501（blockedDetection: osc、blockedReason: input，--wait-started 對 codex 生效）v5.8.0>= 0.7.0-pre.9>= 0.163.0舊 BAT（≤ 0.7.0-pre.8）或較舊的 codex：blockedDetection: none、agentStarted: null、started: unknown，行為同 v5.7.2。auto-session.md § 依賴的 BAT 基礎設施；yolo-mode.md § 相容性 › BAT / Worker 版本相容
跨 session 選收件人（ListAgents 的「<工作區> · Tower」、claudeSessionName、bat_list_terminals scope: towers）v5.9.0>= 0.7.1-pre.1—舊 BAT（≤ 0.7.0-pre.9）沒有分頁名稱與這兩個鍵，scope: towers 回 INVALID_ARGS；改請使用者轉交回覆稿，行為同 v5.8.1。auto-session.md § 依賴的 BAT 基礎設施；cross-project-coordination.md § 跨 session 選收件人（v5.9.0+）
同一張工單重派前，先回收舊 Worker 分頁（沿用 --close-worker，--delay-ms 0）v5.12.0>= 0.6.1-pre.4—沒有新的 BAT 門檻，與 v5.1.0 相同。舊 BAT 回 exit 1：一行提示後照常派工，本 session 不再嘗試。CHANGELOG.md [5.12.3]；work-order-system.md § 重派前回收舊 Worker 分頁（v5.12.0+）；Guide bat-integration.md § 版本對照表
BAT 指揮塔總覽顯示下一個編號與待辦（塔台寫 _tower-state.md 的機器可讀摘要）v5.13.0>= 0.7.1-pre.7—這個 BAT 版本是預覽版。更舊的 BAT 不讀摘要，總覽只是少這兩項。舊專案沒有摘要不算錯，塔台下次寫 _tower-state.md 時補上。沒有新的 CT 最低 BAT 版本。CHANGELOG.md [5.13.0]；memory-protocol.md § 機器可讀摘要（YAML frontmatter）、§ BAT 塔台面板讀取契約
BAT 指揮塔面板讀不到檔時顯示「無法讀取」，索引只寫 critical 也算 High（讀取契約對照的 BAT 版本）v5.13.1>= 0.7.1-pre.9—這個 BAT 版本是預覽版。CT 寫檔不分 BAT 版本：400 KB 預算保留，索引照舊寫 🔴 High（critical）；更舊的 BAT 超過 512 KiB 仍靜默變空。沒有新的 CT 最低 BAT 版本。CHANGELOG.md [5.13.1]；memory-protocol.md § BAT 塔台面板讀取契約
plugin marketplace 安裝（Claude Code、Codex）；Codex 搭配 BAT 派工用 zip 手動安裝v5.14.0——BAT 介面與最低 BAT 版本不變。BAT 對 Codex 送不帶前綴的 $ct-exec，plugin 版在 Codex 只能用 $ct:ct-exec 呼叫，所以接 BAT 派工的 Codex 用 zip 手動安裝；Claude Code 用 plugin 不受影響。beta 不上架。v5.14.2 起改成依 BAT 版本，見 v5.14.2 列。CHANGELOG.md [5.14.0]；version-governance.md § plugin 安裝／升級；auto-session.md § 依安裝方式的 skill 呼叫字串
Level 2 偵測得到 plugin 安裝的 bmad-guide；塔台端派工與回收範本用完整工單 IDv5.14.1——BAT 介面、派工命令的參數與順序、最低 BAT 版本都不變。塔台依序找手動安裝、Claude Code plugin、Codex plugin，並存時用手動那份；已安裝卻讀不到時提示一次。CT 5.14.0 與 6.0.0-beta.5 以前的 beta 只查 skills/ 目錄，搭配它們時 bmad-guide 仍建議用 zip 手動安裝；6.0.0-beta.6 起 adapter 也偵測得到（beta.7 實機驗證過）。v5.14.4 起改成依 runtime 分開，見 v5.14.4 列。CHANGELOG.md [5.14.1]；enhancement-integration.md § Level 2：外部 bmad-guide › 偵測；auto-session.md § 執行方式
Codex 用 plugin 安裝也能接 BAT 派工（BAT 依 Codex 端的安裝方式送 $ct-exec 或 $ct:ct-exec）v5.14.2>= 0.7.2-pre.1—這個 BAT 版本是預覽版。只有「Codex 用 plugin 安裝又要接 BAT 派工」需要它；Codex 用 zip 手動安裝、或只用 Claude Code 的，BAT 不必升級。兩種都裝時 BAT 送手動那份，所以從 zip 改用 plugin 照樣要先移除手動安裝。更舊的 BAT 一律送 $ct-exec，接它派工的 Codex 用 zip 手動安裝。CT 派工命令不變；端到端派工尚未實機驗證。CHANGELOG.md [5.14.2]；auto-session.md § 依安裝方式的 skill 呼叫字串、§ 依賴的 BAT 基礎設施；version-governance.md § plugin 安裝／升級
一個塔台管多個巢狀的獨立 repo（工單集中在上層、Worker 在上層執行、子 repo 用 git -C commit）v5.14.3——文件配置，不是新規則：落點檢查、commit 規則、派工命令、BAT 介面與最低 BAT 版本都不變，CT 5.14.2 起就能這樣用。不能用 worktree 隔離；C-0 只驗上層。實機驗證用 CT 5.14.2 搭配 BAT 0.7.2-pre.1；面板一鍵派工與子 repo 有 remote 時的 push 尚未實機驗證。CHANGELOG.md [5.14.3]；mono-repo-patterns.md § 巢狀的獨立 repo（一個塔台、多個共用 repo）；multi-tower-protocol.md § 決策：一個塔台還是多個
Level 2 找 bmad-guide 時先找塔台所在 runtime 的安裝；Claude Code 的 plugin 位置只算一處v5.14.4——規則修正，沒有新門檻：BAT 介面、派工命令、最低 BAT 版本都不變。順序是本 runtime 的手動安裝 → 本 runtime 的 plugin → 另一個 runtime 的安裝（只拿來讀檔，第一次用到時註明一次）；手動優先只在同一個 runtime 內成立。Claude Code 的 plugin 預設在 ~/.claude/plugins/，設了 CLAUDE_CONFIG_DIR 或 CLAUDE_CODE_PLUGIN_CACHE_DIR 時跟著搬，只查一處。新的搜尋順序是依規則推得，還沒有實機跑過。CHANGELOG.md [5.14.4]；enhancement-integration.md § Level 2：外部 bmad-guide › 偵測；data-layer-architecture.md § 寫入規則
yolo 一次問多題只叫醒塔台一次（前幾題 --ask --no-pty-write、最後一題 --ask --submit）；重複通知只做最少的檢查，已升級給你的題不重複提醒v5.15.0>= 0.7.0-pre.7—最低 BAT 版本不變（同 --ask）。--ask --no-pty-write 只做畫面上的通知、不寫塔台的輸入框：BAT 0.7.0-pre.7 起就是這個行為，0.7.2-pre.4 起列為 BAT 的正式契約。helper 不認 --ask 或 --no-pty-write 時，那一題改走工單檔往返，一批仍只叫醒一次。同一版一併修正兩個原本就有的問題：多題等待的租約逐題計算；斷點 A 改看通知字串的結尾。Worker 與塔台都更新才完全生效，只更新一邊也相容。CHANGELOG.md [5.15.0]；yolo-mode.md § Worker 向塔台提問 › BAT 通道、§ Worker 端 3-A、§ 塔台端；yolo-mode.md § 斷點 A；yolo-mode.md § 相容性 › BAT / Worker 版本相容
方法論轉接（工單的規劃、執行、審查、驗證、交付各層交給方法論 adapter）；BUG／PLAN／EXP 預設開啟；*insights sessions、*insights tools；執行中補充工單v6.0.0>= 0.7.0-pre.7—MAJOR。BAT 介面同 v6.0.0-pre.1，最低 BAT 版本不變，沒有新門檻：方法論轉接在塔台與 Worker 這一側、執行中補充工單只靠 Worker 讀工單檔、token 統計與工具清單建議讀的是 Claude Code 留在本機的紀錄，都不經過新的 BAT 介面。沒有任何方法論設定時行為與 5.x 相同；BUG／PLAN／EXP 預設改開啟。Codex 用 plugin 安裝又接 BAT 派工，仍需要 BAT >= 0.7.2-pre.1。塔台與 Worker 要同一批升級：舊版 Worker 讀不到執行中補充段。CHANGELOG.md [6.0.0]；methodology-adapters.md；tower-config.md § 可用選項、§ 方法論設定鍵；work-order-system.md § 執行中補充工單；ct-insights/references/analysis-rules.md § Session 用量統計、§ 工具清單建議
塔台收單時補記 Worker 的 session id（工單 session_ids）v6.0.0>= 0.7.1-pre.1—用 BAT MCP bat_get_state 回傳的 claudeSessionId 補記。BAT 太舊或沒接上 BAT MCP 時跳過補記，收單照常。Worker 自己寫 session_ids 不需要 BAT。work-order-system.md § 收單補記 session id；ct-exec/SKILL.md § Phase 4 › Session id
Level 2：外部 bmad-guide 的 BMad workflow 路由v5.0.3——CT 不內嵌 BMad 內容，只偵測外部安裝的 bmad-guide（5.14.1 起手動安裝與 plugin 安裝都偵測得到；5.14.4 起先找塔台所在 runtime 的安裝，同一個 runtime 內並存時用手動那份）；沒裝就靜默改用手動填的 workflow 欄位，已安裝卻讀不到時先提示一次。bmad-guide 顯示 BMad-Method v6.10.0 或更新時，塔台路由改用 v6.10 的替代名稱（例如 bmad-investigate 已退役）。6.0.0 起 Level 2 改稱「方法論轉接」，由內建的 bmad adapter 承接，偵測順序與降級方式不變。Portal 內容以 bmad-guide v6.12.4 為準。enhancement-integration.md § Level 2：方法論轉接（methodology adapter）；adapters/bmad.yaml（6.0.0 起，偵測與 BMad v6.10 的替代名稱）；version-governance.md § 歷史版號表（v5.0.3、v5.14.1）

  • 帶前綴的工單 ID 走結構化派工（--workorder 帶前綴）

    CT 起始版本
    v5.0.6
    BAT 最低版本
    >= 0.5.9-pre.1
    codex
    —
    說明
    這個 BAT 版本出自 BAT 的 fork 版。舊 BAT：塔台單次降級為 --prompt 派工，並明示「已降級」與原因；不以錯誤訊息字串判斷版本。
    出處
    auto-session.md § 舊版 BAT 降級規則（帶前綴 --workorder）；yolo-mode.md § 相容性 › BAT / Worker 版本相容

  • 收單後回收 Worker 分頁（--close-worker、worker_auto_close）

    CT 起始版本
    v5.1.0
    BAT 最低版本
    >= 0.6.1-pre.4
    codex
    —
    說明
    舊 BAT 回 exit 1：一行警告，照常收單。worker_auto_close 預設 off，不受影響。pre.3 已有這個指令，但分頁剛有輸出會回 BUSY；等輸出安靜再關自 pre.4 起（CT v5.12.3 更正，原寫 0.6.1-pre.3）。
    出處
    CHANGELOG.md [5.1.0]、[5.12.3]；work-order-system.md § 收單後回收 Worker 分頁（worker_auto_close，v5.1.0+）；Guide bat-integration.md § 版本對照表

  • 塔台分頁角色宣告（--set-role tower）

    CT 起始版本
    v5.2.0
    BAT 最低版本
    >= 0.6.1-pre.6
    codex
    —
    說明
    更舊的 BAT 回 exit 1，視為不支援：面板記「不支援（BAT 太舊）」，塔台照常啟動。
    出處
    auto-session.md § 依賴的 BAT 基礎設施、§ 塔台分頁角色宣告（--set-role tower，v5.2.0+）

  • 每分頁範圍權杖與分頁角色權限

    CT 起始版本
    v5.2.4
    BAT 最低版本
    >= 0.7.0-pre.1
    codex
    —
    說明
    BAT_REMOTE_TOKEN 改成分頁專屬：Worker 分頁只能通知綁定的塔台，不能派工。舊 BAT 沒有角色限制，行為與 v5.2.3 相同。
    出處
    auto-session.md § 依賴的 BAT 基礎設施、§ 範圍權杖與分頁角色

  • worktree 隔離派工（--isolation worktree、CT_HOME 等 CT_* 變數）與合併工單

    CT 起始版本
    v5.3.0
    BAT 最低版本
    >= 0.7.0-pre.2
    codex
    —
    說明
    選用。舊 BAT 上隔離工單回 exit 1 時停下等使用者，不自動改成非隔離；非隔離工單不受影響。
    出處
    auto-session.md § 依賴的 BAT 基礎設施、§ worktree 隔離派工（--isolation worktree，v5.3.0+）

  • 隔離工單回收（--worktree keep／remove）與 --worktree-status

    CT 起始版本
    v5.3.0
    BAT 最低版本
    >= 0.7.0-pre.2
    codex
    —
    說明
    --worktree-status 失敗時，改用 git 計算直接合併的判準。
    出處
    auto-session.md § 依賴的 BAT 基礎設施；Guide bat-integration.md § 版本對照表

  • BAT MCP 唯讀 tool（mcp__bat__*）

    CT 起始版本
    v5.3.0
    BAT 最低版本
    >= 0.7.0-pre.2
    codex
    —
    說明
    選用通道，目前沒有任何 CT 規則必須用它；沒有這組 tool 就直接走 helper 或讀檔案。BAT README 另註 Codex 分頁要 >= 0.7.0-pre.3。
    出處
    auto-session.md § 依賴的 BAT 基礎設施、§ BAT MCP 唯讀 tool（選用通道，v5.3.0+）

  • Worker 分頁回收後仍可查 --worktree-status（回傳帶 source）

    CT 起始版本
    v5.4.0
    BAT 最低版本
    >= 0.7.0-pre.4
    codex
    —
    說明
    成功回傳沒有 source 時，照舊在回收分頁之前查；回收後查不到（exit 3）就改用 git。
    出處
    auto-session.md § 依賴的 BAT 基礎設施；Guide bat-integration.md § 版本對照表

  • yolo 提問通道（Worker 送「T#### 提問」，在工單檔往返）

    CT 起始版本
    v5.5.0
    BAT 最低版本
    —
    codex
    —
    說明
    沒有新的 BAT 門檻，只用工單檔與 bat-notify.mjs。舊 Worker 不會提問，行為不變。
    出處
    yolo-mode.md § Worker 向塔台提問（v5.5.0+）、§ 相容性 › BAT / Worker 版本相容

  • 斷點 D：查到 Worker 在等人（MCP 回報 blocked）

    CT 起始版本
    v5.5.0
    BAT 最低版本
    >= 0.7.0-pre.4
    codex
    —
    說明
    回傳沒有 blockedDetection 或 MCP 不可用時，斷點 D 不啟用，流程照常。
    出處
    yolo-mode.md § 斷點 D：Worker 等待使用者（v5.5.0+）、§ 相容性 › BAT / Worker 版本相容

  • blockedReason 準確（AskUserQuestion 回報 question、回答後立即清除）

    CT 起始版本
    v5.5.1
    BAT 最低版本
    >= 0.7.0-pre.5
    codex
    —
    說明
    0.7.0-pre.4 把提問報成 permission；CT 照原值顯示、措辭中性，邏輯相同。
    出處
    yolo-mode.md § 相容性 › BAT / Worker 版本相容；Guide bat-integration.md § 版本對照表

  • Worker 啟動確認（--wait-started、exit 8、MCP agentStarted）

    CT 起始版本
    v5.6.0
    BAT 最低版本
    >= 0.7.0-pre.6
    codex
    —
    說明
    舊 helper 回 exit 1 加 Unknown option '--wait-started'（沒有建立分頁）時，去掉參數重派一次，本 session 之後不再帶。exit 8 表示分頁已建立，不重派。
    出處
    auto-session.md § 依賴的 BAT 基礎設施、§ Worker 啟動確認（--wait-started，v5.6.0+）

  • yolo 提問走 BAT 結構化通道（--ask、--answer、bat_wait_question、bat_list_questions、blockedReason: tower）

    CT 起始版本
    v5.7.0
    BAT 最低版本
    >= 0.7.0-pre.7
    codex
    —
    說明
    題目仍先寫進工單（雙寫）。--ask 失敗、tool 不存在或沒有 pendingQuestions 時，回到工單檔往返，行為同 v5.6.1。
    出處
    auto-session.md § 依賴的 BAT 基礎設施；yolo-mode.md § Worker 向塔台提問 › BAT 通道（v5.7.0+）

  • codex 分頁的 OSC 7501（blockedDetection: osc、blockedReason: input，--wait-started 對 codex 生效）

    CT 起始版本
    v5.8.0
    BAT 最低版本
    >= 0.7.0-pre.9
    codex
    >= 0.163.0
    說明
    舊 BAT（≤ 0.7.0-pre.8）或較舊的 codex：blockedDetection: none、agentStarted: null、started: unknown，行為同 v5.7.2。
    出處
    auto-session.md § 依賴的 BAT 基礎設施；yolo-mode.md § 相容性 › BAT / Worker 版本相容

  • 跨 session 選收件人（ListAgents 的「<工作區> · Tower」、claudeSessionName、bat_list_terminals scope: towers）

    CT 起始版本
    v5.9.0
    BAT 最低版本
    >= 0.7.1-pre.1
    codex
    —
    說明
    舊 BAT（≤ 0.7.0-pre.9）沒有分頁名稱與這兩個鍵，scope: towers 回 INVALID_ARGS；改請使用者轉交回覆稿，行為同 v5.8.1。
    出處
    auto-session.md § 依賴的 BAT 基礎設施；cross-project-coordination.md § 跨 session 選收件人（v5.9.0+）

  • 同一張工單重派前，先回收舊 Worker 分頁（沿用 --close-worker，--delay-ms 0）

    CT 起始版本
    v5.12.0
    BAT 最低版本
    >= 0.6.1-pre.4
    codex
    —
    說明
    沒有新的 BAT 門檻，與 v5.1.0 相同。舊 BAT 回 exit 1：一行提示後照常派工，本 session 不再嘗試。
    出處
    CHANGELOG.md [5.12.3]；work-order-system.md § 重派前回收舊 Worker 分頁（v5.12.0+）；Guide bat-integration.md § 版本對照表

  • BAT 指揮塔總覽顯示下一個編號與待辦（塔台寫 _tower-state.md 的機器可讀摘要）

    CT 起始版本
    v5.13.0
    BAT 最低版本
    >= 0.7.1-pre.7
    codex
    —
    說明
    這個 BAT 版本是預覽版。更舊的 BAT 不讀摘要，總覽只是少這兩項。舊專案沒有摘要不算錯，塔台下次寫 _tower-state.md 時補上。沒有新的 CT 最低 BAT 版本。
    出處
    CHANGELOG.md [5.13.0]；memory-protocol.md § 機器可讀摘要（YAML frontmatter）、§ BAT 塔台面板讀取契約

  • BAT 指揮塔面板讀不到檔時顯示「無法讀取」，索引只寫 critical 也算 High（讀取契約對照的 BAT 版本）

    CT 起始版本
    v5.13.1
    BAT 最低版本
    >= 0.7.1-pre.9
    codex
    —
    說明
    這個 BAT 版本是預覽版。CT 寫檔不分 BAT 版本：400 KB 預算保留，索引照舊寫 🔴 High（critical）；更舊的 BAT 超過 512 KiB 仍靜默變空。沒有新的 CT 最低 BAT 版本。
    出處
    CHANGELOG.md [5.13.1]；memory-protocol.md § BAT 塔台面板讀取契約

  • plugin marketplace 安裝（Claude Code、Codex）；Codex 搭配 BAT 派工用 zip 手動安裝

    CT 起始版本
    v5.14.0
    BAT 最低版本
    —
    codex
    —
    說明
    BAT 介面與最低 BAT 版本不變。BAT 對 Codex 送不帶前綴的 $ct-exec，plugin 版在 Codex 只能用 $ct:ct-exec 呼叫，所以接 BAT 派工的 Codex 用 zip 手動安裝；Claude Code 用 plugin 不受影響。beta 不上架。v5.14.2 起改成依 BAT 版本，見 v5.14.2 列。
    出處
    CHANGELOG.md [5.14.0]；version-governance.md § plugin 安裝／升級；auto-session.md § 依安裝方式的 skill 呼叫字串

  • Level 2 偵測得到 plugin 安裝的 bmad-guide；塔台端派工與回收範本用完整工單 ID

    CT 起始版本
    v5.14.1
    BAT 最低版本
    —
    codex
    —
    說明
    BAT 介面、派工命令的參數與順序、最低 BAT 版本都不變。塔台依序找手動安裝、Claude Code plugin、Codex plugin，並存時用手動那份；已安裝卻讀不到時提示一次。CT 5.14.0 與 6.0.0-beta.5 以前的 beta 只查 skills/ 目錄，搭配它們時 bmad-guide 仍建議用 zip 手動安裝；6.0.0-beta.6 起 adapter 也偵測得到（beta.7 實機驗證過）。v5.14.4 起改成依 runtime 分開，見 v5.14.4 列。
    出處
    CHANGELOG.md [5.14.1]；enhancement-integration.md § Level 2：外部 bmad-guide › 偵測；auto-session.md § 執行方式

  • Codex 用 plugin 安裝也能接 BAT 派工（BAT 依 Codex 端的安裝方式送 $ct-exec 或 $ct:ct-exec）

    CT 起始版本
    v5.14.2
    BAT 最低版本
    >= 0.7.2-pre.1
    codex
    —
    說明
    這個 BAT 版本是預覽版。只有「Codex 用 plugin 安裝又要接 BAT 派工」需要它；Codex 用 zip 手動安裝、或只用 Claude Code 的，BAT 不必升級。兩種都裝時 BAT 送手動那份，所以從 zip 改用 plugin 照樣要先移除手動安裝。更舊的 BAT 一律送 $ct-exec，接它派工的 Codex 用 zip 手動安裝。CT 派工命令不變；端到端派工尚未實機驗證。
    出處
    CHANGELOG.md [5.14.2]；auto-session.md § 依安裝方式的 skill 呼叫字串、§ 依賴的 BAT 基礎設施；version-governance.md § plugin 安裝／升級

  • 一個塔台管多個巢狀的獨立 repo（工單集中在上層、Worker 在上層執行、子 repo 用 git -C commit）

    CT 起始版本
    v5.14.3
    BAT 最低版本
    —
    codex
    —
    說明
    文件配置，不是新規則：落點檢查、commit 規則、派工命令、BAT 介面與最低 BAT 版本都不變，CT 5.14.2 起就能這樣用。不能用 worktree 隔離；C-0 只驗上層。實機驗證用 CT 5.14.2 搭配 BAT 0.7.2-pre.1；面板一鍵派工與子 repo 有 remote 時的 push 尚未實機驗證。
    出處
    CHANGELOG.md [5.14.3]；mono-repo-patterns.md § 巢狀的獨立 repo（一個塔台、多個共用 repo）；multi-tower-protocol.md § 決策：一個塔台還是多個

  • Level 2 找 bmad-guide 時先找塔台所在 runtime 的安裝；Claude Code 的 plugin 位置只算一處

    CT 起始版本
    v5.14.4
    BAT 最低版本
    —
    codex
    —
    說明
    規則修正，沒有新門檻：BAT 介面、派工命令、最低 BAT 版本都不變。順序是本 runtime 的手動安裝 → 本 runtime 的 plugin → 另一個 runtime 的安裝（只拿來讀檔，第一次用到時註明一次）；手動優先只在同一個 runtime 內成立。Claude Code 的 plugin 預設在 ~/.claude/plugins/，設了 CLAUDE_CONFIG_DIR 或 CLAUDE_CODE_PLUGIN_CACHE_DIR 時跟著搬，只查一處。新的搜尋順序是依規則推得，還沒有實機跑過。
    出處
    CHANGELOG.md [5.14.4]；enhancement-integration.md § Level 2：外部 bmad-guide › 偵測；data-layer-architecture.md § 寫入規則

  • yolo 一次問多題只叫醒塔台一次（前幾題 --ask --no-pty-write、最後一題 --ask --submit）；重複通知只做最少的檢查，已升級給你的題不重複提醒

    CT 起始版本
    v5.15.0
    BAT 最低版本
    >= 0.7.0-pre.7
    codex
    —
    說明
    最低 BAT 版本不變（同 --ask）。--ask --no-pty-write 只做畫面上的通知、不寫塔台的輸入框：BAT 0.7.0-pre.7 起就是這個行為，0.7.2-pre.4 起列為 BAT 的正式契約。helper 不認 --ask 或 --no-pty-write 時，那一題改走工單檔往返，一批仍只叫醒一次。同一版一併修正兩個原本就有的問題：多題等待的租約逐題計算；斷點 A 改看通知字串的結尾。Worker 與塔台都更新才完全生效，只更新一邊也相容。
    出處
    CHANGELOG.md [5.15.0]；yolo-mode.md § Worker 向塔台提問 › BAT 通道、§ Worker 端 3-A、§ 塔台端；yolo-mode.md § 斷點 A；yolo-mode.md § 相容性 › BAT / Worker 版本相容

  • 方法論轉接（工單的規劃、執行、審查、驗證、交付各層交給方法論 adapter）；BUG／PLAN／EXP 預設開啟；*insights sessions、*insights tools；執行中補充工單

    CT 起始版本
    v6.0.0
    BAT 最低版本
    >= 0.7.0-pre.7
    codex
    —
    說明
    MAJOR。BAT 介面同 v6.0.0-pre.1，最低 BAT 版本不變，沒有新門檻：方法論轉接在塔台與 Worker 這一側、執行中補充工單只靠 Worker 讀工單檔、token 統計與工具清單建議讀的是 Claude Code 留在本機的紀錄，都不經過新的 BAT 介面。沒有任何方法論設定時行為與 5.x 相同；BUG／PLAN／EXP 預設改開啟。Codex 用 plugin 安裝又接 BAT 派工，仍需要 BAT >= 0.7.2-pre.1。塔台與 Worker 要同一批升級：舊版 Worker 讀不到執行中補充段。
    出處
    CHANGELOG.md [6.0.0]；methodology-adapters.md；tower-config.md § 可用選項、§ 方法論設定鍵；work-order-system.md § 執行中補充工單；ct-insights/references/analysis-rules.md § Session 用量統計、§ 工具清單建議

  • 塔台收單時補記 Worker 的 session id（工單 session_ids）

    CT 起始版本
    v6.0.0
    BAT 最低版本
    >= 0.7.1-pre.1
    codex
    —
    說明
    用 BAT MCP bat_get_state 回傳的 claudeSessionId 補記。BAT 太舊或沒接上 BAT MCP 時跳過補記，收單照常。Worker 自己寫 session_ids 不需要 BAT。
    出處
    work-order-system.md § 收單補記 session id；ct-exec/SKILL.md § Phase 4 › Session id

  • Level 2：外部 bmad-guide 的 BMad workflow 路由

    CT 起始版本
    v5.0.3
    BAT 最低版本
    —
    codex
    —
    說明
    CT 不內嵌 BMad 內容，只偵測外部安裝的 bmad-guide（5.14.1 起手動安裝與 plugin 安裝都偵測得到；5.14.4 起先找塔台所在 runtime 的安裝，同一個 runtime 內並存時用手動那份）；沒裝就靜默改用手動填的 workflow 欄位，已安裝卻讀不到時先提示一次。bmad-guide 顯示 BMad-Method v6.10.0 或更新時，塔台路由改用 v6.10 的替代名稱（例如 bmad-investigate 已退役）。6.0.0 起 Level 2 改稱「方法論轉接」，由內建的 bmad adapter 承接，偵測順序與降級方式不變。Portal 內容以 bmad-guide v6.12.4 為準。
    出處
    enhancement-integration.md § Level 2：方法論轉接（methodology adapter）；adapters/bmad.yaml（6.0.0 起，偵測與 BMad v6.10 的替代名稱）；version-governance.md § 歷史版號表（v5.0.3、v5.14.1）

資料對應 CT v6.0.0；「—」表示不需要。

codex ​

只有一項功能另外需要 codex 的版本：v5.8.0 起，BAT 用 OSC 7501 判斷 codex 分頁「在等人回答」與「已啟動」，需要 codex >= 0.163.0（加上 BAT >= 0.7.0-pre.9）。版本不夠時，codex Worker 的狀態一律是「無法判斷」：斷點 D 不會因為 codex 在等人而觸發，啟動確認回 started: unknown。其他功能在 Claude Code 與 Codex 上的行為相同，差別只在指令前綴（/ 與 $）。

bmad-guide ​

CT 不內嵌 BMad-Method 的內容。需要 BMad 的 workflow 路由時，塔台去讀另外安裝的 bmad-guide skill；沒裝就靜默改用工單裡手動填的 workflow 欄位，不擋住塔台；CT 5.14.1 起，可用 skill 清單裡有 bmad-guide 卻讀不到檔案時，先提示你一次再改用手動欄位。6.0.0 起這件事由方法論轉接的內建 bmad adapter 承接（Level 2 改稱「方法論轉接」，見功能總覽 › 方法論轉接），偵測順序與降級方式不變。

  • bmad-guide 顯示 BMad-Method v6.10.0 或更新時，塔台改用 v6.10 起的替代名稱，例如 bmad-investigate 已退役、改開 CT 研究型工單或一般調查，bmad-automator 改建議 bmad-loop。
  • 版本低於任務需要時，塔台只顯示升級提示，不阻塞。
  • bmad-guide 用 plugin marketplace 安裝（bmad-guide@control-tower）時，CT 5.14.1 起塔台偵測得到。CT 5.14.4 起先找塔台所在 agent（Claude Code 或 Codex）自己的安裝：這個 agent 的手動安裝 → 這個 agent 的 plugin → 另一個 agent 的安裝（只拿來讀檔，第一次用到時註明一次）；同一個 agent 裡兩種並存時用手動那份。CT 5.14.0 與 6.0.0-beta.5 以前的 beta 只查 skills/ 目錄，搭配它們時仍建議用 zip 手動安裝（6.0.0-beta.6 起 adapter 也偵測得到，beta.7 實機驗證過），見 BMad Guide Skill › 用 plugin 安裝。
  • Portal 的內容以 bmad-guide v6.12.4 為準。

BAT 太舊時會怎樣 ​

大多數情況只是「那個功能不啟用」：

  • 回收 Worker 分頁失敗：一行警告，照常收單或派工。
  • 啟動確認的參數不被接受：去掉參數重派一次，本 session 之後不再帶。
  • BAT 提問通道不可用：回到工單檔往返，題目本來就已經寫在工單裡。
  • 查詢通道不可用：改走 helper、讀檔案或用 git 計算。

只有一個例外會停下來等你：隔離工單（--isolation worktree）在舊 BAT 上回 exit 1 時，塔台不會自動改成非隔離派工，而是停下等你決定；非隔離的工單不受影響。

BAT_HELPER_NODE 沒有版本門檻：本機沒有這個變數就用 node，只有遠端分頁才由 BAT 注入。

和 BAT 站的對照 ​

BAT 站也有一張相容表，是從 BAT 的角度列（BAT 站：相容版本）。兩張表的最低版本一致。「收單後回收 Worker 分頁」與沿用它的「重派前回收」兩端都是 >= 0.6.1-pre.4：CT 原本寫 0.6.1-pre.3，v5.12.3 依 BAT 的相容表更正（pre.3 已有這個指令，但分頁剛有輸出會回 BUSY；等輸出安靜再關自 pre.4 起，見 CT CHANGELOG [5.12.3]）。

預發行（Beta、RC） ​

上面的表格只列正式版。CT 6.0.0 是正式版，已列入表格；v6 的 Beta 與 RC（v6.0.0-pre.1～v6.0.0-rc.1）是預發行，內容都已納入 6.0.0。下面保留預發行期間各版的 BAT 對照作為歷史參考，各版的內容與當時的下載見「實驗功能」的方法論轉接。

BAT 指揮塔總覽讀塔台狀態摘要的版本需求如下；v5.13.0 起穩定版也寫同一份摘要（上表也列了這一項）：

功能BATCT
總覽顯示最後更新與進行中工單>= 0.7.1-pre.7（預覽版）不限版本（BAT 直接讀工單檔）
總覽顯示下一個編號與待辦>= 0.7.1-pre.7（預覽版）穩定版 >= v5.13.0（含 6.0.0）；v6 預覽版 >= v6.0.0-pre.1（含 Beta v6.0.0-beta.1～v6.0.0-beta.12 與 RC v6.0.0-rc.1）。塔台寫出 _tower-state.md 的機器可讀摘要

CT 版本不夠時，總覽只是少了這兩項，其他照常顯示。方法論轉接本身沒有改變 BAT 介面，也沒有提高 CT 要求的最低 BAT 版本；beta.1～beta.12 與 rc.1 的 BAT 介面與最低 BAT 版本都和 v6.0.0-pre.1 相同；beta.2 改的環境偵測寫法（bash 用 compgen -e 只列名稱）是 CT 這一側的指令寫法，不需要新的 BAT 版本。

beta.3 新增 BAT 塔台面板讀取契約：CT 寫的決策日誌、BUG／PLAN 索引、塔台狀態等檔案要長什麼樣、多大以內，BAT 指揮塔面板才讀得到（見 BAT 塔台面板為什麼會空）。契約對照 BAT 0.7.1-pre.8（預覽版）寫成，規範的是 CT 寫檔的格式與大小，不是新的最低 BAT 版本；穩定版 v5.13.0 起也有同一份契約，v5.13.1 把穩定版契約的對照版本改成 BAT 0.7.1-pre.9（讀不到時顯示「無法讀取」），一樣沒有提高最低 BAT 版本。

beta.4 的 BAT 介面同 beta.3；面板讀取契約改成對照 BAT 0.7.1-pre.9（預覽版）：pre.9 起讀不到檔時顯示「無法讀取」、critical 在任何讀取路徑都算 High，更舊的 BAT 照舊靜默變空，所以 400 KB 預算保留。這和穩定版 v5.13.1 是同一份契約，同樣不是新的最低 BAT 版本。beta.4 另把通知改成用完整工單 ID（設了前綴就含前綴），這是 CT 這一側的寫法，派工命令與 BAT 介面不變，不需要新的 BAT 版本。

beta.5 的 BAT 介面同 beta.4：移植的是穩定版 v5.14.0 的 plugin 安裝就緒規則，派工命令、斷點 A 的判定格式與最低 BAT 版本都不變，不需要新的 BAT 版本。BAT 對 Codex 派工送的是 $ct-exec，plugin 版的 Codex 叫不到，所以接 BAT 派工的 Codex 用 zip 手動安裝；Beta 本來就只提供 zip、沒有 plugin，不受影響。

beta.6 的 BAT 介面同 beta.5：移植的是穩定版 v5.14.1、v5.14.2 的規則，派工命令、斷點 A 的判定格式與 CT 要求的最低 BAT 版本都不變。其中 Codex 搭配 BAT 派工改成依 BAT 版本：BAT >= 0.7.2-pre.1 依 Codex 端的安裝方式送 $ct-exec 或 $ct:ct-exec，zip 與 plugin 都能接派工；更舊的 BAT 一律送 $ct-exec，只有 zip 手動安裝叫得到。Codex 用 plugin 接 BAT 派工才需要 BAT >= 0.7.2-pre.1；Beta 本身只提供 zip，只有同一台機器另裝穩定版的 CT plugin 時才相關，這條端到端流程還沒實機驗證。

beta.7 的 BAT 介面同 beta.6：移植的是穩定版 v5.14.3 的「一個塔台、多個巢狀的獨立 repo」配置文件，派工命令、斷點 A 的判定格式與 CT 要求的最低 BAT 版本都不變，沒有新的版本門檻。這個配置用穩定版 CT 5.14.2 搭配 BAT 0.7.2-pre.1 實機驗證過；它要另開一個指向上層的 BAT workspace，面板一鍵派工還沒實機驗證（Beta 已知未驗第 20 項，beta.8 起改編為第 18 項；穩定版 v5.14.3 同樣還沒驗）。

beta.8 的 BAT 介面同 beta.7：移植的是穩定版 v5.14.4 的「找方法論 skill 依 runtime 分開、Claude plugin 位置只有一處」，並讓方法論 adapter 的 probe 可以標選填的 runtime；這些都是塔台這一側找檔的規則，派工命令、斷點 A 的判定格式與 CT 要求的最低 BAT 版本都不變，沒有新的版本門檻。

beta.9 的 BAT 介面同 beta.8：移植的是穩定版 v5.15.0 的「一次問多題時塔台只被叫醒一次」、同一批重複通知的最少檢查、逐題計算的等待租約與「斷點 A 看字串結尾」。派工命令與 CT 要求的最低 BAT 版本都不變，沒有新的版本門檻：--ask 仍需要 BAT >= 0.7.0-pre.7；前幾題用的 --ask --no-pty-write 從 0.7.0-pre.7 起就是這個行為，BAT 0.7.2-pre.4 起列為正式契約（最後一題送不上時，0.7.2-pre.4 起另印一行 ask: NOTIFY_STEP，可選用、不得依賴）。斷點 A 的關鍵字與工單 ID 格式也不變，只改成看字串結尾。穩定版 v5.15.0 是同一套規則（見上表）。

beta.10 的 BAT 介面同 beta.9：新增的 token 用量統計讀的是 Claude Code 留在本機的 session 紀錄，派工命令、斷點 A 的判定格式與 CT 要求的最低 BAT 版本都不變，沒有新的版本門檻。塔台收單時補記 Worker 的 session id，用的是 BAT MCP bat_get_state 回傳的 claudeSessionId，需要 BAT >= 0.7.1-pre.1 並接上 BAT MCP；沒有就跳過補記，收單照常。另一條是寫法規則：在 BAT 下啟動 Claude 時，啟動參數不得放 --settings，否則 BAT 不注入 hooks，blocked 偵測、--wait-started 與 session id 回報會同時失效；要換 skill 組合改用專案的 .claude/settings*.json。helper 輸出 question: 等行的行首兩個空白是 BAT 既有的輸出，CT 只是寫明解析要容許，不需要新的 BAT 版本。這些都只在 v6，穩定版 v5.15.0 沒有。

beta.11 的 BAT 介面同 beta.10：執行中補充工單只靠 Worker 讀工單檔，不要求 BAT 開放寫入 Worker 分頁；派工命令、斷點 A 的判定格式與 CT 要求的最低 BAT 版本都不變，沒有新的版本門檻。選用的跨 session 提醒只限 Claude Code 塔台＋BAT 派出的 Claude Code Worker（BAT >= 0.7.1-pre.1）：塔台用 ListAgents 與 BAT MCP bat_list_terminals（scope: mine）的 claudeSessionName 找自己的 Worker，找不到（例如 Codex Worker）就不送，靠 Worker 的節點檢查。BAT >= 0.7.3-pre.8 起，塔台停在權限對話框或等你回答問題時，Worker 的通知會延後送進塔台輸入框，塔台縮圖顯示「待送通知 N」，不會替你按 Enter；CT 的判讀規則不變。帶 --settings 啟動的分頁不保留這類通知（BAT >= 0.7.2-pre.8 起這類分頁也不會出現工作區的「等待你回應」⚠️，這是在 BAT 下不放 --settings 的第二個理由）；每個塔台最多 8 筆，第 9 筆照現有的通知失敗處理；遠端 bat-server 也要升到同版。這些都是文件補註，不升 BAT 照舊可用；只在 v6，穩定版 v5.15.0 沒有。

beta.12 的 BAT 介面同 beta.11：新增的工具清單建議 *insights tools 只讀 Claude Code 留在本機的 session 紀錄與設定檔，不經過 BAT；派工命令、斷點 A 的判定格式與 CT 要求的最低 BAT 版本都不變，沒有新的版本門檻。報告給的套用建議照舊不在 BAT 的 Claude 啟動參數放 --settings，改用專案的 .claude/settings*.json；套用與否由你決定，改完開新 session 才生效。只在 v6，穩定版 v5.15.0 沒有。

rc.1（RC，正式版候選）的 BAT 介面同 beta.12：本版只有修正（Worker 塔台補充檢查的寫法與文件），不經過 BAT；派工命令、斷點 A 的判定格式與 CT 要求的最低 BAT 版本都不變，沒有新的版本門檻。

beta.1 改成 BUG／PLAN／EXP 預設開啟，啟用時立即產生 _bug-tracker.md、_backlog.md，BAT 指揮塔面板的「臭蟲」與「待辦池」因此不必等第一次 *sync 就有檔可讀；這不需要新的 BAT 版本。

延伸閱讀 ​

  • CT auto-session.md § BAT 內部終端路由（Better Agent Terminal）› 依賴的 BAT 基礎設施、§ 舊版 BAT 降級規則（帶前綴 --workorder）
  • CT yolo-mode.md § 相容性 › BAT / Worker 版本相容
  • CT version-governance.md § 歷史版號表、§ 相容性注意
  • CT enhancement-integration.md § Level 2：方法論轉接（methodology adapter）
  • Guide references/bat-integration.md § 版本對照表

Portal 是摘要，不具權威；與 CT reference 有出入時，以 reference 為準。