local-skills-mcp-guide

本指南是 local-skills-mcp 儲存庫的完整技術參考，這是一個開源的 Model Context Protocol 伺服器。專為希望整合、擴充或深入了解程式碼庫的開發者所設計，使 AI 代理程式能夠從本地檔案系統存取模組化技能。系統利用 TypeScript 和官方 MCP SDK，為技能管理提供強大且上下文高效的介面。

• src/index.ts 中的核心實作細節，涵蓋伺服器初始化、傳輸管理和工具註冊。

• 對 skill-loader.ts 引擎的深入解釋，詳述系統如何執行多目錄技能發現、YAML 前置格式解析以及元資料合併。

• 關於技能目錄優先權和覆蓋行為的說明，包括使用者自訂路徑、專案特定目錄及內建儲存庫。

• 關於代理程式如何執行技能指令的懶載入（Lazy Loading）以優化上下文視窗的操作洞察。

• 程式碼庫導航指南，包括 types.ts 在定義技能綱要與整合測試結構中的角色。

• 關於 SKILL.md 格式的實用文件，強調必需的 YAML 元資料欄位與載入器中的驗證規則。

• 在審查 index.ts 與 skill-loader 模組之間的互動以進行自訂部署時使用本指南。

• 參考此文件以排解工具呼叫問題或評估自訂技能邏輯。

• 伺服器預期技能為具有清晰名稱與描述前置格式的有效 Markdown 檔案，這對於有效發現至關重要。

• 請注意技能會依特定順序載入：全域 ~/.claude/skills、專案本地資料夾，接著是內部的 ./skills 目錄，後面的路徑會覆蓋前面的路徑。

• 非常適合希望建立本地、注重隱私的 AI 代理，或擴充既有 MCP 相容客戶端（如 Claude Desktop、Cline 或 Continue）的開發者。