Directories - Cursor 和 Windsurf 社群規則與 MCP 伺服器目錄

專案概述

Directories 是一個專為 Cursor 和 Windsurf 社群設計的開源專案，主要提供規則（Rules）和 MCP（Model Context Protocol）伺服器的集中管理與分享平台。該專案由 Pontus Abrahamsson 開發維護，旨在幫助開發者更好地利用 AI 輔助程式設計工具。

主要功能

1. 規則管理系統

• 集中化規則儲存: 將各種開發規則和提示詞集中管理在 packages/data/rules/ 目錄下
• 標準化格式: 每個規則都包含統一的參數格式，確保一致性和可用性
• 分類管理: 按照程式語言、框架或工具進行分類組織

2. 社群貢獻機制

• 開放貢獻: 任何開發者都可以提交新的規則或改進現有規則
• 規範化流程: 提供詳細的貢獻指南，確保程式碼品質和規範性
• 測試驗證: 要求貢獻者測試提示詞，確保其在相關開發環境中正常運作

3. MCP 伺服器整合

• MCP 支援: 支援 Model Context Protocol，增強 AI 工具的互動能力
• 多工具相容: 同時支援 Cursor 和 Windsurf 兩大主流 AI 程式設計工具

技術架構

專案結構

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # 規則索引檔案
│           └── rules/            # 具體規則檔案目錄
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # Cursor 相關配置
│   └── windsurf/                 # Windsurf 相關配置

規則定義格式

每個規則檔案需要包含以下標準參數：

{
  tags: ["JavaScript", "Next.js"],           // 語言特定標籤
  title: "Next.js Best Practices",           // 規則標題
  slug: "nextjs-best-practices",             // 唯一識別符
  content: `your amazing prompt`,            // 提示詞內容
  author: {                                  // 作者資訊
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

使用方法

開發環境建置

# 安裝依賴
npm install

# 啟動開發伺服器
npm run dev
# 或者
yarn dev
# 或者
pnpm dev
# 或者
bun dev

# 造訪 http://localhost:3000

新增規則

1. 定位規則索引: 在 packages/data/rules/index.ts 檔案中新增規則的導入

   import { cRules } from "./rules/c";
   

2. 建立規則檔案: 在 packages/data/rules/ 目錄下建立新的規則檔案

   // 例如：nextjs.ts
   export const nextjsRules = {
     // 規則定義
   };
   

3. 定義規則內容: 按照標準格式編寫規則，確保：

   • 準確性：與規則相關且準確
   • 清晰性：措辭清晰，便於開發者理解和使用
   • 可操作性：提供具體步驟或見解來解決常見問題

更新現有規則

1. 找到相關規則檔案
2. 在現有提示詞下方新增內容
3. 確保新增的內容經過測試驗證

社群特色

品質保證

• 測試要求: 所有提示詞必須經過測試驗證
• 準確性保證: 確保規則內容的準確性和實用性
• 持續改進: 社群持續維護和改進現有規則

開發者友善

• 詳細文件: 提供完整的貢獻指南和使用說明
• 標準化流程: 統一的規則格式和提交流程
• 認可機制: 透過作者資訊展示貢獻者的貢獻

工具整合

• 多編輯器支援: 同時支援 Cursor 和 Windsurf
• 即時應用: 支援自動應用規則，智能匹配檔案路徑模式
• MCP 整合: 支援 Model Context Protocol 協定，增強 AI 互動能力

專案優勢

1. 集中化管理: 將分散的規則和提示詞集中管理，便於查找和使用
2. 標準化格式: 統一的規則格式確保相容性和可維護性
3. 社群驅動: 開放的貢獻機制促進知識共享和持續改進
4. 工具無關: 同時支援多種 AI 程式設計工具，提高適用性
5. 品質保證: 嚴格的測試和驗證流程確保規則的有效性

應用場景

• AI 輔助程式設計: 為 Cursor 和 Windsurf 用戶提供最佳化的程式設計規則
• 團隊協作: 團隊可以共享和標準化程式設計規範
• 技能提升: 新手開發者可以學習最佳實踐
• 工具最佳化: 透過 MCP 協定增強 AI 工具的功能

總結

Directories 專案是一個專注於 AI 輔助程式設計的社群平台，透過集中管理規則和 MCP 伺服器配置，為開發者提供了一個標準化、高品質的資源庫。該專案不僅提高了開發效率，還促進了 AI 程式設計最佳實踐的傳播與應用。