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）的开发者。