Community寫作與編輯github.com

yidasanqian/codex-code-simplifier

Codex 插件,用於簡化最近的程式碼變更,但不改變其行為。

codex-code-simplifier 是什麼?

這個技能旨在幫助開發者或 AI 代理在不改變程式碼行為的前提下,自動或半自動地簡化最近的程式碼變更。它專注於提升程式碼的清晰度、一致性與可維護性,特別適合用於 Codex 等 AI 編碼助手平台。技能會優先遵循專案中現有的 `AGENTS.md` 與專案風格,只對當前會話中修改過的檔案或使用者明確指定的檔案進行手術刀式的精簡。其運作流程包括檢查當前 diff、識別有明確效益的簡化點(如減少巢狀結構、消除重複、內聯不必要的包裝函數等)、應用最小且一致的補丁,並在修改後執行最相關的驗證命令以確保行為不變。此外,技能設有嚴格的護欄,禁止新增功能、更改外部行為或進行冒險的重構,並在行為保存依賴於不明確的外部合約時,會要求使用者停止並確認。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add yidasanqian/codex-code-simplifier

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

程式碼簡化器

使用此技能來精煉程式碼,以提升其清晰度、一致性與可維護性,但不改變程式碼的實際行為。

範圍

  • 專注於當前會話中已修改的檔案,或是使用者明確指定的檔案。
  • 保留所有行為、公開 API、輸出、資料格式以及副作用。
  • 在套用一般偏好之前,優先遵循最近的 AGENTS.md 檔案與現有的專案風格。
  • 保持修改的手術刀式精準度。請勿重構無關的舊程式碼。
  • 偏好可讀性高、明確的程式碼,而非巧妙或高度壓縮的寫法。

工作流程

  1. 在編輯前,檢查當前的 diff 與鄰近的程式碼。
  2. 找出具有明確效益的簡化點:
    • 減少不必要的巢狀結構或分支
    • 移除近期編輯中引入的重複程式碼
    • 內聯那些會模糊意圖的單一用途抽象
    • 僅在能建立更清晰的邊界時才拆分程式碼
    • 當名稱能更清楚地表達目的時,改善命名
    • 移除那些僅是重複描述顯而易見程式碼的註解
  3. 跳過那些純粹是風格上的、有風險的,或難以證明能保留行為的變更。
  4. 套用最小且一致的補丁。
  5. 執行最相關的驗證指令。當共享行為有所變更時,應擴大驗證範圍。
  6. 報告哪些內容已變更,以及哪些部分已通過驗證。

護欄

  • 請勿新增功能、選項、新的依賴項或投機的靈活性。
  • 除非使用者要求,否則請勿變更錯誤訊息、序列化、順序、時序、權限或外部呼叫。
  • 請勿將清晰的條件判斷轉換為巢狀三元運算子或密集的單行表達式。
  • 請勿僅僅為了減少行數而移除有幫助的抽象。
  • 當區域性的簡化就足夠時,請勿重寫整個模組。
  • 在沒有新的驗證證據之前,請勿聲明行為已被保留。

良好的目標

信號有用的簡化方式
來自近期編輯的重複區塊僅提取或合併重複的意圖
深層的 if 巢狀結構使用早期返回或更清晰的分支
名稱不明確的暫時變數重新命名以描述領域含義
單一用途的包裝函數如果它隱藏的功能多於幫助,則將其內聯
敘述程式碼的註解移除,或替換為解釋原因的註解

停止條件

當行為保留取決於產品意圖、未記錄的相容性或不明確的外部合約時,請先停止並詢問使用者後再進行編輯。如果無法執行驗證,請準確說明哪些部分未經驗證。

相關技能