Community程式設計與開發github.com

AjaneeI/agent-skills

找出不必要的程式碼、依賴、抽象層與投機功能,但不盲目縮減程式行數。適用於重構審查、AI 生成程式碼稽核、效能優先清理,或合併前可維護性檢查。

agent-skills 是什麼?

這項「Code Bloat Triage」技能旨在協助開發者與 AI 代理在軟體重構、程式碼稽核或合併審查時,精準識別並移除不必要的複雜性,同時確保系統正確性、安全性、可存取性與可維護性不受損。技能支援 Claude Code、Cursor、Codex 等常見開發代理平台。其核心工作流程包含:識別使用者需求與測試、盤點潛在膨脹(如重複邏輯、死路徑、未使用依賴、多餘層次、投機配置)、以有意義的指標(如認知複雜度、相依性數量)而非單純行數來評估,並要求每項刪除決策都必須追溯到具體需求或失敗情境。技能還提供明確的護欄:禁止刪除研究來源、驗證邊界、安全檢查或已知失敗案例等關鍵證據;禁止以縮減檔案數量為由犧牲測試涵蓋率或行為可觀察性。輸出為一份決策登錄表(`references/triage.md`),記錄候選項目、理由、證據、變更風險與保留的防護措施。最終成功標準是:審查者能為每個刪除動作提供正當理由,並確認支援的行為與信任邊界維持不變。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AjaneeI/agent-skills/tree/HEAD/skills/code-bloat-triage

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

程式碼膨脹分類

目標

在不犧牲正確性、必要的錯誤處理、可及性、安全性、證據或可維護性的前提下,減少不正當的複雜度。

分類流程

  1. 識別實際的面向使用者或研究需求及其支援的測試。將功能與安全性視為限制條件。
  2. 盤點潛在的膨脹項目:重複邏輯、死路徑、未使用的依賴、不必要的層級、投機配置、多餘的包裝器,以及過大的生成檔案。
  3. 僅衡量有意義的指標:認知複雜度、引入的依賴、程式碼變動量、重複覆蓋率、審查負擔與穩定性。程式碼行數本身並非品質指標。
  4. 針對每個候選項目提問:這支援了哪個需求或哪個失敗情境? 追溯到證據;即使冗長,若有必要則保留。
  5. 依序進行變更:刪除未使用的,合併重複的,簡化抽象層,然後最佳化熱點路徑。避免當一個局部修復就足夠時進行大規模重寫。
  6. 在測試下進行最小可逆變更;執行正向與回歸檢查。保留行為與外部觀察到的合約。
  7. 回報優點與權衡取捨。如果刪除削弱了涵蓋率或模糊了行為,請不要合併該簡化。

護欄

禁止僅僅為了減少檔案數量而刪除研究來源、驗證邊界、核准邊界、安全檢查或已知的失敗範例。禁止為小功能引入不合理的新的程式庫。不得在「重構」標籤下變更凍結的基準測試語意。

輸出

決策登錄表,內容包含候選項目、理由、證據、變更風險及保留的防護措施。

成功標準

審查者能為每個刪除動作提出正當理由,並確認受支援的行為與信任邊界保持不變。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能