単なるコードアシスタント以上:Pluginsで Claude Code をカスタムツールチェーンに構築する(1/4)

張三:「Claude、PROJ-1234 の決済タイムアウト問題の根本原因を分析してください。」

AI アシスタント:
1. [自動で JIRA をクエリ] 問題の説明とユーザーフィードバックを取得
2. [自動で GitLab を検索] 決済モジュールの最近のコード変更を特定
3. [自動で Grafana をクエリ] 問題発生時のパフォーマンスメトリクスを取得
4. [自動で Confluence を検索] 関連する技術ドキュメントを発見

総合分析結果:
根本原因:先週水曜日のコミット a3f9c2b が決済ゲートウェイのタイムアウト
設定を5秒から3秒に変更し、高並行性の状況下で断続的なタイムアウトを引き起こしました。
また、監視データによると、この期間中にサードパーティ決済インターフェースの
P99レイテンシが3.2秒に達し、新しいタイムアウト閾値を超えていました。

推奨ソリューション:
1. タイムアウト設定を5秒に戻すか、8秒に調整する
2. リトライメカニズムと降格戦略を追加
3. サードパーティ決済プロバイダーとSLA保証を確認

修正PRを作成しましょうか?

開発者:「このコードの何が問題ですか?」
AI:「ここにパフォーマンス問題がある可能性があります。クエリ文を最適化することをお勧めします。」
開発者:[手動でコードを修正] → [手動でテストを実行] → [手動でコミット]

開発者:「このコードのパフォーマンスを最適化し、テストを実行して検証してください。」
Claude Code:
1. [コードを分析] パフォーマンスボトルネックを特定
2. [最適化計画を生成] クエリロジックを改善
3. [test_runner_plugin を呼び出し] 自動的にユニットテストを実行
4. [profiler_plugin を呼び出し] 最適化前後のパフォーマンスを比較
5. [結果を報告]「最適化後のクエリ時間が230msから45msに短縮、すべてのテストが合格」

graph TB
    A[Claude Code] --> B[Slash Commands]
    A --> C[Subagents]
    A --> D[MCP Servers]
    A --> E[Hooks]

    B --> F[Quick Operation Entry<br/>User-triggered]
    C --> G[Specialized Task Agents<br/>Complex Task Division]
    D --> H[External Tool Connection<br/>Data & Service Integration]
    E --> I[Automation Triggers<br/>Workflow Critical Points]

    style A fill:#e1f5ff
    style B fill:#fff3e0
    style C fill:#f3e5f5
    style D fill:#e8f5e9
    style E fill:#fce4ec

# コードレビュー
/review-pr
→ 現在のブランチの変更を自動分析し、チームのコーディング標準と比較し、レビューレポートを生成

# ログ分析
/query-logs "payment error" --last 1h
→ 本番環境のログを検索し、決済関連のエラーをフィルタリングし、時間で集約

# チケット作成
/create-ticket "API Timeout Issue" --priority high
→ JIRA チケットを作成し、現在のコンテキスト情報を自動入力

---
name: review-pr
description: Automated Pull Request review
tags: [code-review, git]
---

# Pull Request Review Instructions

You are helping review a Pull Request. Follow these steps:

1. **Analyze Changes**
   - Read the git diff
   - Identify modified files and functions

2. **Check Standards**
   - Compare against style guide: ./docs/CODE_STYLE.md
   - Verify test coverage requirements

3. **Security Scan**
   - Check for hardcoded credentials
   - Identify potential SQL injection risks

4. **Generate Report**
   Format findings as:
   ✅ Passed checks
   ⚠️ Warnings
   ❌ Must fix before merge

sequenceDiagram
    participant U as User
    participant M as Main Agent<br/>(Claude Code)
    participant F as Frontend Subagent
    participant B as Backend Subagent
    participant D as DevOps Subagent

    U->>M: "Build a todo application"
    M->>M: Task decomposition and planning

    par Parallel Processing
        M->>F: Build React frontend
        M->>B: Design REST API
        M->>D: Configure deployment pipeline
    end

    F-->>M: Frontend code complete
    B-->>M: Backend code complete
    D-->>M: Docker configuration complete

    M->>M: Integration and testing
    M->>U: Complete application delivered

