AI 開發代理愈來愈常參與寫程式、整理文件與執行驗證，但專案一旦要「瘦身」，最容易出問題的往往不是目錄長得不夠漂亮，而是舊任務還沒結案、測試被搬到無法執行的位置，或唯一一份驗收證據被當成雜物清掉。

一份日期為 2026 年 10 月 22 日的專案治理盤點，就把焦點放在這些容易被忽略的交接風險。它的結論很務實：先弄清楚哪些東西仍是有效契約、哪些只是工作過程，再談要不要搬檔案。

舊任務還沒結束，不能靠「凍結」把它變成已完成

盤點回看一項 V4 修復與清理任務，判定它不能按完成收尾：最新回讀仍標示為阻塞，相關 ADR（架構決策紀錄）仍處於提案狀態；宿主驗收也明確尚未完成。部分本地驗收雖留有歷史摘要，卻沒有取得足以重新核對的原始回執。

這種區分很重要。歷史摘要可以說明曾經記錄過什麼，但不必然能證明特定命令在什麼工作目錄執行、實際退出狀態為何，以及結果適用於哪個版本或目標。缺少原始證據，不等於過去沒有執行；同樣地，也不能把摘要直接當成今天仍有效的驗收結果。

因此，盤點主張先保全舊計畫、保留尚未履行的驗收義務，並確認相關引用已安全交接，再釋出預設入口給新工作。若保全失敗、原始內容已變，或唯一證據無法定位，就應停止入口替換，而不是先宣告結案。

好的整理不是檔案變少，而是每種資產都有清楚職責

建議方向是建立單一、穩定的專案入口，再把領域規範、架構決策、活動中的計畫、歷史計畫、持續回歸測試與臨時工作區分開管理；不同 AI 開發工具則以薄適配層接上同一套權威內容，避免維護多份互相不同步的專案說明。

這項建議不是要求立刻搬遷。盤點特別指出，現有路徑、校驗器、測試發現方式與分發設定可能都有硬編碼依賴。若先移動文件、後補路徑，可能導致測試找不到、引用失效，或部署邊界被意外改變。因此，建議先調整消費者與路徑契約，接著分批遷移，最後再驗證靜態設定、磁碟上的分發結果，以及實際宿主互動。

測試治理看的是保護了什麼，不是有幾個檔案

盤點反對以「測試數量減少」作為整理成功的指標。更實際的問題是：必要斷言有沒有保留？測試工具還找不找得到？副作用、鎖定、權限與錯誤復原等重要邊界是否仍能回歸？

測試也不必和原始碼一對一排列。對 Go 專案來說，如果白箱測試需要存取未匯出的套件內部成員，將它搬出原套件可能破壞測試能力；不能為了目錄整齊，就改為匯出內部狀態或削弱斷言。相反地，確屬一次性用途的探針與執行輸出可以和持續回歸分開，但其中若有必要發現，仍應轉成可重現的長期測試，或保留其唯一證據來源。

研究材料提到 Geoffrey Huntley 的做法：以測試、型別檢查、靜態檢查和建置結果，形成能拒絕不合格工作的下游回饋；並以專案文件記載實際命令，讓這些回饋貼近專案本身。6 這提供的是方法參考，不是本專案已因此改善的實測證明。另一篇談跨語言移植的文章，則描述將測試整理成規格文件的做法；盤點提醒，這不能被延伸解讀成日常回歸測試應一概刪除。11

Plan 和 Act 的切換，不是萬用授權開關

跨宿主治理還有一個常見誤區：把工具的模式名稱，直接當成權限或執行行為的保證。Cline 的官方說明將 Plan 描述為探索與規劃模式，Act 則用於依計畫執行工作。2 但這項描述本身，不能證明特定安裝版本已載入哪些規則、終端是否受到執行層級的隔離，或技能是否會自動呼叫。

同理，切換到 Act 不應被視為自動核准安裝、檔案遷移、部署或提交等所有操作。盤點建議將授權綁定到具體計畫、階段與範圍，並分開驗證規則載入、技能呼叫及實際工具權限。若目標版本或接口還未確認，就先保留明確讀取與人工交接的退路，不要用猜測的設定欄位假裝已支援。

先訂交接條件，再談正式遷移

這份盤點的方案目前是治理提案，不是已完成的工程或宿主驗收。後續建議分階段進行：先保全舊任務與引用；再調整文件職責和路徑契約；接著確認指定工具版本的規則與技能接口；最後才依逐項清單搬移文件、測試與證據，並在獲得獨立授權後進行真實宿主驗收。

這樣做或許沒有一次清空目錄來得俐落，卻能把「整理完成」拆解成可以核對的責任：舊任務沒有被抹掉，測試仍能保護真正重要的行為，工具切換也沒有被誤認為無條件授權。對使用 AI 開發代理的團隊而言，這往往比少幾個檔案更值得追求。

