Control Tower

外觀

版本總覽 ​

CT 與 CT Guide 永遠同一個版號，Portal 顯示的也是這一組。版號寫在每個 SKILL.md 內文的第一個註解裡，不放在 frontmatter。

目前版本 ​

BMad Control Tower
v6.0.0
CT Guide Skill
v6.0.0（與 CT 同版號）
發布日
2026-11-07
BMad Guide Skill
v6.12.4（跟 BMad-Method 同版號，2026-10-15 發布）
發行檔
BMad-Control-Tower-v6.0.0.zip、control-tower-guide-v6.0.0.zip、bmad-guide-v6.12.4.zip
已發布版本
72 版（依 CHANGELOG）

這組數字由同步腳本從 CT 的發行目錄讀出：CT 和 Guide 的版號不一致時，腳本會報錯並停止，不會寫出一組對不上的版本。每一版改了什麼見更版紀錄，九個世代的來龍去脈見演進史，各功能需要的 BAT 與 codex 版本見相容版本對照。

BMad Guide Skill 是例外：它的版號跟 BMad-Method 走，不跟 CT，所以不歸同步腳本管，版本資料另外讀 data/bmad-guide.json。為什麼這樣定、怎麼更新，見 BMad Guide Skill › 版本。

SemVer 慣例 ​

CT 採 Semantic Versioning，MAJOR.MINOR.PATCH：

CT 的 SemVer 慣例
觸發條件版號變動例子
不相容的工作流程或 metadata schema 變更MAJOR5.0.0：工單 metadata 的事實來源改成 YAML frontmatter
新命令、新設定、新的向下相容能力MINOR5.12.0：同一張工單重派前，先回收舊的 Worker 分頁
文件補完、BAT 規則修正、trigger 描述調整PATCH5.12.2：收單回收的提示文字改寫，行為不變

  • 不相容的工作流程或 metadata schema 變更

    版號變動
    MAJOR
    例子
    5.0.0：工單 metadata 的事實來源改成 YAML frontmatter

  • 新命令、新設定、新的向下相容能力

    版號變動
    MINOR
    例子
    5.12.0：同一張工單重派前，先回收舊的 Worker 分頁

  • 文件補完、BAT 規則修正、trigger 描述調整

    版號變動
    PATCH
    例子
    5.12.2：收單回收的提示文字改寫，行為不變

到目前為止，CHANGELOG 記錄的 72 個正式版本裡有兩次 MAJOR：5.0.0（工單 metadata 的事實來源改成 YAML frontmatter）與 6.0.0（方法論轉接；BUG／PLAN／EXP 預設改開啟、工單模板的方法論段落改名，沒有任何方法論設定時其他行為與 5.x 相同）。

版號寫在哪裡 ​

Skill 的 YAML frontmatter 只放執行時需要的欄位（至少 name 和 description），不放 version:。原因是 Codex 的 skill 驗證會把不認得的欄位當成錯誤。版號的事實來源改成內文的第一個註解：

markdown
<!-- control-tower-version: 6.0.0 -->

8 個 CT skill 各自有一行，名稱換成 skill 自己的（例如 ct-exec-version），Guide 是 control-tower-guide-version。同一個版號還會出現在幾個地方，發版時要一起改：

位置格式
內文註解<!-- control-tower-version: X.Y.Z -->
H1 或面板標題BMad Control Tower vX.Y.Z
塔台狀態檔 _tower-state.md 的 metadataControl Tower vX.Y.Z
Worker 相容性文件需要時在相關 reference 標明最低版本

*sync 或版本檢查要讀版號時，先讀內文註解，讀不到才退回標題；不會要求 frontmatter 有 version:。這套做法從 v5.0.3 開始，v5.0.2 以前的版本仍是寫在 frontmatter。

Guide 跟著 CT 同版號 ​

CT 每次發版（含 patch），同一輪都要出一版同號的 CT Guide Skill。Guide 內容不受影響時，至少要更新版號；內容受影響時，連教材一起對齊。發版時檢查兩邊版號，不一致就不算完成這一輪。

這條規則是在 CT v5.2.4 發版、Guide 卻停在 v5.2.3 之後訂下的（見實戰案例）。

Portal 跟著 CT 同步 ​

Portal 的版本資料也要在同一輪更新：

  • 每次發版（含 patch）：執行同步腳本，更新目前版本、從 CT 的 CHANGELOG 重新產生更版紀錄；相容性有變時，更新相容版本對照的資料檔。
  • 功能或規則有變時（MINOR，或改了規則的 PATCH）：一併更新受影響的功能頁、進階頁與指令參考大全，發版時列出受影響的 Portal 頁。
  • 進入新世代時：由塔台判斷，更新演進史。

收一輪發版時要對四處版號：Portal 的版本資料、CT SKILL.md 的版號註解、Guide 的版號，以及 plugin marketplace 裡 plugin 的版號（v5.14.0 起，ct = CT 版號、ct-guide = Guide 版號）。四處一致才算收完。同一個 marketplace 裡的 bmad-guide 版號跟 bmad-guide 走，在 bmad-guide 發版時對。

怎麼查本機裝了哪一版 ​

zip 手動安裝的，在 Claude Code 的安裝目錄下，把每個 skill 的版號註解列出來：

bash
grep -h -o "[a-z-]*-version: [0-9.]*" ~/.claude/skills/{control-tower,ct-*}/SKILL.md

8 行都應該是同一個版號（塔台和 Worker 必須同批升級）。Codex 端把 ~/.claude/skills 換成 ~/.codex/skills。兩端是各自獨立的安裝，升級其中一端不會更新另一端，要分別查。v5.0.2 以前的版本請改看 frontmatter 的 version:。

用 plugin 安裝的（v5.14.0 起），看 claude plugin list --json、codex plugin list --json 裡 ct@control-tower 的 version，見安裝：確認 plugin 版號。

升級的步驟（zip 手動安裝：備份、暫存複驗、替換、逐檔比對；plugin：交給 Agent CLI 更新）見安裝。新版從下一個 session 才生效，正在跑的 session 仍是舊規則。

延伸閱讀 ​

  • CT version-governance.md § 版號事實來源、§ SemVer 慣例、§ 歷史版號表、§ 相容性注意
  • CT 安裝與使用指南 § 4.1 安裝／升級（現行流程）：確認現行版號、Codex 端
  • CT CHANGELOG.md（72 個正式版本）

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