Community程式設計與開發github.com

Gentleman-Programming/gentle-ai-skill-improver

觸發條件:改善技能、審核技能、重構技能、技能品質。審核與升級現有的 LLM-first 技能。

gentle-ai-skill-improver 是什麼?

此技能專為審核、重構、標準化及改進現有 `SKILL.md` 文件而設計。它能確保技能定義符合指定的風格指南、遵循硬性規則,並維持清晰的激活語意與輸出合約。該工具支援審計模式(僅報告問題)和套用模式(直接修改檔案),並會在發現規則衝突或意圖不明時標記為待人工審查。它主要用於 Claude Code 或其他以 LLM 為核心的開發工具,以維持高品質的技能目錄。透過引用 `docs/skill-style-guide.md` 與 `.atl/skill-registry.md`,此技能可批量處理多個技能文件,產生結構化的審計報告,並在必要時自動修正前後文、決策表或將長篇解說移至參考目錄。若需從頭建立全新技能,請改用 `gentle-ai-skill-creator`。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Gentleman-Programming/gentle-shell/tree/main/skills/skill-improver

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

在你喜歡的 AI 中提問

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

說明文件

激活合約

當需要審核、重構、規範化或改進現有的 SKILL.md 檔案時,請使用此技能。當要從可重複使用的模式建立全新的技能時,請使用 gentle-ai-skill-creator。

硬性規則

  • 首先閱讀 docs/skill-style-guide.md,並將其視為規範性樣式合約。
  • 將 SKILL.md 視為事實來源;保留作者意圖、關鍵規則、激活語意與輸出要求。
  • 使用 .atl/skill-registry.md 作為技能名稱、觸發條件、範圍及確切路徑的索引(若有的話)。
  • 預設僅進行審計。只有當使用者明確要求套用改善時,才修改檔案。
  • 切勿悄無聲息地刪除有意義的內容;將冗長的說明、範例、模板或結構定義移至本地的 references/ 或 assets/ 目錄中。
  • 不要憑空發明觸發條件、政策或領域規則。將模糊不清的情況標記為待人工審查。

決策閘門

情況動作
前後文遺失或無效修正 name、附引號的單行 description、license 及 metadata
技能讀起來像教學文件轉換為執行時指令,並將背景資料移至 references/
內容超出預算保留規則,將範例/背景移至輔助檔案
分支邏輯隱藏在文字中轉換為精簡的決策表
規則衝突或意圖不明回報問題;不要自動重寫該條規則

執行步驟

  1. 讀取 docs/skill-style-guide.md。
  2. 讀取 .atl/skill-registry.md;使用列出的路徑選取技能。若路徑缺失,則掃描已知的技能目錄尋找 */SKILL.md。
  3. 對於每個選取的技能,審計其後設資料、觸發條件清晰度、章節順序、內容預算、可操作性、決策閘門、輸出合約及本地參考。
  4. 回傳一份按技能分組的審計報告,標註嚴重程度及確切的建議變更。
  5. 在套用模式下,僅編輯安全問題,保留內容,必要時建立輔助檔案,然後重新整理或請求 /skill-registry:refresh。

輸出合約

回傳:

  • 已審計的技能及使用的路徑。
  • 發現的問題,按嚴重程度分組。
  • 若請求了套用模式,則列出已變更的檔案。
  • 當技能後設資料或路徑變更時,給出註冊表重新整理的建議。
  • 需要人工審查的模糊之處。

參考資料

  • docs/skill-style-guide.md — 規範性的 LLM-first 技能風格指南。
  • skills/skill-registry/SKILL.md — 註冊表重新整理與索引合約。

Individual skills in this repo

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

相關技能