重點唔係「文件愈少愈好」

一份關於 AI 編程代理項目治理嘅提案，想處理嘅唔止係目錄整唔整齊，而係長期測試、臨時驗證、運行證據、領域規格同決策紀錄，應該各自負責啲乜。

提案建議將穩定嘅項目導覽、當前規格、架構決策同執行計劃分開管理，避免逐輪進度塞滿入口文件，亦避免將所有決策歷史塞進規格。測試方面，重點係按缺陷、契約同副作用邊界判斷有冇保留價值，而唔係見到測試檔案多，就一律搬走或者刪除。

回歸測試與臨時驗證，要分清楚

提案將持久回歸測試、跨組件測試、臨時探針同測試輸出分開看待。臨時驗證未必需要成為長期資產，但呢個唔代表可以忽略長期回歸；同樣，執行結果亦唔應該當成測試程式碼本身。

清理前，還要確認有冇其他地方引用相關測試，以及該結果係咪唯一一份原始證據。換言之，整理可以做，但唔應該為咗清爽而失去覆蓋、斷言或者可追溯記錄。

「先寫規格再移植」唔等於可以刪日常測試

提案提到 Geoffrey Huntley 曾在跨語言移植情境中，建議將測試提煉成領域規格；但同一份提案亦提醒，唔應將呢個做法延伸成刪除日常回歸測試嘅理由。7

呢個區分幾重要：規格可以幫手講清楚系統應該點運作，但唔代表每個情境都毋須持續驗證。提案因此主張保留必要測試，同時避免無目的地複製測試、實作或狀態紀錄。

AI 工具嘅模式名稱，唔等於權限保證

方案亦提出，以單一權威內容源配合薄宿主適配，連接不同 AI 編程工具；規則載入、技能呼叫、模式切換同工具權限則應分開驗收。

以 Cline 官方說明為例，Plan 模式定位為探索同規劃，而 Act 模式負責按計劃實施；官方亦表示 Plan 模式不會改動檔案或執行命令。2 但提案指出，呢啲產品說明不足以證明某個特定安裝版本、宿主環境或整合介面一定會有相同權限行為。官方入口資料列出規則同技能嘅設定位置，亦唔等於已證明特定環境會自動載入或自動呼叫。3

所以，按下 Act 唔應被當成對整個項目授權；實際改動仍要對應獲批嘅計劃、階段同寫入範圍。

目前仍係提案，未係工程結果

文件所列狀態顯示，舊計劃仍然受阻（BLOCKED），舊架構決策紀錄（ADR）亦仍屬待議（PROPOSED）。今次方案明確表示，只保存提案，未授權實施、目錄遷移、宿主驗收或舊任務收尾。

下一步亦未必係即刻搬文件：提案要求先確認獨立計劃位置同實際編輯權限，再逐項列出範圍、驗收方法同失敗復原安排。若引用失效、測試覆蓋遺失，或者宿主支援未核實，就應停低相關步驟，而唔係降低驗收標準。

歸根究柢，呢份方案主張嘅唔係「一次過大掃除」，而係先釐清每份文件同每項測試嘅用途，再按證據分階段調整。提案獲保存，唔等於已獲批准或證明可行。

重點唔係「文件愈少愈好」

一份關於 AI 編程代理項目治理嘅提案，想處理嘅唔止係目錄整唔整齊，而係長期測試、臨時驗證、運行證據、領域規格同決策紀錄，應該各自負責啲乜。

提案建議將穩定嘅項目導覽、當前規格、架構決策同執行計劃分開管理，避免逐輪進度塞滿入口文件，亦避免將所有決策歷史塞進規格。測試方面，重點係按缺陷、契約同副作用邊界判斷有冇保留價值，而唔係見到測試檔案多，就一律搬走或者刪除。

回歸測試與臨時驗證，要分清楚

提案將持久回歸測試、跨組件測試、臨時探針同測試輸出分開看待。臨時驗證未必需要成為長期資產，但呢個唔代表可以忽略長期回歸；同樣，執行結果亦唔應該當成測試程式碼本身。

清理前，還要確認有冇其他地方引用相關測試，以及該結果係咪唯一一份原始證據。換言之，整理可以做，但唔應該為咗清爽而失去覆蓋、斷言或者可追溯記錄。

「先寫規格再移植」唔等於可以刪日常測試

提案提到 Geoffrey Huntley 曾在跨語言移植情境中，建議將測試提煉成領域規格；但同一份提案亦提醒，唔應將呢個做法延伸成刪除日常回歸測試嘅理由。7

呢個區分幾重要：規格可以幫手講清楚系統應該點運作，但唔代表每個情境都毋須持續驗證。提案因此主張保留必要測試，同時避免無目的地複製測試、實作或狀態紀錄。

AI 工具嘅模式名稱，唔等於權限保證

方案亦提出，以單一權威內容源配合薄宿主適配，連接不同 AI 編程工具；規則載入、技能呼叫、模式切換同工具權限則應分開驗收。

以 Cline 官方說明為例，Plan 模式定位為探索同規劃，而 Act 模式負責按計劃實施；官方亦表示 Plan 模式不會改動檔案或執行命令。2 但提案指出，呢啲產品說明不足以證明某個特定安裝版本、宿主環境或整合介面一定會有相同權限行為。官方入口資料列出規則同技能嘅設定位置，亦唔等於已證明特定環境會自動載入或自動呼叫。3

所以，按下 Act 唔應被當成對整個項目授權；實際改動仍要對應獲批嘅計劃、階段同寫入範圍。

目前仍係提案，未係工程結果

文件所列狀態顯示，舊計劃仍然受阻（BLOCKED），舊架構決策紀錄（ADR）亦仍屬待議（PROPOSED）。今次方案明確表示，只保存提案，未授權實施、目錄遷移、宿主驗收或舊任務收尾。

下一步亦未必係即刻搬文件：提案要求先確認獨立計劃位置同實際編輯權限，再逐項列出範圍、驗收方法同失敗復原安排。若引用失效、測試覆蓋遺失，或者宿主支援未核實，就應停低相關步驟，而唔係降低驗收標準。

歸根究柢，呢份方案主張嘅唔係「一次過大掃除」，而係先釐清每份文件同每項測試嘅用途，再按證據分階段調整。提案獲保存，唔等於已獲批准或證明可行。