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。