Claude Code 插件系统完全指南：创建、分发和管理自定义插件

mkdir my-first-plugin
mkdir my-first-plugin/.claude-plugin

// my-first-plugin/.claude-plugin/plugin.json
{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

mkdir -p my-first-plugin/skills/hello

<!-- my-first-plugin/skills/hello/SKILL.md -->
---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude --plugin-dir ./my-first-plugin
# 在会话中输入：
/my-first-plugin:hello

my-plugin/
├── .claude-plugin/
│   └── plugin.json        # Manifest（只有这个放在 .claude-plugin 里）
├── skills/                 # 自定义 Skills
│   └── pdf-processor/
│       ├── SKILL.md
│       ├── reference.md
│       └── scripts/
├── agents/                 # 自定义 Agent
│   └── code-reviewer.md
├── hooks/                  # 事件钩子
│   └── hooks.json
├── commands/               # 简单命令
│   └── deploy.md
└── mcp/                    # MCP Server 配置

---
description: Greet the user with a personalized message
---
# Hello Skill
Greet the user named "$ARGUMENTS" warmly.

---
name: code-reviewer
description: Specialized code review agent
model: sonnet
effort: medium
maxTurns: 20
disallowedTools: Write, Edit
---

You are a code review specialist...

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format-code.sh"
          }
        ]
      }
    ]
  }
}

# 从目录安装
/plugin install-dir ./path/to/plugin

# 从 Marketplace 安装
/plugin install my-plugin@marketplace-name

{
  "version": "2.1.0"
}