Create Plugin — 建立新 Plugin 完整流程

Create Plugin — 建立新 Plugin 完整流程

建立新的 Claude Code Plugin，包含目錄結構、manifest、CLAUDE.md、marketplace 同步、GitHub Issue 追蹤。

兩種模式

模式	觸發	說明
New	/plugin-tools:create-plugin my-plugin	從零建立全新 plugin
Convert	/plugin-tools:create-plugin convert skill-name	從現有 .claude/skills/ 轉換成 plugin

Execution Steps

Step 0: Parse Arguments

$ARGUMENTS 格式：
- "my-plugin" → New mode
- "convert codex-review" → Convert mode（從 .claude/skills/codex-review 轉換）
- "convert codex-review issue" → Convert mode（合併多個 skill 成一個 plugin）

Step 1: Gather Info (AskUserQuestion)

問以下問題（缺的才問）：

1. Plugin name（kebab-case）
2. Description（一句話描述）
3. Category（development / productivity / documentation / other）
4. Target repo（預設 PsychQuant/psychquant-claude-plugins）
5. Components：要包含哪些？（skills / commands / agents / hooks / MCP）

Step 2: Locate Plugin Marketplace Repo

# 找到 marketplace repo 的本地路徑
# 預設：/Users/che/Developer/psychquant-claude-plugins
MARKETPLACE_ROOT=$(git -C "$PLUGIN_SOURCE" rev-parse --show-toplevel 2>/dev/null)

如果找不到，問使用者 marketplace repo 的路徑。

Step 3: Create Directory Structure

PLUGIN_DIR="$MARKETPLACE_ROOT/plugins/{plugin-name}"

mkdir -p "$PLUGIN_DIR/.claude-plugin"
mkdir -p "$PLUGIN_DIR/skills"   # if skills selected
mkdir -p "$PLUGIN_DIR/commands" # if commands selected
mkdir -p "$PLUGIN_DIR/agents"   # if agents selected
mkdir -p "$PLUGIN_DIR/hooks"    # if hooks selected

Step 4: Create plugin.json

{
  "name": "{plugin-name}",
  "description": "{description}",
  "version": "1.0.0",
  "author": {
    "name": "Che Cheng"
  }
}

Step 5: Convert or Create Skills

Convert Mode

對每個要轉換的 skill：

1. 讀取 .claude/skills/{skill-name}/SKILL.md
2. 複製到 $PLUGIN_DIR/skills/{skill-name}/SKILL.md
3. 更新 SKILL.md 的 description（加上 plugin context）
4. 如果有 references/ 子目錄，一併複製

New Mode

為每個 skill 建立骨架 SKILL.md：

---
name: {skill-name}
description: |
  {skill description}
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - AskUserQuestion
---

# {Skill Title}

## Purpose

{TODO: describe what this skill does}

## Execution Steps

### Step 1: {TODO}

{TODO}

Step 6: Generate CLAUDE.md

自動在 plugin 根目錄產生 CLAUDE.md：

# {plugin-name} — CLAUDE.md

## Purpose

{description}

## Skills

| Skill | 用途 |
|-------|------|
| `/plugin-tools:{skill-1}` | {skill-1 description} |
| `/plugin-tools:{skill-2}` | {skill-2 description} |

## Development

- Plugin structure: see [official plugin-dev](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/plugin-dev)
- Update after changes: `/plugin-tools:plugin-update {plugin-name}`
- Health check: `/plugin-tools:plugin-health`

Step 7: Update marketplace.json

讀取現有 $MARKETPLACE_ROOT/.claude-plugin/marketplace.json，在 plugins 陣列末尾新增：

{
  "name": "{plugin-name}",
  "version": "1.0.0",
  "description": "{description}",
  "author": {
    "name": "Che Cheng"
  },
  "source": "./plugins/{plugin-name}",
  "category": "{category}"
}

注意：不要覆蓋整個檔案，用 Edit tool 在最後一個 plugin entry 後面插入。

Step 8: Commit & Push

cd "$MARKETPLACE_ROOT"
git add "plugins/{plugin-name}" ".claude-plugin/marketplace.json"
git commit -m "feat: Add {plugin-name} plugin — {description}"
git push origin main

Step 9: Create GitHub Issue

gh issue create \
  --repo {target-repo} \
  --title "[PLUGIN] {plugin-name} — {description}" \
  --body "## New Plugin

Plugin \`{plugin-name}\` created.

### Components
- Skills: {list of skills}
- Commands: {list or 'none'}
- Agents: {list or 'none'}
- Hooks: {list or 'none'}

### Status
- [x] Directory structure created
- [x] plugin.json manifest
- [x] CLAUDE.md generated
- [x] marketplace.json updated
- [x] Committed and pushed
- [ ] Skills content (TODO: fill in SKILL.md bodies)
- [ ] Testing with \`claude --plugin-dir\`
- [ ] Plugin update: \`/plugin-tools:plugin-update {plugin-name}\`

### Convert Source
{if convert mode: list source .claude/skills/ paths}
{if new mode: 'Created from scratch'}
"

Step 10: Sync & Reload

# Sync marketplace
claude plugin marketplace update psychquant-claude-plugins

# Update installed plugins
claude plugin update {plugin-name}

提示使用者：

Plugin 已建立！接下來：
1. 填寫 skills/ 裡的 SKILL.md 內容
2. 用 `claude --plugin-dir ./plugins/{plugin-name}` 本地測試
3. 測試完成後執行 `/plugin-tools:plugin-update {plugin-name}` 同步

Convert Mode 特別注意

從 local skill 轉換時

1. 不要刪除 .claude/skills/ 裡的原始檔案 — 讓使用者自己決定何時移除
2. Skill 名稱會改變：/codex-review → /issue-driven-dev:codex-review（加 namespace）
3. allowed-tools 可能需要調整：local skill 可能用了 project-specific 路徑
4. References 目錄：如果 skill 有 references/ 子目錄，整個複製

合併多個 skill 到一個 plugin

/plugin-tools:create-plugin convert codex-review issue

這會把 .claude/skills/codex-review 和 .claude/skills/issue 合併到同一個 plugin。 Plugin 名稱由 Step 1 詢問使用者。

參考

• 官方 plugin 開發指南：https://github.com/anthropics/claude-plugins-official/tree/main/plugins/plugin-dev
• Plugin 結構規範：https://code.claude.com/docs/en/plugins.md
• Plugin 技術參考：https://code.claude.com/docs/en/plugins-reference.md