Communitygithub.com

AgentPilotLab/agent-lean-safe-coding

適用於 Codex、Claude Code 及 AI 代理的 Windows 安全精簡編寫技能與插件套件。

agent-lean-safe-coding 是什麼?

這項技能旨在幫助 AI 編碼代理(如 Codex、Claude Code 等)在開發時保持既精簡又安全:專注於建立絕對必要的行為、最大化重用現有資源,並特別保護 Windows 系統及大量文字檔案儲存庫免受脆弱編輯的影響。它提供三種操作模式:`lite`(快速分類、狹義脈絡、最小安全修補)、`full`(完整分類階梯、Windows/文字安全保護、依賴檢查、修補預算、驗證)以及 `audit`(僅審查計劃或差異,不進行編輯)。其核心運作流程包含任務分類、安全信封(針對 Windows 路徑、非 ASCII 文字、編碼問題等風險)、分類階梯(優先考慮刪除、重用、平台功能,最後才是新增實作)、修補預算與規則,以及最小可行的驗證與報告機制。支援的代理平台包括 Codex、Claude Code 及其他相容的 AI 編碼代理。使用方式為直接選用此技能,並於提示中指定 `lite`、`full` 或 `audit` 模式。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add AgentPilotLab/agent-lean-safe-coding

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Agent Lean Safe Coding

使用此技能讓編碼代理保持既精簡又安全:只建立需要的行為,重用既有的成果,並保護 Windows/大量文字儲存庫免受脆弱編輯的影響。

預設模式為 full。

  • lite:快速分類,狹窄脈絡,最小安全修補。
  • full:分類階梯,Windows/文字安全保護,依賴檢查,修補預算,驗證。
  • audit:不進行編輯;審查計劃或差異,檢查過度建置、重複邏輯、依賴風險、Windows/文字風險以及驗證不足之處。

執行迴圈

  1. 分類任務。
  2. 將有風險的檔案放入安全信封。
  3. 在撰寫程式碼前先走完分類階梯。
  4. 設定修補預算。
  5. 在本地編輯並保持原有風格。
  6. 驗證最小目標閘門。
  7. 報告結果,附上重用與風險備註。

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. 分類階梯

在自訂程式碼之前,停在能乾淨解決任務的第一個層級:

  1. 消除需求:是否能透過刪除、配置或記錄現有路徑來滿足請求?
  2. 重用專案程式碼:輔助函式、元件、鉤子、驗證器、測試工具、命令、結構描述或既有模式。
  3. 使用語言或標準函式庫行為。
  4. 使用平台或框架行為:瀏覽器控制、CSS、資料庫約束、框架路由、驗證、快取、序列化或建置工具。
  5. 使用已安裝的依賴套件。
  6. 新增一個極小的本地實作。
  7. 僅在具有明確理由、風險與核准需求時,才提議新的依賴套件或較大的實作。

絕對不要自動新增生產環境的依賴套件。如果新的依賴套件看起來合理,請解釋它取代了什麼、為何已安裝的選項不適合、維護風險以及確切的安裝命令。

僅當依賴/重用決策不明顯時,才讀取 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 模式,首先回傳發現(儘可能附上檔案/行號參考),然後是刪除/重用列表以及最小的驗證缺口。

相關技能