principle-outcome-oriented-execution | 以可驗證終態安排遷移
本頁以 pstack-claude 0.9.126 為基準。原文設定 user-invocable: false，通常由 poteto-mode 按需讀取。這是工作取捨原則，不是獨立執行指令。
定位與適用情境
適用於已規劃階段與驗證邊界的重寫或遷移。它要求優先抵達完整、可驗證的目標架構，而不是為了讓每個編輯瞬間都能運作，新增最後必須丟棄的相容程式。
例如團隊要把應用程式各處直接讀取環境變數的做法，改成啟動時建立一份設定物件。目標是所有呼叫端使用同一份已解析設定，缺少必要值時在啟動邊界失敗。這不是讓正式服務在遷移期間停擺的理由。
準備
- 提供目前的設定讀取位置、啟動入口、部署環境需求與既有測試。
- 寫下終態條件。業務模組不再直接讀環境變數，必要值缺漏時有明確錯誤。
- 指定隔離的工作分支、可回復基準與驗證環境。確認哪些工作區內的暫時失效可接受，正式環境則不可受影響。
操作步驟
- 列出舊讀取方式與所有消費者，將終態畫成「環境輸入、解析邊界、設定物件、呼叫端」的資料流。先排除仍需雙路支援的真實需求。
- 定義遷移區段與驗證邊界。例如解析器與呼叫端尚未接齊時，工作分支可暫時出現型別錯誤。記錄失效檢查、受影響檔案與回復點，不能把任意失敗都算進豁免。
- 在核准範圍內遷移呼叫端。持續執行正在改動區域的高訊號檢查，例如設定解析案例。不要只為過渡期新增永久回退到舊讀取方式的路徑。
- 在計畫結束時跑完整靜態檢查與執行期驗證。用有效設定啟動應用程式，再用缺少必要值的輸入確認啟動錯誤。仍有未解失效或過渡層時，不宣稱已抵達終態。
可直接使用的提示詞
套用 principle-outcome-oriented-execution，規劃把散落的環境變數讀取移到啟動設定物件。
輸入是啟動入口、全部設定讀取位置、部署需求與現有測試。
先交付終態條件、階段邊界、可接受的工作分支暫時失效與回復方法。
保留改動區域的持續檢查，結束時要求完整靜態與實際啟動驗證。
不要為遷移便利增加永久相容層。先提出計畫，不修改程式或部署。預期結果與驗收
預期取得一份可執行的遷移計畫，而非本頁已代為完成遷移。
- 每個暫時失效都有明確範圍與結束邊界，未波及正式服務。
- 終態可由呼叫端盤點與實際啟動結果確認，不只是編譯成功。
- 結束時有完整靜態及執行期驗證紀錄，沒有未解的過渡失效。
- 若確實需要長期相容，計畫將它列為產品需求，而非把它偽裝成暫時程式。
限制與權限
常見誤用是把「中途可壞」解讀成停止所有測試，或跳過階段邊界一路修改。另一種是只留下新介面，卻讓多數呼叫端永久走舊路。
原則只允許已規劃、受控、可逆的中間失效，不授權破壞共用環境。刪除舊 API、提交、部署與資料遷移仍需符合個別任務授權。本頁只有教學，未實際執行上述變更。