Claude Code Pluginを作成してチームで共有する

# グローバル（全プロジェクト使用）
~/.claude/skills/your-skill-name/
├── SKILL.md (必須)
└── (その他サポートファイル)

# プロジェクト固有の場合
<your project>/.claude/skills/your-skill-name/
├── SKILL.md (必須)
└── (その他サポートファイル)

---
name: skill-name
description: |
  スキルの説明。いつ使用するか。
  トリガーとなるフレーズやユースケースなどをシンプルに記述。
---

# Skill Documentation

## Instructions
手順やガイドライン

## Examples
具体的な使用例

# グローバル（全プロジェクト使用）
~/.claude/agents/agent-name.md

# プロジェクト固有の場合
<project-root>/.claude/agents/agent-name.md

# Plugin経由
<plugin>/agents/agent-name.md

---
name: agent-name
description: いつ、なぜこのSubagentを使用するか
tools: Read, Grep, Glob, Bash  # オプション
model: sonnet  # オプション
skills: skill1, skill2  # オプション（自動読み込みするSkills）
---

Subagentのシステムプロンプト。
役割、能力、具体的な指示を記述...

Subagent A (プログラマー) → Skill-1 (tsプログラミング)
Subagent B (テスター) → Skill-2 (テスト実行)
Subagent C (AWSアーキテクト) → Skill-1 (tsプログラミング)、Skill-3(AWSシステム構築)

my-plugin/
├── plugin.json           # Plugin設定（必須）
├── README.md             # 説明（推奨）
├── commands/             # スラッシュコマンド
│   └── my-command.md
├── agents/               # サブエージェント
│   └── my-agent.md
├── skills/               # Skills
│   └── my-skill/
│       └── SKILL.md
├── mcp-servers/          # MCPサーバ設定
│   └── config.json
└── hooks/                # フック設定
    └── hooks.json

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "プラグインの説明",
  "author": "作者名",
  "repository": "https://github.com/hoge/fuga",
  "license": "MIT",
  "keywords": ["code-review", "security"]
}

% mkdir -p ~/dev-marketplace/plugins/database-migration-plugin
% cd ~/dev-marketplace/plugins/database-migration-plugin

# 各コンポーネントのディレクトリ
% mkdir -p skills/migration-best-practices
% mkdir -p agents commands hooks scripts db migrations

---
name: migration-best-practices
description: |
  データベースマイグレーションのベストプラクティス。
  スキーマ変更時に自動適用される。
---

# Database Migration Best Practices

## 命名規則

- ファイル名: `YYYYMMDDHHMMSS_description.sql`
- 例: `20250121120000_add_user_email.sql`

## マイグレーションルール

### UP Migration（適用）
- 必ずトランザクション内で実行
- カラム追加は`NOT NULL`制約に注意（デフォルト値を設定）
- インデックス作成は大規模テーブルでは段階的に

### DOWN Migration（ロールバック）
- すべてのUPに対応するDOWNを必ず用意
- データ損失の可能性がある変更は警告コメント必須

## 禁止事項

- 既存マイグレーションファイルの変更禁止
- 本番環境で直接DDL実行禁止
- カラム削除前にデータ確認必須

---
name: migration-planner
description: データベーススキーマ変更を安全に計画。マイグレーション作成依頼時に使用。
tools: Read, Write, Grep, Glob, Bash
model: sonnet
skills: migration-best-practices
---

あなたはデータベースアーキテクトです。
migration-best-practices Skillに従って安全なマイグレーションを計画してください。

## マイグレーション生成手順

1. 既存スキーマを確認（migrations/ディレクトリ内のファイル）
2. 変更内容の影響を分析
3. migration-best-practices Skillの規則に従ってUP/DOWNを生成
4. タイムスタンプ付きファイル名で保存

## 注意点

- 破壊的変更（カラム削除、型変更）は警告を含める
- 外部キー制約の順序に注意
- インデックス作成は別マイグレーションに分離を推奨

---
description: データベースマイグレーションファイルを生成
---

migration-plannerエージェントを使って、以下の変更に対するマイグレーションファイルを生成してください。

変更内容:
$ARGUMENTS

