【学习笔记】Claude Code 插件系统概览

┌──────────────────────────────────────────────────┐
│               Claude Code 插件                    │
├──────────┬──────────┬──────────┬─────────────────┤
│ skills/  │ agents/  │ hooks/   │ .mcp.json       │
│ 复用指令  │ 隔离任务  │ 自动触发  │ 外部工具连接     │
├──────────┼──────────┼──────────┼─────────────────┤
│ .lsp.json│ output-  │ themes/  │ monitors/       │
│ 代码智能  │ styles/  │ 视觉主题  │ 后台监听         │
│          │ 回答风格  │          │                 │
├──────────┴──────────┴──────────┴─────────────────┤
│ bin/  — 可执行脚本，加入 PATH                      │
└──────────────────────────────────────────────────┘

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── hello/
        └── SKILL.md

{
  "name": "my-plugin",
  "displayName": "My Plugin",
  "description": "A minimal Claude Code plugin example.",
  "version": "1.0.0"
}

---
description: Say hello to the user.
---

# Hello

Tell the user: "Hello from my-plugin! 👋"

claude --plugin-dir /path/to/my-plugin

my-plugin/
├── .claude-plugin/
│   ├── plugin.json           ← 插件身份（必需）
│   └── marketplace.json      ← marketplace 分发（可选）
│
├── skills/                   ← 可复用指令包
│   └── deploy/SKILL.md
│
├── agents/                   ← 自定义 subagent
│   └── reviewer.md
│
├── hooks/
│   └── hooks.json            ← 生命周期事件自动触发
│
├── .mcp.json                 ← 外部工具连接器（MCP server）
│
├── .lsp.json                 ← 代码智能（LSP server）
│
├── output-styles/            ← 回答风格
│   └── teacher.md
│
├── themes/                   ← 终端视觉主题
│   └── dark-pro.json
│
├── monitors/
│   └── monitors.json         ← 后台长驻命令
│
└── bin/                      ← 加入 PATH 的可执行脚本
    └── my-tool.js

{
  "name": "glm-statusline",
  "displayName": "GLM StatusLine",
  "description": "Configurable GLM / Z.ai usage status line for Claude Code.",
  "version": "1.2.3",
  "author": {
    "name": "CCStatusline",
    "email": "optional@example.com",
    "url": "https://example.com"
  },
  "homepage": "https://code.claude.com/docs/en/statusline",
  "license": "MIT",
  "keywords": [
    "claude-code",
    "statusline",
    "glm"
  ]
}

{
  "name": "bingqiangzhou-tools",
  "owner": {
    "name": "CCStatusline"
  },
  "description": "Local marketplace for Claude Code plugins.",
  "version": "1.2.3",
  "plugins": [
    {
      "name": "glm-statusline",
      "displayName": "GLM StatusLine",
      "source": "./",
      "description": "Configurable GLM / Z.ai usage status line.",
      "version": "1.2.3",
      "author": {
        "name": "CCStatusline"
      },
      "category": "interface",
      "tags": ["statusline", "glm"]
    }
  ]
}

# 1. 添加 marketplace
/plugin marketplace add /path/to/plugin-directory

# 2. 从 marketplace 安装插件
/plugin install glm-statusline@bingqiangzhou-tools

# 3. 更新插件
claude plugin update glm-statusline@bingqiangzhou-tools

/plugin install plugin-name@marketplace-name

claude plugin update plugin-name@marketplace-name

/plugin uninstall plugin-name@marketplace-name

/reload-plugins

cd /path/to/my-plugin
claude --plugin-dir .

/plugin marketplace add /path/to/my-plugin
/plugin install my-plugin@my-marketplace

/my-plugin:skill-name

/my-plugin:install --show=plan,5h,context

node bin/my-script.js

echo '{"model":{"display_name":"Sonnet"}}' | node bin/glm-statusline.js

/plugin list

package.json                   →  "version": "1.2.3"
.claude-plugin/plugin.json     →  "version": "1.2.3"
.claude-plugin/marketplace.json →  "version": "1.2.3" + plugins[].version

1. 修改三个文件的版本号
2. 运行验证脚本（npm test）
3. git commit + tag
4. 用户运行 claude plugin update