AI 開發代理愈來愈常參與寫程式、整理文件與執行驗證，但專案一旦要「瘦身」，最容易出問題的往往不是目錄長得不夠漂亮，而是舊任務還沒結案、測試被搬到無法執行的位置，或唯一一份驗收證據被當成雜物清掉。

一份日期為 2026 年 10 月 22 日的專案治理盤點，就把焦點放在這些容易被忽略的交接風險。它的結論很務實：先弄清楚哪些東西仍是有效契約、哪些只是工作過程，再談要不要搬檔案。

舊任務還沒結束，不能靠「凍結」把它變成已完成

盤點回看一項 V4 修復與清理任務，判定它不能按完成收尾：最新回讀仍標示為阻塞，相關 ADR（架構決策紀錄）仍處於提案狀態；宿主驗收也明確尚未完成。部分本地驗收雖留有歷史摘要，卻沒有取得足以重新核對的原始回執。

這種區分很重要。歷史摘要可以說明曾經記錄過什麼，但不必然能證明特定命令在什麼工作目錄執行、實際退出狀態為何，以及結果適用於哪個版本或目標。缺少原始證據，不等於過去沒有執行；同樣地，也不能把摘要直接當成今天仍有效的驗收結果。

因此，盤點主張先保全舊計畫、保留尚未履行的驗收義務，並確認相關引用已安全交接，再釋出預設入口給新工作。若保全失敗、原始內容已變，或唯一證據無法定位，就應停止入口替換，而不是先宣告結案。

好的整理不是檔案變少，而是每種資產都有清楚職責

建議方向是建立單一、穩定的專案入口，再把領域規範、架構決策、活動中的計畫、歷史計畫、持續回歸測試與臨時工作區分開管理；不同 AI 開發工具則以薄適配層接上同一套權威內容，避免維護多份互相不同步的專案說明。

這項建議不是要求立刻搬遷。盤點特別指出，現有路徑、校驗器、測試發現方式與分發設定可能都有硬編碼依賴。若先移動文件、後補路徑，可能導致測試找不到、引用失效，或部署邊界被意外改變。因此，建議先調整消費者與路徑契約，接著分批遷移，最後再驗證靜態設定、磁碟上的分發結果，以及實際宿主互動。

測試治理看的是保護了什麼，不是有幾個檔案

盤點反對以「測試數量減少」作為整理成功的指標。更實際的問題是：必要斷言有沒有保留？測試工具還找不找得到？副作用、鎖定、權限與錯誤復原等重要邊界是否仍能回歸？

測試也不必和原始碼一對一排列。對 Go 專案來說，如果白箱測試需要存取未匯出的套件內部成員，將它搬出原套件可能破壞測試能力；不能為了目錄整齊，就改為匯出內部狀態或削弱斷言。相反地，確屬一次性用途的探針與執行輸出可以和持續回歸分開，但其中若有必要發現，仍應轉成可重現的長期測試，或保留其唯一證據來源。

研究材料提到 Geoffrey Huntley 的做法：以測試、型別檢查、靜態檢查和建置結果，形成能拒絕不合格工作的下游回饋；並以專案文件記載實際命令，讓這些回饋貼近專案本身。6 這提供的是方法參考，不是本專案已因此改善的實測證明。另一篇談跨語言移植的文章，則描述將測試整理成規格文件的做法；盤點提醒，這不能被延伸解讀成日常回歸測試應一概刪除。11

Plan 和 Act 的切換，不是萬用授權開關

跨宿主治理還有一個常見誤區：把工具的模式名稱，直接當成權限或執行行為的保證。Cline 的官方說明將 Plan 描述為探索與規劃模式，Act 則用於依計畫執行工作。2 但這項描述本身，不能證明特定安裝版本已載入哪些規則、終端是否受到執行層級的隔離，或技能是否會自動呼叫。

同理，切換到 Act 不應被視為自動核准安裝、檔案遷移、部署或提交等所有操作。盤點建議將授權綁定到具體計畫、階段與範圍，並分開驗證規則載入、技能呼叫及實際工具權限。若目標版本或接口還未確認，就先保留明確讀取與人工交接的退路，不要用猜測的設定欄位假裝已支援。

先訂交接條件，再談正式遷移

這份盤點的方案目前是治理提案，不是已完成的工程或宿主驗收。後續建議分階段進行：先保全舊任務與引用；再調整文件職責和路徑契約；接著確認指定工具版本的規則與技能接口；最後才依逐項清單搬移文件、測試與證據，並在獲得獨立授權後進行真實宿主驗收。

這樣做或許沒有一次清空目錄來得俐落，卻能把「整理完成」拆解成可以核對的責任：舊任務沒有被抹掉，測試仍能保護真正重要的行為，工具切換也沒有被誤認為無條件授權。對使用 AI 開發代理的團隊而言，這往往比少幾個檔案更值得追求。