Communitygithub.com

精簡技能

引導 AI 代理進行有紀律的軟體系統簡化審計與程式碼審查。

精簡技能 是什麼?

此技能專為希望提升軟體系統簡化能力的使用者所設計,支援代理在唯讀模式下進行「審計」與「審查」。它遵循「偏愛刪除、直接狀態、局部所有權、深度模組、原生能力與 YAGNI」的核心原則,透過一個具體的簡化階梯(刪除、重用、推導、本地化、縮小)來指導代理。使用者可以提供系統或提交變更範圍,讓代理檢查實際流程、消費者與合約,並識別不需要的機制、重複狀態或錯誤的抽象層。 此技能支援多個平台,包括 Claude Code 與 Cursor,並以結構化的證據與風險報告來呈現結果。它專注於發現有證據支持的簡化機會,而非憑空推薦重構或提取,特別適合用於減少技術債務與降低複雜度。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add quantipixels/skills

在你喜歡的 AI 中提問

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

說明文件

Parẹ́

偏愛刪除、直接狀態、局部所有權、深度模組、原生能力與 YAGNI。拒絕被搬移的複雜性。

模式:

  • audit — 受限制的軟體系統/子系統簡化審計;唯讀;不執行測試/構建。
  • review — 一個固定的軟體候選;唯讀;不提供提供者/裁決。

將缺陷裁決/狀態一致性、實作與技術架構保留在此唯讀簡化結果之外。

證據

確定軟體系統/候選、基準線、指令與排除項目。僅檢查當前消費者、實作/配置、歷史記錄、生成的/框架達到的範圍,以及區分實質簡化主張所需的系統原生證據。搜尋或工具缺失本身絕非刪除的證明,工具/指標輸出是證據而非簡化裁決。

當控制流/狀態空間/巢狀/扇出/生命週期/複雜度/測試數量實質上主導調查時,請閱讀複雜度與證明。當重複出現的可維護性/所有權模式至關重要時,請閱讀可維護性模式。模式與指標僅為信號,而非發現結果。

簡化階梯

在理解實際流程/消費者/合約後,採取第一個合理的減少步驟:

  1. 刪除 — 該機制無需存在,或現有元素沒有必要的行為、合約、消費者或所有者。
  2. 重用 — 當前實作/系統能力 → 標準庫/框架/平台 → 已安裝的依賴項/工具。
  3. 推導 — 消除儲存/重複的狀態,同時保留時序/所有權/成本。
  4. 本地化 — 將策略/狀態與其真實所有者/深度模組放在一起。
  5. 縮小 — 最小的直接機制;無投機性的變化。

不要僅因為檔案/函數很大或某個分數很高就推薦提取/間接層。新的抽象層並非簡化,除非它移除了淨語義負擔,並擁有當前的變化或獨立真實的邊界。

審計

盤點不重疊的原始碼、入口點、構建、測試、工具、平台、運行時/配置與生成的子系統。將實作/依賴項/配置/支援構件分類為 保留 | 可安全刪除 | 受阻。分別執行刪除、表示、所有權、演算法、重要時的複雜度以及證明的通行檢查。

刪除安全性需要的遠不止搜尋缺失:檢查呼叫者、動態/框架/生成的達範圍、配置/數據、構建、消費者、歷史記錄、合約與證明所有者。當沒有更強的完整所有者時,保留公共/安全/數據完整性/並發/恢復/適配器/運行時/互動/可訪問性合約。

根據持久合約價值而非數量/覆蓋率來審計測試。當有證據顯示測試無法獨立反駁實質合約、重新計算/鏡像生產邏輯、驗證模擬/編排而非行為、保護私有結構、測試項目不擁有的框架/庫行為、重複更強的證明、需要不成比例的支撐,或僅作為建構歷史而存在時,該測試就是簡化候選項。即使實作很小,當測試唯一地保護了實質穩定不變量時,請不要建議刪除。

根據影響/風險/努力/依賴性對實質減少項目進行排序,並表達實作切片;不要執行它們。當分散的呼叫者知識、轉發層、重複策略或淺層接縫表明有深化機會時,請識別錯誤放置的責任與呼叫者負擔。如果選擇替代模組/介面/接縫本身就是一個關鍵的架構問題,請使用 architect,而不是在 pare 內部設計該替換方案。

審查

確定所提供的候選項;否則使用確切的當前變更邊界。檢查內聚性、耦合、重用、YAGNI、詞彙、無效/重複狀態、所有權、深度、證明與實質語義複雜度。

同時檢查:

  • 變更範圍漂移:觸及的沒有簡潔的請求解釋或證明理由的子系統/檔案/合約;
  • 透過新依賴項、平行實作、相容性路徑、投機性抽象或無關清理來擴展範圍;
  • 主要為可測試性引入,但沒有獨立真實生產邊界的生產架構;
  • 可以透過刪除/強化原因狀態或所有者而消除的邊緣案例機制;以及
  • 針對穩定接縫、獨立預言機、可反駁性、更強現有證明與維護負擔的持久測試。

僅將通過的測試、覆蓋率、行數減少或工具分數視為證據。當有證據支持安全移除時,明顯無效或冗餘的程式碼可能會作為清理建議提出;其單純存在並非阻塞性發現。將可能的缺陷導向 atunwo;將衝突的項目/領域詞彙導向 amose。當一個實質的簡化發現需要一個新的關鍵模組/介面/接縫設計時,將該技術形狀留給 architect,並在此處僅保留有證據支持的簡化需求。

當一個有意的簡化具有記錄在案的閾值/重新審視觸發條件時,如果當前證據支持它,則應予以保留。沒有可觀察到重新審視觸發條件的實質性故意限制是維護性問題,而不是製造獨立債務系統的理由。

發現結果

使用如 delete、native、yagni、state、owner、scope、test、shrink、proof 等標籤進行報告:

<tag> <成本/後果>. <更小的形式>. [位置]
風險: <實質風險>
證明: <證據 / 未來證明所有者>
信心: <等級>

在建議之前,重新檢查身份、達範圍、所有權、證明、遷移與相關工作區狀態。說明未來的驗證/權威,而不執行測試/構建或進行變更。

返回範圍/身份、排序後的減少項目、保留的合約、證明所有者、阻礙因素、實作切片、所需的執行權限、未來驗證以及殘留風險。

相關技能