用途:本指南用於開發、發布、安裝、更新與同步 Claude Code Plugin,並管理自訂 Marketplace,適用於新 Plugin 開發、上架 Marketplace、版本控管與同步等場景。
目錄結構:Plugin 根目錄須含 .claude-plugin/plugin.json(必要 manifest)與選用 marketplace.json;commands/、skills/、hooks/、agents/ 等組件目錄必須放在根目錄,不可放入 .claude-plugin/,另有 .mcp.json、CHANGELOG.md、README.md。
四大組件:Commands 為使用者手動執行的斜線命令(Markdown);Skills 依上下文自動觸發(SKILL.md);Hooks 由事件驅動(JSON+Shell);MCP 提供工具能力(.mcp.json)。
發布方式:GitHub Marketplace 需建立 marketplace.json 並 git tag 推送,使用者以 /plugin marketplace add owner/repo 與 /plugin install my-plugin@my-marketplace 安裝;npm 發布可用 claude-plugin- 前綴套件名;也可直接分享後以 /plugin install /path/to/my-plugin 本地安裝。
安裝與更新:支援 /plugin marketplace list、/plugin install、/plugin list、/plugin info、/plugin uninstall(可加 --force),以及 /plugin update --check、/plugin update、/plugin update --all。
版本控管:版本須同步於 plugin.json、marketplace.json、SKILL.md、CHANGELOG.md 與 Git tag,採語意化版本。同步可複製 skills 目錄或透過 GitHub Actions 自動化。
Hooks:涵蓋 PreToolUse、PostToolUse、UserPromptSubmit、SessionStart、SessionEnd、Stop、SubagentStop 等事件。
限制與注意:解除安裝不會移除 marketplace;依賴其他 Plugin 時會警告;Hook 以使用者權限執行,需限定範圍與安全檢查;MCP 須使用信任來源以防 Prompt Injection;發布前可用 claude-code --plugin-dir /path/to/my-plugin 測試。官方價格與其他平台細節暫未提供。