# security-reviewer subagent の専門的な設定
{
  "name": "security-reviewer",
  "system_prompt": """
    You are a security expert specializing in code vulnerability detection.

    Focus areas:
    - SQL injection and XSS vulnerabilities
    - Authentication and authorization flaws
    - Sensitive data exposure
    - Insecure dependencies

    Always provide:
    1. Severity level (Critical/High/Medium/Low)
    2. Affected code location
    3. Remediation steps
    4. CWE reference if applicable
  """,
  "tools": [
    "static_analysis_scanner",
    "dependency_checker",
    "secret_detector"
  ]
}

開発者:「このコードのセキュリティをレビューしてください」

[security-reviewer subagent が引き継ぐ]

🔴 Critical: SQL Injection Vulnerability
Location: src/api/users.py:45
Code: f"SELECT * FROM users WHERE id = {user_id}"
CWE: CWE-89

Remediation:
Use parameterized queries:
cursor.execute("SELECT * FROM users WHERE id = ?", (user_id,))

🟡 Medium: Hardcoded Secret Detected
Location: src/config.py:12
Code: API_KEY = "sk_live_abc123..."
Recommendation: Use environment variables or secret management services

{
  "mcpServers": {
    "analytics-db": {
      "command": "python",
      "args": ["${CLAUDE_PLUGIN_ROOT}/servers/db_server.py"],
      "env": {
        "DB_URL": "${ANALYTICS_DB_URL}",
        "READ_ONLY": "true",
        "ALLOWED_TABLES": "users,orders,events"
      }
    }
  }
}

開発者:「昨日、ミニプログラムチャネル経由で登録した新規ユーザーは何人ですか?」

Claude Code:
1. [analytics-db MCP Server を呼び出し]
2. [NL to SQL] 自然言語をクエリに変換:
   SELECT COUNT(*) FROM users
   WHERE registration_channel = 'miniprogram'
   AND created_at >= '2025-10-09 00:00:00'
3. [クエリを実行] 読み取り専用レプリカで安全に実行
4. [結果を返す]「昨日、ミニプログラムユーザーが1,247人追加されました」

{
  "mcpServers": {
    "k8s-cluster": {
      "command": "npx",
      "args": ["-y", "@company/mcp-k8s-server"],
      "env": {
        "KUBE_CONFIG": "${HOME}/.kube/config",
        "CLUSTER": "production"
      }
    }
  }
}

開発者:「payment-service の Pod の状態はどうですか?」

Claude Code:
[k8s-cluster MCP Server を呼び出し]

現在の状態:
- Total Pods: 5
- Running: 3
- CrashLoopBackOff: 2 ⚠️

異常な Pod:
1. payment-service-7d9f8-x4k2j
   Restart count: 12
   Last error: "Database connection timeout"

2. payment-service-7d9f8-p8m1q
   Restart count: 8
   Last error: "OOMKilled (memory limit exceeded)"

提案:データベース接続設定とメモリ制限設定を確認する必要があります

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write.*\\.py$",
        "hooks": [
          {
            "type": "command",
            "command": "pytest tests/ -v",
            "description": "Running unit tests..."
          }
        ],
        "onFailure": "warn",
        "failureMessage": "⚠️ Tests failed. Review changes before committing."
      }
    ]
  }
}

1. Claude が Python ファイルを修正(例: src/api/payment.py)
2. [PostToolUse Hook をトリガー]
3. 自動的に pytest tests/ を実行
4. テストが失敗した場合 → 警告プロンプトを表示するが、操作はブロックしない
5. テストが合格した場合 → サイレントに継続

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/audit_log.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

