用 AI 編程代理時，「Plan」聽起來像是只會思考、不會動手。但如果你是為了避免改壞檔案，單靠模式名稱判斷安全界線就未必足夠：Cline 的官方文件對一般模式和子代理的描述，重點並不完全相同。

Plan 模式的說明，要先看清楚適用範圍

Cline 的 Plan & Act 模式介紹將 Plan 描述為探索程式碼、搜尋和討論方案的階段，並稱它不會改動檔案或執行命令；Act 則是按計劃實施。4

不過，官方的子代理文件談到另一個情境：Plan 模式下的子代理沒有檔案編輯工具，會拒絕 rm、git commit 這類通常會改動檔案的 Shell 命令，但仍可執行其他命令；文件亦特別舉例，python -c 仍可能寫入檔案。2

兩份文件描述的功能範圍不同，不能簡單當成同一項權限保證。較穩妥的理解是：Plan 有助把規劃和實作分開，但現有說明不足以證明所有入口都構成一個完全隔離、絕不可能寫入檔案的安全沙箱。若工作要求嚴格限制寫入，應先確認實際使用的版本和設定，再測試它能否執行相關命令。

上下文愈長，愈要有意整理

AI 編程代理不只要讀程式碼，亦要在對話中掌握背景、計劃和待辦事項。HumanLayer 分享的「frequent intentional compaction」，重點是開發過程中有意識地整理和安排提供給模型的上下文；該文亦描述其工作流程會把上下文使用量維持在 40% 至 60% 左右，並在關鍵位置加入人工檢視。8

這是文章分享的一種工作方法，不代表每個模型或項目都應照搬同一比例。實際上更值得借鏡的，是整理時保留當前目標、重要決定、未完成事項和必要來源，而不是只把對話愈縮愈短，最後連關鍵限制也一併刪掉。

跨語言移植：先把測試變成可查閱的規格

Geoffrey Huntley 談到將程式碼庫由一種語言移植到另一種語言時，提出先把測試整理成 /specs/*.md 規格文件，並在規格中連結實作作為依據；之後再另行處理產品功能。9

這個方法的對象是跨語言移植，並非叫人把日常測試刪掉。對使用 AI 協助理解大型程式庫的團隊來說，它提供了一個可參考的方向：把散落在測試和程式碼裡的預期行為整理成有來源可追的文件，讓模型和開發者都較容易核對。但規格文件不能自動取代測試，亦不應把尚未驗證的描述當成既定事實。

實際使用時，記住三件事

• 把 Plan 視為工作流程中的規劃階段，不要只憑名稱當成安全隔離保證。
• 需要限制檔案或命令操作時，先核實具體版本、入口和設定，再做小範圍測試。
• 整理 AI 上下文或把測試寫成規格時，保留來源、重要決定和未完成事項；文件仍要與實際程式碼和測試互相核對。

AI 編程代理可以加快理解和實作，但真正可靠的工作方式，仍要靠清楚的權限界線、可追溯的規格和適當的人手覆核。

用 AI 編程代理時，「Plan」聽起來像是只會思考、不會動手。但如果你是為了避免改壞檔案，單靠模式名稱判斷安全界線就未必足夠：Cline 的官方文件對一般模式和子代理的描述，重點並不完全相同。

Plan 模式的說明，要先看清楚適用範圍

Cline 的 Plan & Act 模式介紹將 Plan 描述為探索程式碼、搜尋和討論方案的階段，並稱它不會改動檔案或執行命令；Act 則是按計劃實施。4

不過，官方的子代理文件談到另一個情境：Plan 模式下的子代理沒有檔案編輯工具，會拒絕 rm、git commit 這類通常會改動檔案的 Shell 命令，但仍可執行其他命令；文件亦特別舉例，python -c 仍可能寫入檔案。2

兩份文件描述的功能範圍不同，不能簡單當成同一項權限保證。較穩妥的理解是：Plan 有助把規劃和實作分開，但現有說明不足以證明所有入口都構成一個完全隔離、絕不可能寫入檔案的安全沙箱。若工作要求嚴格限制寫入，應先確認實際使用的版本和設定，再測試它能否執行相關命令。

上下文愈長，愈要有意整理

AI 編程代理不只要讀程式碼，亦要在對話中掌握背景、計劃和待辦事項。HumanLayer 分享的「frequent intentional compaction」，重點是開發過程中有意識地整理和安排提供給模型的上下文；該文亦描述其工作流程會把上下文使用量維持在 40% 至 60% 左右，並在關鍵位置加入人工檢視。8

這是文章分享的一種工作方法，不代表每個模型或項目都應照搬同一比例。實際上更值得借鏡的，是整理時保留當前目標、重要決定、未完成事項和必要來源，而不是只把對話愈縮愈短，最後連關鍵限制也一併刪掉。

跨語言移植：先把測試變成可查閱的規格

Geoffrey Huntley 談到將程式碼庫由一種語言移植到另一種語言時，提出先把測試整理成 /specs/*.md 規格文件，並在規格中連結實作作為依據；之後再另行處理產品功能。9

這個方法的對象是跨語言移植，並非叫人把日常測試刪掉。對使用 AI 協助理解大型程式庫的團隊來說，它提供了一個可參考的方向：把散落在測試和程式碼裡的預期行為整理成有來源可追的文件，讓模型和開發者都較容易核對。但規格文件不能自動取代測試，亦不應把尚未驗證的描述當成既定事實。

實際使用時，記住三件事

• 把 Plan 視為工作流程中的規劃階段，不要只憑名稱當成安全隔離保證。
• 需要限制檔案或命令操作時，先核實具體版本、入口和設定，再做小範圍測試。
• 整理 AI 上下文或把測試寫成規格時，保留來源、重要決定和未完成事項；文件仍要與實際程式碼和測試互相核對。

AI 編程代理可以加快理解和實作，但真正可靠的工作方式，仍要靠清楚的權限界線、可追溯的規格和適當的人手覆核。