Agent Lean Safe Coding
使用此技能讓編碼代理保持既精簡又安全:只建立需要的行為,重用既有的成果,並保護 Windows/大量文字儲存庫免受脆弱編輯的影響。
預設模式為 full。
lite:快速分類,狹窄脈絡,最小安全修補。full:分類階梯,Windows/文字安全保護,依賴檢查,修補預算,驗證。audit:不進行編輯;審查計劃或差異,檢查過度建置、重複邏輯、依賴風險、Windows/文字風險以及驗證不足之處。
執行迴圈
- 分類任務。
- 將有風險的檔案放入安全信封。
- 在撰寫程式碼前先走完分類階梯。
- 設定修補預算。
- 在本地編輯並保持原有風格。
- 驗證最小目標閘門。
- 報告結果,附上重用與風險備註。
1. 分類
在編輯前命名任務類型:
bugfix:找出共享原因;在散佈防護措施前先檢查同級呼叫者。feature:檢查請求的行為是否已由平台、框架或儲存庫提供。refactor:需要具體的簡化或風險降低;避免因個人喜好而重新排列程式碼。review:指出刪除點、重用機會、不安全的 shell/文字操作以及缺失的檢查。docs/text:保護編碼、行尾符號、Markdown 結構與範例。
如果請求不明確但保守預設是安全的,則使用該預設並簡短說明假設。
2. 安全信封
當存在以下任一情況時,使用安全信封:Windows 路徑、PowerShell 或 cmd、非 ASCII 文字、中文文字、表情符號、Markdown、提示詞、模板、在地化檔案、精確替換、不確定的編碼、CRLF/LF 敏感檔案,或可能被誤認為原始碼的產生輸出。
在信封內:
- 偏好使用修補工具進行小編輯。
- 避免將非 ASCII 內容透過 shell 管線或內嵌 PowerShell 字串傳遞。
- 保留現有的換行風格,除非格式化工具擁有該檔案。
- 對於腳本,使用路徑 API 或帶引號的實際路徑。
- 將主控台的亂碼僅視為顯示證據;在重寫前先檢查位元組或 UTF-8 讀取結果。
- 除非使用者明確要求,否則不要編輯產生的資料夾、依賴套件資料夾、快取、二進位檔、螢幕截圖或存檔。
僅當任務具有編碼、換行、路徑或 shell 脆弱性風險時,才讀取 references/windows-text-safety.md。
3. 分類階梯
在自訂程式碼之前,停在能乾淨解決任務的第一個層級:
- 消除需求:是否能透過刪除、配置或記錄現有路徑來滿足請求?
- 重用專案程式碼:輔助函式、元件、鉤子、驗證器、測試工具、命令、結構描述或既有模式。
- 使用語言或標準函式庫行為。
- 使用平台或框架行為:瀏覽器控制、CSS、資料庫約束、框架路由、驗證、快取、序列化或建置工具。
- 使用已安裝的依賴套件。
- 新增一個極小的本地實作。
- 僅在具有明確理由、風險與核准需求時,才提議新的依賴套件或較大的實作。
絕對不要自動新增生產環境的依賴套件。如果新的依賴套件看起來合理,請解釋它取代了什麼、為何已安裝的選項不適合、維護風險以及確切的安裝命令。
僅當依賴/重用決策不明顯時,才讀取 references/reuse-ladder.md。
4. 修補預算
在編輯前,選擇一個小預算:
- 預期會變更的檔案。
- 刻意不更動的檔案。
- 要重用的既有程式碼或平台功能。
- 最小驗證命令,或無需驗證命令的理由。
偏好較少的檔案、較少的抽象層,以及靠近行為的直接變更。除非當前任務需要,否則不要新增介面、工廠、服務層、配置開關、未來的擴充點或包裝器。
5. 修補規則
- 一次修正根因路徑,而不是反覆在呼叫端新增繞道解決方案。
- 當行為保持正確時,刪除冗餘程式碼。
- 讓 diff 中不出現格式化更動。
- 讓註解保持稀少;僅在需要標記有意的限制供日後參考時,使用一個簡潔的註解。
- 如果某個捷徑有已知的上限,在該註解中命名該上限以及觸發升級的條件。
- 不要將一個小函數變成一個子系統。
6. 驗證
執行能證明變更的最窄全新閘門:
- 針對觸及行為的現有測試。
- 針對非平凡的新邏輯的集中單元測試或自我檢查。
- 當無法進行測試時,對編輯過的語言檔案進行語法/型別/lint 檢查。
- 針對僅文件或瑣碎的一行變更進行 diff 審查。
非平凡的分支、解析器、金錢/安全路徑或資料遺失路徑,在可行時需要一個可執行的檢查。瑣碎的一行程式碼不需要新的測試架構。
7. 最終報告
保持最終報告簡短:
Changed - ...
Triage - reused/stdlib/platform/installed dependency/local code/new dependency proposal
Safety - Windows/text risks handled or not relevant
Verified - command/result or reason
Risks - remaining limit, if any
對於 audit 模式,首先回傳發現(儘可能附上檔案/行號參考),然後是刪除/重用列表以及最小的驗證缺口。