Community程式設計與開發github.com

Gentle-Programming/gentle-ai-skill-registry

在安裝、移除、建立、移動或重新命名技能後,或當委派者需要全新的技能索引時,觸發此技能以索引所有可用的技能。

gentle-ai-skill-registry 是什麼?

這是一個專為 AI 代理(如 Claude Code、Cursor、Codex)設計的技能註冊表管理工具。其主要功能是掃描使用者與專案中的所有技能目錄,產生一個統一的索引檔案 `.atl/skill-registry.md`,讓代理能夠根據觸發詞(trigger)和路徑快速找到並委派適當的技能。工具會自動去重(優先保留專案層級技能)、跳過 `sdd-*`、`_shared` 等特殊目錄,並在可用時將註冊表保存至 Engram 記憶系統。當代理需要委派工作時,它會選取相符的註冊表行,並傳遞對應 `SKILL.md` 的確切路徑,確保保留作者原始意圖而不會自動生成或壓縮規則。

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

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

在你喜歡的 AI 中提問

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

說明文件

啟用合約

在安裝、移除、建立、移動或重新命名技能後,或當委派者需要全新的技能索引時,使用此技能。

硬性規則

  • 註冊表是一個索引,而非編譯器或摘要。SKILL.md 保留為唯一事實來源。
  • 預設情況下,不要生成或注入精簡規則;透過將確切的技能路徑傳遞給子代理來保留作者意圖。
  • 無論 SDD 持久化模式為何,一律寫入 .atl/skill-registry.md。
  • 當可用時,將註冊表儲存至 Engram,使用 topic_key: skill-registry,並設定 capture_prompt: false。
  • 跳過 sdd-*、_shared 和 skill-registry;依據技能名稱去重,優先選擇專案層級技能而非使用者層級技能。
  • 如果可能,將 .atl/ 加入 .gitignore,除非明確停用。

決策閘道

情境動作
全域與專案中存在相同技能保留專案層級技能
多個全域位置中存在相同技能保留掃描順序中的第一個來源
找不到任何技能寫入空的註冊表,讓代理停止盲目搜尋
代理將委派工作選取相符的註冊表行,並傳遞其 SKILL.md 路徑

執行步驟

  1. 掃描所有已知的使用者與專案技能目錄,尋找 */SKILL.md。
  2. 僅在需要時讀取 frontmatter,以提取 name 和 description 觸發文字。
  3. 使用掃描到的來源、註冊表合約、技能名稱、觸發詞/描述、範圍與確切路徑,渲染 .atl/skill-registry.md。
  4. 當可用時,使用 title: skill-registry、topic_key: skill-registry、type: config 與 capture_prompt: false 持久化至 Engram。
  5. 回傳註冊表路徑、技能數量、快取狀態,以及 Engram 是否已更新。

輸出合約

回傳:

  • 專案名稱與 .atl/skill-registry.md 路徑。
  • 已索引的技能數量。
  • 是否命中快取或重新生成。
  • 任何跳過或重複的技能(當相關時)。

參考資料

  • docs/skill-style-guide.md — 技能在索引前應如何撰寫。
  • skills/_shared/skill-resolver.md — 委派者如何使用索引。

Individual skills in this repo

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

相關技能