SDD-Full

一鍵將 AI Agent Skills 與 Rules 安裝至 Cursor、Claude、Gemini、Codex、TRAE、CodeBuddy 對應目錄的 npm 封裝工具。

快速開始

# 使用 npx 直接執行（無需安裝）
npx sdd-full-global@latest init

# 或全域安裝後執行
npm install -g sdd-full-global
sdd init

執行後，互動式 CLI 會引導你：

1. 選擇工具 — 多選 Cursor / Claude / Gemini / Codex / TRAE / CodeBuddy
2. 自動安裝 — 偵測 OS，將 Skills 與 Rules 一併寫入對應目錄

Cursor：官方 User Rules 面板只顯示 Settings 文字規則，~/.cursor/rules 也不會出現在 UI。
因此 Cursor 改以 local plugin 安裝至 ~/.cursor/plugins/local/sdd-full/（含 rules/ + skills/ + .cursor-plugin/plugin.json）。
請開啟 Customize 的「Include third-party Plugins…」，再 Reload Window，即可在 User / All 看到。

Skills 安裝路徑

| 工具 | Windows | macOS / Linux | 範圍 | |-----------|----------------------------------------------------------------------|----------------------------------------------------|-------------| | Cursor | %USERPROFILE%\.cursor\plugins\local\sdd-full\skills\ | ~/.cursor/plugins/local/sdd-full/skills/ | User plugin | | Claude | %USERPROFILE%\.claude\skills\ | ~/.claude/skills/ | User | | Gemini | %USERPROFILE%\.gemini\skills\ | ~/.gemini/skills/ | User | | Codex | %USERPROFILE%\.codex\skills\ | ~/.codex/skills/ | User | | TRAE | %USERPROFILE%\.trae-cn\skills\ | ~/.trae-cn/skills/ | User | | | %USERPROFILE%\.trae\skills\ | ~/.trae/skills/ | User | | CodeBuddy | %USERPROFILE%\.codebuddycn\skills\ | ~/.codebuddycn/skills/ | User | | | %USERPROFILE%\.codebuddy\skills\ | ~/.codebuddy/skills/ | User |

每個 skill 為一個獨立資料夾（含 SKILL.md），格式所有工具通用，直接整份複製。

Rules 安裝路徑

各工具的 rules 機制不同，安裝器會依工具轉換副檔名與 frontmatter 欄位。

| 工具 | 目標 | 模式 | 副檔名 | frontmatter | 範圍 | |-----------|------------------------------------------------------------------------|------|--------|-------------|-------------| | Cursor | ~/.cursor/plugins/local/sdd-full/rules/ | 目錄 | .mdc | globs | User plugin | | Claude | ~/.claude/rules/ | 目錄 | .md | paths | User | | TRAE | ~/.trae-cn/rules/、~/.trae/rules/ | 目錄 | .md | globs | User | | CodeBuddy | ~/.codebuddycn/rules/、~/.codebuddy/rules/ | 目錄 | .md | paths | User | | Gemini | ~/.gemini/GEMINI.md | 合併 | — | 移除 | User | | Codex | ~/.codex/AGENTS.md | 合併 | — | 移除 | User |

兩種模式

目錄模式 — 每條規則寫成一個獨立檔案，保留 frontmatter 並轉換為目標工具的原生欄位：

| frontmatter 風格 | 適用工具 | 欄位 | |------------------|---------------------|-----------------------------------------| | globs | Cursor、TRAE | description、globs、alwaysApply | | paths | Claude、CodeBuddy | description、paths（YAML 清單）、alwaysApply |

合併模式 — Gemini 與 Codex 沒有使用者級的 rules 目錄，改為把所有規則合併寫入單一指引檔：

• Gemini 的全域指引為單一檔案 ~/.gemini/GEMINI.md
• Codex 的全域指引為 ~/.codex/AGENTS.md；~/.codex/rules/ 是沙箱執行政策（Starlark .rules），不是行為規則，不可混用

合併時只覆寫受管理區塊，區塊外的既有內容一律保留：

<!-- BEGIN SDD-FULL RULES -->
<!-- 由 sdd-full 產生，此區塊內的手動修改會在下次安裝時被覆寫 -->
...
<!-- END SDD-FULL RULES -->

重複執行 sdd init 只會更新此區塊，不會產生重複內容。

目錄結構

SDD-Full/
├── bin/
│   ├── cli.js                # sdd init 入口
│   └── post-install.js       # 安裝後提示
├── lib/
│   ├── config.js             # 載入 sdd.config.json
│   ├── paths.js              # OS-aware 路徑解析
│   ├── skills-installer.js   # 複製 skills 至目標目錄
│   └── rules-installer.js    # 轉換 frontmatter / 合併寫入指引檔
├── Skills/                   # 所有工具共用（格式相同，一份即可）
├── Rules/                    # 規則來源（`.mdc`，安裝時依工具轉換）
├── sdd.config.json           # 主設定檔（工具路徑與 rules 模式）
└── package.json

自訂路徑

在執行目錄放一份 sdd.config.json 即可覆蓋內建設定；未提供時使用套件內建值。將 enabled 設為 false 可從選單中移除該工具。

License

MIT