{
  "timestamp": "2025-10-10T14:32:15Z",
  "user": "[email protected]",
  "action": "file_write",
  "file": "src/payment/processor.py",
  "changes": {
    "lines_added": 12,
    "lines_removed": 3
  },
  "compliance_tags": ["PCI-DSS", "SOC2"]
}

開発者: /create-app "todo application"

sequenceDiagram
    participant U as User
    participant SC as Slash Command
    participant SA as Subagents
    participant H as Hooks
    participant M as MCP Server

    U->>SC: /create-app "todo application"
    SC->>SC: Parse requirements, plan architecture

    SC->>SA: Call architect-agent
    SA->>SA: Design tech stack<br/>(React + FastAPI + PostgreSQL)

    SA->>H: Prepare to create files
    H->>H: PreToolUse: Check project directory

    par Parallel Code Generation
        SA->>SA: frontend-agent generates React code
        SA->>SA: backend-agent generates FastAPI code
    end

    SA->>M: Call database MCP
    M->>M: Initialize PostgreSQL schema

    SA->>H: File writing complete
    H->>H: PostToolUse: Run linter + tests

    H->>SC: All checks passed
    SC->>U: ✅ Application created<br/>Run `npm run dev` to start

"Claude, check the status of ticket PROJ-123 on JIRA."

sequenceDiagram
    participant U as User
    participant C as Claude
    participant P as JIRA Plugin
    participant A as JIRA API

    U->>C: "Check status of PROJ-123"

    Note over C: Step 1: Intent Recognition
    C->>C: Analyze → Query JIRA ticket

    Note over C: Step 2: Tool Selection
    C->>C: Match → jira_plugin.get_ticket_status

    Note over C: Step 3: Parameter Extraction
    C->>C: Extract → ticket_id = "PROJ-123"

    Note over C: Step 4: API Request Construction
    C->>P: GET /rest/api/3/issue/PROJ-123

    Note over P: Step 5: Tool Execution
    P->>A: HTTP Request
    A-->>P: {"status": "In Progress", "assignee": "Alice"}

    Note over C: Step 6: Response Synthesis
    P-->>C: JSON Response
    C->>C: Translate to natural language

    C->>U: "JIRA ticket PROJ-123 is currently<br/>'In Progress' and assigned to Alice"

# これは Claude に内部 Git サービスの使用方法を教えるツール定義ファイルです
openapi: 3.0.1

info:
  # 基本メタデータ
  title: Internal GitLab Service Plugin
  description: A plugin for interacting with company's private GitLab repository
  version: 1.0.0

servers:
  # API ベース URL
  - url: https://gitlab.internal.company.com/api/v4

paths:
  # 利用可能なすべてのエンドポイントを定義
  /projects/{project_id}/repository/commits:
    get:
      # Claude がこれを使用してツールの機能を理解
      summary: Get recent commits for a project
      description: Retrieves a list of the most recent commits from a specified project repository
      operationId: getRecentCommits

      parameters:
        # すべての入力パラメータ
        - name: project_id
          in: path # URL パスパラメータ
          required: true
          description: The ID of the project
          schema:
            type: string
            example: '42'

        - name: ref_name
          in: query # URL クエリパラメータ (?ref_name=main)
          required: false
          description: The name of a branch or tag
          schema:
            type: string
            default: 'main'

        - name: per_page
          in: query
          required: false
          description: Number of commits to return
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20

      responses:
        # 可能な応答結果を記述
        '200':
          description: A successful response with a list of commits
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Commit SHA
                      example: 'a3f9c2b1d5e8...'
                    message:
                      type: string
                      description: Commit message
                      example: 'feat: add payment integration'
                    author_name:
                      type: string
                      description: Author of the commit
                      example: 'Alice Wang'
                    created_at:
                      type: string
                      format: date-time
                      description: Commit timestamp

        '404':
          description: Project not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: 'Project not found'

        '401':
          description: Unauthorized - invalid or missing credentials

info:
  title: Internal GitLab Service Plugin
  description: A plugin for interacting with company's private GitLab repository
  version: 1.0.0

servers:
  - url: https://gitlab.internal.company.com/api/v4

