v5.7.21～v5.7.22：Workflow Quality Gates 與狀態輸出修復 · Oh My ClaudeCode

概述

本輪涵蓋兩個 release：v5.7.21（2026-10-30 01:48 UTC）與 v5.7.22（2026-10-30 19:59 UTC）。v5.7.21 官方主題「Clearer state output and restored team missions」——三個 bug fixes 加同步／CI 變更（官方統計：8 PRs merged、0 new features、4 bug fixes、4 other changes）；v5.7.22 官方主題「Configurable quality gates for workflow stages」——本輪唯一的新功能主軸（官方統計：4 PRs merged、1 new feature、1 quality-gate safety improvement、2 other changes）。

v5.7.21：狀態輸出與 team missions 修復

state_clear 診斷輸出有界化（#4654，修 #4651，@conarti 回報）：state_clear 的 missing-state 路徑輸出限制於請求的 session，或以 and N more 計數為檢查路徑封頂。
移除無效 agent frontmatter（#4657，修 #4656，@fvegiard 回報）：刪除未識別的頂層 level frontmatter key，消除 Claude Code 啟動警告。
team missions 顯示恢復（#4661、#4662，@iyoda）：沒有 session mission snapshot 時仍顯示 team missions，並在該 team-only 檢視中讓已完成的 missions 過期。
其他：把 main 的 v5.7.20 release 併回 dev（#4658），並授權／刷新該 sync PR 的生成 artifacts（#4659、#4660、#4663）。

v5.7.22：可設定的 workflow quality gates

這是本輪的重點新功能（#4670，port 自 oh-my-codex#3956，對應 issue #3955；由 @iqdoctor 要求、@iyoda 實作）。

涵蓋範圍：為 deep-interview、ralplan、review 三個工作流階段 (workflow stages) 設定自訂 gates。
兩種語意：gates 分為 blocking（阻擋式）與 advisory（建議式）兩種。
設定位置：user 或 project 的 OMC config。
檢視指令：omc quality-gates list 檢視 gate 設定。

v5.7.22：gate 安全防護

同一版也修了 gate 的自我防護（#4671，@iyoda）：

拒絕自我遞迴：stage 不能以自己的 controller skill 作為 gate——防止自己審自己。
未設定即 no-op：沒有設定 gates 的 stages 維持 strict no-ops，跳過 gate lookup 與 prompt-spec 工作。

既有使用者影響

state_clear 的診斷輸出不再無界傾印；Claude Code 啟動時不再因 agent frontmatter 的 level key 出現警告。
team missions 在沒有 session mission snapshot 時不會再漏掉；已完成的 missions 會在該 team-only 檢視中過期。
使用 deep-interview／ralplan／review 的工作流，現在可以在 user 或 project OMC config 設定 blocking／advisory gates，並用 omc quality-gates list 檢視；不設定的 stage 行為不變（strict no-op）。
npm 更新：npm install -g [email protected]；Claude Code plugin 走 /plugin marketplace update omc——兩條獨立安裝軌道，用哪條就更新哪條、兩者都裝就都更新；依賴 CLI 的 skill 路徑（如 ask 與 CLI-backed team）需要 omc CLI。

隨堂測驗

v5.7.22 的 quality-gate 安全防護（#4671）處理了哪兩個問題？

💡 想先看個提示？

一個是「誰來審」，一個是「沒設定時要不要做事」。

動手升級檢查清單

升級 v5.7.22：動手檢查清單

逐項勾選，確認你已完成升級必要的步驟（進度會保存在此瀏覽器）

0 / 6

（看 state_clear 診斷輸出）確認輸出限於請求的 session 或以 and N more 封頂v5.7.21 #4654 修 #4651
（啟動 Claude Code）確認不再出現 agent frontmatter level key 警告v5.7.21 #4657 修 #4656，移除未識別的頂層 level key
（沒有 session mission snapshot 時）確認 team missions 仍會顯示v5.7.21 #4661、#4662：team-only 檢視並讓已完成 missions 過期
（用 deep-interview／ralplan／review）評估是否在 user 或 project OMC config 設定 gatesv5.7.22 #4670：blocking／advisory 兩種；port 自 oh-my-codex#3956
（設定 gates 後）用 omc quality-gates list 檢視 gate 設定v5.7.22 #4670 提供的檢視指令
（不設定 gates 的 stage）確認行為不變v5.7.22 #4671：strict no-op，跳過 gate lookup 與 prompt-spec 工作