用 AI 編程代理幫手改 code，先叫佢「Plan」再落手，聽落係穩陣做法。不過要留意：Plan 模式係一種工作模式描述，未必等於執行層面上完全封鎖改檔。

Cline 的 Plan & Act 文件將 Plan 描述為探索和商量做法的階段，並寫明呢個模式不能修改檔案或執行命令；Act 模式則用來實施計劃。5 但另一份講定時執行的官方文件補充，Plan 執行時沒有檔案編輯工具，也會拒絕 rm、git commit 呢類一般會改變檔案的命令；不過，其他命令仍可能執行，有些例如 python -c 亦可能寫檔。8

「Plan 唔改檔」要睇執行情境

兩份文件描述的情境並不完全相同，不能將其中一句話直接當成所有介面、所有版本都適用的保證。尤其定時執行時，官方文件提到工具呼叫會自行獲批，並提醒有些命令仍可寫入檔案。8

所以，如果任務要求「只分析，唔好改任何檔」，最穩陣係先確認自己使用的版本和執行入口，再檢查實際可用的工具及限制。**唔好單靠畫面顯示 Plan，就當成一個隔離執行環境。**現有資料並不足以證明每個版本、每種使用方式都會有同一套限制。

整理上下文，唔等於清走所有過程材料

AI 編程代理要處理長任務，提供咩背景資料同點樣整理，會影響佢手上掌握的上下文。HumanLayer 的文章介紹「有意識、頻繁地整理上下文」這種做法，重點是隨開發進程安排餵給模型的資料。11

但呢個原則本身唔代表任務完成後就一定要刪除所有過程材料，也無法推出固定的上下文窗口比例或必然成效。實際管理時，可以優先確保代理仍看得到當前要求、未完成事項、資料來源，以及尚未確認的地方；呢啲係務實的整理方向，不是來源已證明的硬性規則。

測試寫成規格，有特定用途

另一個容易混淆的做法，是將測試整理成文字規格。Geoffrey Huntley 在討論跨語言移植軟件時，提出把測試內容整理成規格文件，並將實作連結到相應規格。12

呢個建議的背景是跨語言移植，唔應直接解讀成日常開發可以刪走回歸測試，或者所有專案都必須改用文字規格。兩者可以分工：測試用來驗證行為，規格則可幫助整理和解釋預期；要唔要採用，仍要視乎任務需要。

規則設定同技能呼叫亦要分開看

Cline 的文件分別列出規則和技能的設定位置；工具參考亦列出技能呼叫工具。47 但列出設定位置或工具，並不足以證明某個版本會自動載入所有設定，或會自動在正確時機呼叫技能。使用者仍要確認目標版本實際載入了甚麼、優先次序如何，以及預期行為有沒有生效。

**簡單講：Plan 模式適合用來先想清楚，但唔好將模式名稱當成安全保證。**先核對實際執行限制，再決定可否交由代理處理寫檔任務；長任務就整理必要上下文，但唔好把特定情境下的技巧，誤當成所有專案都要照做的規則。

用 AI 編程代理幫手改 code，先叫佢「Plan」再落手，聽落係穩陣做法。不過要留意：Plan 模式係一種工作模式描述，未必等於執行層面上完全封鎖改檔。

Cline 的 Plan & Act 文件將 Plan 描述為探索和商量做法的階段，並寫明呢個模式不能修改檔案或執行命令；Act 模式則用來實施計劃。5 但另一份講定時執行的官方文件補充，Plan 執行時沒有檔案編輯工具，也會拒絕 rm、git commit 呢類一般會改變檔案的命令；不過，其他命令仍可能執行，有些例如 python -c 亦可能寫檔。8

「Plan 唔改檔」要睇執行情境

兩份文件描述的情境並不完全相同，不能將其中一句話直接當成所有介面、所有版本都適用的保證。尤其定時執行時，官方文件提到工具呼叫會自行獲批，並提醒有些命令仍可寫入檔案。8

所以，如果任務要求「只分析，唔好改任何檔」，最穩陣係先確認自己使用的版本和執行入口，再檢查實際可用的工具及限制。**唔好單靠畫面顯示 Plan，就當成一個隔離執行環境。**現有資料並不足以證明每個版本、每種使用方式都會有同一套限制。

整理上下文，唔等於清走所有過程材料

AI 編程代理要處理長任務，提供咩背景資料同點樣整理，會影響佢手上掌握的上下文。HumanLayer 的文章介紹「有意識、頻繁地整理上下文」這種做法，重點是隨開發進程安排餵給模型的資料。11

但呢個原則本身唔代表任務完成後就一定要刪除所有過程材料，也無法推出固定的上下文窗口比例或必然成效。實際管理時，可以優先確保代理仍看得到當前要求、未完成事項、資料來源，以及尚未確認的地方；呢啲係務實的整理方向，不是來源已證明的硬性規則。

測試寫成規格，有特定用途

另一個容易混淆的做法，是將測試整理成文字規格。Geoffrey Huntley 在討論跨語言移植軟件時，提出把測試內容整理成規格文件，並將實作連結到相應規格。12

呢個建議的背景是跨語言移植，唔應直接解讀成日常開發可以刪走回歸測試，或者所有專案都必須改用文字規格。兩者可以分工：測試用來驗證行為，規格則可幫助整理和解釋預期；要唔要採用，仍要視乎任務需要。

規則設定同技能呼叫亦要分開看

Cline 的文件分別列出規則和技能的設定位置；工具參考亦列出技能呼叫工具。47 但列出設定位置或工具，並不足以證明某個版本會自動載入所有設定，或會自動在正確時機呼叫技能。使用者仍要確認目標版本實際載入了甚麼、優先次序如何，以及預期行為有沒有生效。

**簡單講：Plan 模式適合用來先想清楚，但唔好將模式名稱當成安全保證。**先核對實際執行限制，再決定可否交由代理處理寫檔任務；長任務就整理必要上下文，但唔好把特定情境下的技巧，誤當成所有專案都要照做的規則。