paths:
  /projects/{project_id}/repository/commits:
    get:
      summary: Get recent commits for a project
      operationId: getRecentCommits

parameters:
  - name: project_id
    in: path # パラメータの場所: path/query/header/cookie
    required: true # 必須かどうか
    schema:
      type: string # データ型
      example: '42' # 例示値

responses:
  '200':
    description: A successful response
    content:
      application/json:
        schema:
          type: array
          items:
            properties:
              id: { type: string }
              message: { type: string }

ユーザー:「payment-gateway プロジェクトの最後の5つのコミットを表示してください」

Claude の内部処理:
1. [operationId をマッチ] getRecentCommits
2. [パラメータを抽出]
   - project_id: "payment-gateway" (プロジェクト名を通じて ID を検索する必要がある)
   - per_page: 5
   - ref_name: "main" (デフォルト値を使用)
3. [API 呼び出しを構築]
   GET https://gitlab.internal.company.com/api/v4/projects/{id}/repository/commits?per_page=5
4. [レスポンスを解析] スキーマに基づいて返された JSON 構造を理解
5. [返信を生成] データを自然言語に変換

最後の5つのコミット記録:

1. a3f9c2b - feat: add payment integration (2025-10-09)
   作成者: Alice Wang

2. b7e4d1a - fix: resolve timeout issue (2025-10-08)
   作成者: Bob Chen

3. c9f2e5b - refactor: improve error handling (2025-10-08)
   作成者: Alice Wang

4. d1a8c3f - docs: update API documentation (2025-10-07)
   作成者: Carol Liu

5. e5b9d2a - test: add integration tests (2025-10-07)
   作成者: Bob Chen

mindmap
  root((Plugin<br/>Marketplace))
    Discovery
      Browse by category
      Keyword search
      Rating sorting
    Distribution
      One-click installation
      Version management
      Auto-updates
    Collaboration
      Team sharing
      Unified configuration
      Knowledge accumulation
    Governance
      Security auditing
      Permission control
      Compliance management

# Anthropic 公式マーケットプレイスを追加
/plugin marketplace add anthropics/claude-code-plugins

# 利用可能なプラグインを閲覧
/plugin

# 出力例:
📦 Available Plugins (anthropics/claude-code-plugins)

🔧 Development Tools
  - github-integration (v2.1.0)
    Connect to GitHub repos, PRs, and issues
    ⭐ 4.8/5.0 | 12.5k installs

  - gitlab-integration (v1.8.3)
    GitLab repository management
    ⭐ 4.6/5.0 | 8.2k installs

☁️ Cloud Services
  - aws-toolkit (v3.0.1)
    Manage AWS resources (EC2, S3, Lambda)
    ⭐ 4.9/5.0 | 15.1k installs

  - gcp-helper (v2.5.0)
    Google Cloud Platform integration
    ⭐ 4.7/5.0 | 9.8k installs

🔒 Security
  - security-scanner (v1.5.2)
    Static code analysis and vulnerability detection
    ⭐ 4.8/5.0 | 11.3k installs

graph TB
    subgraph "Enterprise Intranet"
        A[Developer] -->|Submit Plugin| B[GitLab Repository]
        B -->|CI/CD Pipeline| C[Security Scan]
        C -->|Pass| D[Private Marketplace]
        C -->|Fail| E[Security Team Review]
        E -->|After Fix| B

        D -->|Distribute| F[Claude Code Client]

        G[LDAP/AD] -.->|Identity Auth| F
        H[Permission Management] -.->|Access Control| D
        I[Audit System] -.->|Logging| D
    end

    J[External Public Market] -.->|Periodic Sync| B

    style D fill:#e1f5ff
    style C fill:#fff3e0
    style I fill:#fce4ec

# 方法1: GitHub リポジトリ(最も一般的)
/plugin marketplace add anthropics/claude-code-plugins

# 方法2: 完全な Git URL
/plugin marketplace add https://gitlab.com/company/plugins.git

