jt-flow-onelisted

## Input 一個 Linear issue：使用者貼 identifier（如 `ENG-123`）、連結，或直接描述需求。 issue 是需求、範圍與驗收標準的唯一來源；不另建平行規劃文件。 ## 授權契約 **使用者指向一個 Linear issue 並要求交付，即授權走完整條鏈**：釐清、備妥 worktree、 實作、commit、push、開 PR、處理 review findings、merge、部署驗收、回寫 Linear。 不逐項確認、不重複要求授權，也不把驗證 gate 誤當成使用者核准 gate。 途中只有這些情況才停下來問： - 依 issue、codebase 與現有證據仍無法排除目標或預期行為的真實歧義 - 需要超出 issue 範圍的重大架構變更、新外部依賴或新 production 風險 - 發現 secret、credential 或其他不該外傳的敏感資料 - 缺少必要 credential／permission，或平台強制人工核准 - 不可逆或破壞性的 production mutation - rollback 涉及 DB／schema／資料遺失風險，或找不到明確安全的回復目標 - 前提與預期不符，繼續下去會破壞既有工作或空轉：工作樹有別人未提交的變更、 沿用的分支上有未合併也查不到已合併 PR 的 commit、 remote 解析不唯一、必要的外部管道因**存取或設定問題**（未安裝、未登入、 權限不符）而不可用。⚠️ 服務端的額度用盡或暫時中斷**不屬於**這一類——那是 記錄後繼續，不是停下 其餘一律走封閉迴圈：**遇到阻塞 → 查資料 → 分析根因 → 修正 → 繼續**。終止條件是 目標達成，不是「問題已釐清」。把診斷寫清楚然後停下來問「要 A 還是 B」，是把使用者 當成排程器；多數時候那個選擇有足夠證據可以自己做。 ⚠️ 特別警惕「環境問題」這個標籤——它最常被用來合理化停止追查。判定之前先問：這一步 的目的是什麼？有沒有繞過壞掉那部分的路徑？這一步真的需要那個壞掉的東西嗎？環境類 修正優先用 env var、臨時設定檔、單次指令參數，不動全域設定。 外部系統行為不確定時查文件，**多個角度平行查、不是查不到才換下一個**。手上若有 Context7／Exa／Firecrawl 就三個都用，它們強項不同：官方 API 參考／搜尋摘要與討論 串／整頁全文。交叉比對時區分「官方文件明說」與「社群經驗」，查不到就說查不到， 不用推理填空。 ## 工具選用 **本文件出現的工具名稱都是例子，不是清單。**每次執行實際可用的工具都不同——MCP 連線狀態、deferred tools、可用的 agent 型別都會變。動手前先看清楚這次手上有什麼， 需要時用 ToolSearch 查，再挑最適合這件事的那個。 兩個方向都要避免：因為文件只寫了某個工具，就不用其他更合適的；或因為文件寫的那個 沒裝，就停下來說做不到——換一個能達成同一目的的工具繼續。 **例外是流程明文指定的具名管道**（步驟 4 的 CodeRabbit 審查關卡、各步驟點名的 `superpowers:*` 方法論 skill）：那不是「做這件事的一種工具」，而是關卡或方法本身， 不能拿別的東西替代。它缺席時依該步驟自己的分流處理。 ## 前置檢查 1. **先判斷目前是否已經在專屬的 feature worktree 裡**——Claude Code 的 new session 可