啟動合約
當 frontmatter 中的觸發條件適用於缺陷工作流程時載入。
此技能引導公開協作。它不授予議題核准、標籤、審查、例外或合併權限。
硬性規則
- 審查與 Judgment Day 證據僅限審查用途。Pi 從不授予交付權限：一般提交、推送、PR 與發佈永遠遵循儲存庫政策，無論 RDD 模式為何。
- 實施前需要一個已核准的議題（
status:approved）與乾淨的當前main分支重現步驟。審查現有 PR 是否有取代或衝突；停止或縮小過時的聲明。 - 按因果權威不變性分組。對每個獨立的不變性與回滾邊界，使用一個議題與一個 PR 或明確的鏈結。分離獨立原因；絕不合併已被取代或有衝突的權威線。
- 清查議題或 PR 所聲明的每個操作者流程，包括進入點、模式、環境、預期結果與負面控制。對每個 CLI 或生命週期流程，要求一個真實的黑箱基準測試旅程；若核心基準無法代表，則要求實際執行環境的端到端證明。合成代理覆蓋率永遠無法證明另一個執行環境。
- 使用 CodeGraph 優先的影響映射、專用工作目錄，以及行為優先的測試。在候選方案凍結前執行原始碼變異正規化。
- 在編輯前預測要進行的變更。硬性限制為 400 行增減；超過此限制則 STOP，並要求鏈結或維護者明確批准的例外。
- 當 RDD 啟用時，將審查收據、譜系、修正與復原證據繫結至確切的候選方案。將有限審查缺陷保留在一個修正交易中；絕不將該證據視為交付權限。
- 在發佈前要求獨立的唯讀候選方案驗證。驗證不得編輯原始碼或權威；發現結果需要一個新的候選方案。
- 保持溝通人性化且基於證據。儲存庫標籤與工作流程元數據歸維護者所有，絕非貢獻者歸責的證據。
決定閘門
| 條件 | 動作 |
|---|---|
| 任何 RDD 模式 | 審查證據仍僅限審查用途；一般提交、推送、PR 與發佈遵循儲存庫政策，無 Pi 交付權限。 |
| 議題閘門或重現失敗 | 等待、停止或附上證據縮小範圍。 |
| 不變性或回滾是獨立的 | 分離議題與權威性 PR 線。 |
| 核心基準適合/不適合 | 基準測試旅程 / 實際執行環境端到端；絕不使用代理。 |
| 預測超過 400 行 | 在編輯前鏈結或取得批准的例外。 |
執行步驟
- 檢查模式、核准、PR 衝突與當前 main 分支的重現。
- 命名不變性與回滾；隔離工作目錄；使用 CodeGraph 映射程式碼、測試、證據、文件、分發與註冊。
- 清查流程與控制；加入失敗的測試與最小的修正。
- 正規化、執行預算、執行測試，並記錄每個流程的確切候選方案、命令、場景與結果。
- 凍結、執行唯讀驗證，並給出判定、證據與一個人性化的下一步行動。
輸出合約
回傳 rdd_mode、issue_pr、causal_invariant、operator_flows、journey_runtime_evidence、changed_line_budget、tests、rollback 與 unresolved_authority_decisions。
識別已核准與已被取代/衝突的權威線；每個流程、負面控制與繫結候選的證明；增減行數與鏈結/例外；測試結果；獨立回滾；以及未解決的維護者決策。
參考資料
無輔助檔案。當前儲存庫政策仍具權威性。