yibie/skills-manager

Skills Manager – 用於組織 LLM 編碼代理 skills 的 macOS UI

是什麼

• 一款使用 SwiftUI/Swift 6 編寫的原生 macOS（Sonoma +）應用程式，可讓你發現、安裝、測試與組織適用於大量程式碼生成代理（如 Claude Code、Cursor、Gemini CLI、OpenHands 等）的 skills（以提示為導向的擴充）。
• 以本地檔案系統作為唯一可信來源：Library 儲存原始技能套件，Collections 將其分組用於專案或工作流程，Mounts 按需建立符號連結至每個代理自身的技能目錄中。

核心概念

層級	作用
Library	所有已下載技能套件的中央唯讀儲存庫。
Collection	Library 中技能的可重用命名組（例如 Web‑dev、Data‑Science）。
Mount	一組符號連結，將一個 Collection 無複製地暴露於一個或多個代理中。

主要功能

• 發現 – 從公開的 skills.sh 目錄拉取技能列表，本地快取，並在連線時支援全站搜尋。
• 試用 – 在確認安裝前，可對本地設定的 LLM（Claude、OpenAI、OpenRouter、Ollama、LM Studio）執行技能進行測試。
• 安裝 / 卸載 – 一鍵安裝至任意支援的代理子集；卸載僅移除符號連結，保留 Library 不變。
• 衝突與狀態檢視 – 顯示跨代理的遺失、共享、部分套用或分歧副本，支援手動解決。
• 翻譯 – 內建 8 語言技能描述目錄，新條目支援按需呼叫 LLM 作為後備。
• 終端 UI – 一個 blessed 風格的 TUI（tui/），功能與 macOS 應用完全一致，並保留本地 Git 歷史用於回滾。
• 自動監控 – 監控代理的技能資料夾，當磁碟檔案變更時自動刷新 UI。

支援的代理（透過內部 AgentRegistry 檢測）。README 中列出超過 40 個代理；標有 Install target 的可在多安裝選擇器中選擇，其餘仍用於衝突掃描。

安裝

1. 從 GitHub 發布頁面下載簽署的 zip 包，拖曳至 Applications（需 macOS 14+）。
2. 或使用 Xcode 建構原始碼（open SkillsManager.xcodeproj）。
3. 對於 TUI，cd tui && npm exec skills-manager（或 npm link 以全域安裝 skills-manager 命令）。

架構與離線優先策略

• 完全本地優先：無遠端後端，除非你顯式刷新目錄、翻譯描述或呼叫 LLM 進行 Try，否則資料不會離開裝置。
• 應用程式直接寫入每個代理的設定檔，並維護本地 Git 日誌以支援差異對比與回滾。
• 發現資料快取於 ~/.skills-manager/cache/discover-directory.json；網路僅用於目錄刷新、全站搜尋、翻譯後備和 LLM Try 呼叫。

路線圖（截至 README）

• 發現技能的自動更新檢測（計畫中）
• 技能集的匯出/匯入（計畫中）
• 透過共享倉儲實現團隊級同步（計畫中）

許可證 – MIT。

---

Skills Manager 是為使用多個 LLM 基礎編碼助手的開發者量身打造的真實、生產級工具，提供統一方式管理日益成長的代理專用提示擴充生態。