生成先: migrations/ディレクトリ

{
  "description": "Migration safety check hook",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/migration-check.sh",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

#!/bin/bash

# stdinからJSONを読み取る
INPUT=$(cat)

# jqでfile_pathを抽出（jqがない場合はgrepで代替）
if command -v jq &> /dev/null; then
    FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
else
    FILE_PATH=$(echo "$INPUT" | grep -o '"file_path":"[^"]*"' | cut -d'"' -f4)
fi

# マイグレーションファイルかどうかチェック
if echo "$FILE_PATH" | grep -q "migrations/.*\.sql"; then
    echo "⚠️  データベースマイグレーション実行前の確認:" >&2
    echo "  - ロールバック手順は準備済みですか？" >&2
    echo "  - バックアップは取得しましたか？" >&2
    echo "  - 影響範囲を確認しましたか？" >&2
    exit 1  # exit 1: 警告表示してツール実行継続
fi

exit 0  # exit 0: 出力なし

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": [
        "mcp-server-sqlite",
        "--db-path",
        "${SQLITE_DB_PATH:-./db/database.db}"
      ]
    }
  }
}

% export SQLITE_DB_PATH="./my-project/database.db"
OR
% SQLITE_DB_PATH="./my-db/data.db" claude

% cd ~/dev-marketplace/plugins/database-migration-plugin
% mkdir -p .claude-plugin

{
  "name": "database-migration-plugin",
  "version": "1.0.0",
  "description": "SQLite3マイグレーション管理を自動化するPlugin",
  "author": {
    "name": "Your Team"
  }
}

database-migration-plugin/                    
├── .claude-plugin/
│   └── plugin.json                          # プラグインマニフェスト
├── .mcp.json                                # MCP Server設定
├── agents/
│   └── migration-planner.md                 # Subagent
├── commands/
│   └── migrate.md                           # Slash Command
├── skills/
│   └── migration-best-practices/
│       └── SKILL.md                         # Skill
├── hooks/
│   └── hooks.json                           # Hook設定
└── scripts/
    └── migration-check.sh                   # Hookスクリプト

% claude

# インストール
> /plugin install https://github.com/your-team/database-migration-plugin

# 確認
> /plugin

% mkdir -p .claude

{
  "enabledPlugins": [
    "https://github.com/nakamura-shuta/dev-marketplace.git"
  ]
}

# プロジェクトリポジトリを取得(clone)
# ※プラグインのリポジトリではないです
% cd your-project

# Claude Codeを起動
% claude

# 自動検出してインストールするか尋ねられる

> /plugin 
╭──────────────────────────────────────────────────────────────────╮
│ Plugins                                                          │
│                                                                  │
│ ❯ 1. Browse and install plugins                                  │
│   2. Manage and uninstall plugins                                │
│   3. Add marketplace                                             │
│   4. Manage marketplaces                                         │
╰──────────────────────────────────────────────────────────────────╯

> /plugin 
╭──────────────────────────────────────────────────────────────────╮
│ Add Marketplace                                                  │
│                                                                  │
│ Enter marketplace source:                                        │
│ Examples:                                                        │
│  • owner/repo (GitHub)                                           │
│  • git@github.com:owner/repo.git (SSH)                           │
│  • https://example.com/marketplace.json                          │
│  • ./path/to/marketplace                                         │
│                                                                  │
│                                                                  │
╰──────────────────────────────────────────────────────────────────╯

> usersテーブルにemail列を追加するマイグレーションを作成して

> migration-plannerエージェントを使って、
> postsテーブルにpublished_at列（DATETIME型、NULL許可）を追加するマイグレーションを作成

> /database-migration-plugin:migrate usersテーブルにis_active列（BOOLEAN、デフォルト1）を追加

> migrations/002_add_posts.sql を作成してCREATE TABLE postsの内容を書いてください

PreToolUse:Write says: Plugin hook error: ⚠️  データベースマイグレーション実行前の確認:
  - ロールバック手順は準備済みですか？
  - バックアップは取得しましたか？
  - 影響範囲を確認しましたか？

> hoge.dbの現在のテーブル構造を教えて