# 方法3: ローカルディレクトリ(開発テスト)
/plugin marketplace add /Users/alice/my-marketplace

# 方法4: HTTP(S) URL(CDN ホスト)
/plugin marketplace add https://plugins.company.com/marketplace.json

/plugin

# プラグインブラウザインターフェースを起動:
┌─────────────────────────────────────────┐
│ Plugin Browser                          │
├─────────────────────────────────────────┤
│ Marketplaces: ▼                         │
│ ☑ anthropics/claude-code-plugins        │
│ ☑ company-internal                      │
│                                         │
│ Categories:                             │
│ → Development Tools (24)                │
│   Cloud Services (18)                   │
│   Security (12)                         │
│   Data & Analytics (9)                  │
│                                         │
│ Search: [payment________]  [Search]     │
│                                         │
│ Results:                                │
│ 📦 payment-gateway-plugin               │
│    Integrate with Stripe, PayPal        │
│    ⭐ 4.7 | company-internal            │
│    [Install] [More Info]                │
└─────────────────────────────────────────┘

# 指定したマーケットプレイスからインストール
/plugin install payment-gateway@company-internal

# 特定のバージョンをインストール
/plugin install [email protected]

# 最新バージョンをインストール
/plugin install security-scanner@anthropics

{
  "name": "my-plugin",
  "version": "2.3.1"
  //          │ │ └─ Patch: 後方互換性のあるバグ修正
  //          │ └─── Minor: 後方互換性のある新機能
  //          └───── Major: 破壊的変更(後方互換性なし)
}

# 正確なバージョン
/plugin install my-plugin@2.3.1

# 最新の 2.x バージョン(将来サポートされる可能性)
/plugin install my-plugin@^2.0.0

# 最新バージョン
/plugin install my-plugin@latest

# マーケットプレイスのプラグインリストを更新
/plugin marketplace update <marketplace-name>

# すべてのマーケットプレイスを更新
/plugin marketplace update --all

# プラグインを再インストール(最新バージョンを取得)
/plugin uninstall <plugin-name>
/plugin install <plugin-name>@latest

{
  "name": "internal-db-query",
  "version": "1.0.0",
  "description": "Safe database query interface",

  "permissions": ["database:read:users", "database:read:orders", "network:internal:10.0.0.0/8"],

  "denied_permissions": ["database:write", "database:delete", "filesystem:write", "network:external"],

  "security": {
    "data_retention": "none",
    "audit_logging": true,
    "encryption_required": true
  },

  "compliance": {
    "certifications": ["SOC2", "ISO27001"],
    "data_classification": "confidential"
  }
}

📦 Installing: internal-db-query v1.0.0

⚠️ This plugin requires the following permissions:

✅ Read access to:
   - users table
   - orders table

✅ Network access:
   - Internal network only (10.0.0.0/8)

🔒 Security features:
   - No data retention
   - Audit logging enabled
   - Encrypted connections required

❌ Denied permissions:
   - Cannot write to database
   - Cannot delete records
   - Cannot write to filesystem
   - Cannot access external network

Do you want to proceed? [y/N]

📦 devops-automation
   - 80以上の事前設定された DevOps ツール
   - CI/CD 統合(Jenkins、GitLab CI、GitHub Actions)
   - 監視統合(Prometheus、Grafana、Datadog)
   - ログ分析(ELK、Loki)
   ⭐ 4.9/5.0 | エンタープライズレベルの採用

📦 expert-agents-collection
   - 80以上のドメイン専門 subagents
   - カテゴリ:セキュリティ、パフォーマンス、ドキュメント、テスト、アーキテクチャ
   - 各エージェントは特定のタスクに深く最適化
   ⭐ 4.8/5.0 | コミュニティ推奨

Slash Commands  → クイックオペレーションエントリー、ユーザートリガー
Subagents       → 専門的なタスクエージェント、複雑なタスク分割
MCP Servers     → 外部ツール接続、データ & サービス統合
Hooks           → 自動化トリガー、ワークフロー重要ポイント