Solidjskills

🚀 SolidJSkills

这是一个专注于SolidJS的技能、指南和文档集合，可通过模型上下文协议（MCP）与AI代理协作，助力开发者更好地使用SolidJS进行开发。

🚀 快速开始

MCP服务器可让你的AI代理与本仓库进行通信，它包含在 mcp-server 目录中。

📦 安装指南

安装MCP服务器

cd mcp-server
npm install

你可以测试它是否能正确启动（它使用标准输入输出，因此会等待输入）：

node src/index.js

(按 Ctrl+C 退出)

与Gemini - CLI（主要方式）进行配置

本项目最初是为Gemini - CLI构建的，因此推荐使用此配置方式。

方法1：使用gemini - extension.json（推荐） 最简单的方法是使用包含的 gemini-extension.json 文件：

1. 将 gemini-extension.json 复制或创建符号链接到你的Gemini - CLI扩展目录。
2. 编辑路径，使其指向你本地克隆的本仓库。

方法2：手动配置 如果你更喜欢手动配置，请参阅 GEMINI.md 文件以获取详细的设置说明。

与其他IDE进行配置

Windsurf / Cascade

将以下内容添加到你的 ~/.codeium/windsurf/mcp_config.json 文件中：

{
  "mcpServers": {
    "solidjskills": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solidJSkills/mcp-server/src/index.js"],
      "cwd": "/ABSOLUTE/PATH/TO/solidJSkills/mcp-server"
    }
  }
}

注意：将 /ABSOLUTE/PATH/TO/... 替换为你机器上的实际路径。

Cursor

1. 打开 Cursor设置 > 功能 > MCP。
2. 点击 + 添加新的MCP服务器。
3. 填写：
   • 名称：solidjskills
   • 类型：command
   • 命令：node /ABSOLUTE/PATH/TO/solidJSkills/mcp-server/src/index.js
4. 点击 保存

Antigravity及其他MCP客户端

大多数MCP客户端需要一个命令来启动服务器。使用：

• 命令：node
• 参数：/ABSOLUTE/PATH/TO/solidJSkills/mcp-server/src/index.js

✨ 主要特性

当你将AI代理连接到本项目时，它将获得：

• SolidJS知识：关于SolidJS v2模式、响应式编程、路由、服务器端渲染（SSR）等方面的指南和参考资料。
• 特定技能：用于重构、测试、构建组件、代码审查和项目搭建的工作流程。
• 验证工具：用于检查代码是否遵循SolidJS最佳实践的脚本。

此外，本仓库还提供了关于构建自己的技能、创建规则和设置工作流程的实用指南，如果你正在构建自己的MCP技能项目，这些内容将非常有帮助。

🤝 贡献代码

你是否想添加新技能或改进文档？以下是操作方法：

1. 添加技能：在 skills/ 目录下创建一个新目录（例如，skills/solid-my-new-skill/），并添加一个 SKILL.md 文件。有关格式，请参阅 tools/templates/SKILL-template.md。
2. 添加文档：将详细的文档放在 references/ 目录中。
3. 改进指南：guides/ 目录包含了构建技能、创建规则和设置工作流程的说明。你可以自由改进这些内容或添加新的指南。

如果你想了解底层的工作原理，请参阅 架构文档。

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE。