AI Plugins

Claude CodeプラグインおよびKiro CLI向けのスキル・MCP設定を共有するための内部マーケットプレイスです。

概要

このマーケットプレイスは、チーム全体でAI開発ツール（Claude Code / Kiro CLI）の導入を加速するための事前設定されたプラグインを提供します。

NDFプラグイン v4.0.0 は、以下の機能をオールインワンで提供する統合プラグインです：

• 33個のSkills:
  • PR/レビューワークフロー (pr, pr-tests, fix, review, review-branch, review-pr-comments, resolve-pr-comments, cherry-pick-pr, deploy, sync-main, merged, clean, browser-test)
  • 原則・ガイドライン (ndf-policies, branch-fix-strategy, implementation-plan, investigation-rules, problem-solving, logging-guidelines, markdown-writing)
  • データ分析・品質 (data-analyst-sql-optimization, data-analyst-export, qa-security-scan)
  • 外部連携・環境 (codex, git-gh-operations, google-auth, python-execution, docker-container-access, deepwiki-transfer, knowledge-reorg, mcp-builder, official-skills-autoloader)
  • 運用 (skill-stats)
• 8つの専門エージェント: director, data-analyst, corder, researcher, qa, debugger, devops-engineer, code-reviewer
• 自動フック: SessionStart (transcript保持期間を最低90日に保つ) + Stop (AI要約生成+Slack通知)
• 外部AI委譲: /ndf:codex skill + corder エージェント経由で Codex CLI をバックグラウンド実行 (v4.0.0 で Codex MCP サーバは廃止)
• Kiro CLI対応: インストーラーによるワンコマンドセットアップ

利用方法

Claude Code

1. マーケットプレイスの追加

/plugin marketplace add https://github.com/devbasex/ai-plugins

2. プラグインのインストール

# NDFプラグイン（オールインワン統合プラグイン）
/plugin install ndf@ai-plugins

Kiro CLI

1. リポジトリをクローン

git clone https://github.com/devbasex/ai-plugins.git
cd ai-plugins

2. インストーラーを実行

# 基本（Skills + agentSpawnフックのみ）
bash scripts/install-kiro.sh

# Slack通知も有効化
bash scripts/install-kiro.sh --with-slack

# 全部入り（Slack + Codex CLI 連携）
bash scripts/install-kiro.sh --with-slack --with-codex

インストーラーは plugin.json からskills一覧を読み取り、.kiro/agents/default.json を自動生成します。

3. Slack通知の設定（オプション）

.env に以下を設定：

SLACK_CHANNEL_ID=C0123456789
SLACK_BOT_TOKEN=xoxb-...
SLACK_USER_MENTION=<@U0123456789>

4. 起動

kiro-cli chat

詳細は KIRO.md を参照。

利用可能なプラグイン

プラグイン名	バージョン	説明	詳細
ndf	4.0.0	Claude Code / Kiro CLI開発環境をオールインワンで強化する統合プラグイン。8個の専門エージェント（director、data-analyst、corder、researcher、qa、debugger、devops-engineer、code-reviewer）、33個のSkills（PR/レビューワークフロー、原則・ガイドライン、データ分析、品質、Codex CLI連携、skill利用統計など）、SessionStartフック（transcript保持期間自動管理）、Stopフック（AI要約生成+Slack通知）を提供。v4.0.0 で Codex MCP サーバを廃止し、/ndf:codex skill + corder エージェント経由の CLI 直接実行に一本化。	README

開発ガイドライン

プラグイン開発

ディレクトリ構造

ai-plugins/
├── .claude-plugin/
│   └── marketplace.json          # マーケットプレイスメタデータ
├── plugins/
│   └── {plugin-name}/
│       ├── .claude-plugin/
│       │   └── plugin.json       # プラグインメタデータ（必須）
│       ├── commands/             # スラッシュコマンド (*.md)
│       ├── agents/               # サブエージェント (*.md)
│       └── skills/               # プロジェクトスキル
│           └── {skill-name}/
│               └── SKILL.md      # エントリポイント（必須）
├── README.md
└── CLAUDE.md                     # AIエージェント向けガイドライン

新しいプラグインの作成手順

1. プラグインディレクトリを作成:

mkdir -p plugins/{plugin-name}/{.claude-plugin,commands,agents,skills}

2. plugin.json を作成:

{
  "name": "plugin-name",
  "version": "1.0.0",
  "description": "プラグインの説明",
  "author": {
    "name": "作者名",
    "url": "https://github.com/username"
  },
  "skills": [
    {
      "path": "skills/skill-name/SKILL.md"
    }
  ]
}

3. プロジェクトスキルを作成（オプション）:

skills/{skill-name}/SKILL.md を作成：

---
name: スキル名
description: スキルの説明（自動起動のキーワードを含める）
---

# スキル名

スキルの詳細説明とドキュメント...

4. marketplace.json に登録:

.claude-plugin/marketplace.json に追加：

{
  "name": "ai-plugins",
  "owner": {
    "name": "takemi-ohama",
    "email": "takemi.ohama@example.com"
  },
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugins/plugin-name",
      "description": "プラグインの簡単な説明"
    }
  ]
}

5. README.md を作成:

plugins/{plugin-name}/README.md を作成し、以下を含める：

• プラグインの概要
• インストール手順（マーケットプレイス追加を含む）
• 使用方法
• トラブルシューティング

6. テストとコミット:

# ローカルでテスト
/plugin marketplace add file:///path/to/ai-plugins
/plugin install plugin-name@ai-plugins

# 動作確認後、コミット
git add .
git commit -m "Add plugin-name plugin"
git push

開発のベストプラクティス

実施すること:

• ✅ セマンティックバージョニング（MAJOR.MINOR.PATCH）に従う
• ✅ plugin.json に完全なメタデータを含める
• ✅ YAMLフロントマター付きの SKILL.md を作成
• ✅ 包括的なドキュメント（README.md）を提供
• ✅ 環境変数で認証情報を管理
• ✅ .env を .gitignore に追加
• ✅ インストール手順をテスト
• ✅ プラグイン追加時は marketplace.json を更新

してはいけないこと:

• ❌ 機密トークンや認証情報をコミット
• ❌ ドキュメントをスキップ
• ❌ バージョンインクリメントを忘れる
• ❌ 一貫性のない命名規則を使用

マーケットプレイス管理

プラグインの更新

# 1. プラグインファイルを修正
# 2. plugin.json のバージョンをインクリメント
vim plugins/{plugin-name}/.claude-plugin/plugin.json

# 3. 変更をコミット
git add plugins/{plugin-name}
git commit -m "Update plugin-name to v1.1.0"
git push

ユーザーは Claude Code UI から更新を確認できます。

プラグインの削除

# 1. marketplace.json から削除
vim .claude-plugin/marketplace.json

# 2. オプションでプラグインディレクトリを削除
rm -rf plugins/{plugin-name}

# 3. 変更をコミット
git add .
git commit -m "Remove plugin-name from marketplace"
git push

バージョン管理ルール

セマンティックバージョニング（MAJOR.MINOR.PATCH）に従います：

• MAJOR: 破壊的変更（後方互換性なし）
• MINOR: 後方互換性のある新機能追加
• PATCH: バグフィックスのみ

例：

• 1.0.0 → 1.0.1: バグ修正
• 1.0.1 → 1.1.0: 新機能追加
• 1.1.0 → 2.0.0: 破壊的変更

リファレンス

公式ドキュメント

• Claude Code ドキュメント
• プラグインマーケットプレイス
• プラグイン開発ガイド
• スキルドキュメント
• MCP仕様

MCPサーバー公式リポジトリ

• GitHub MCP
• Serena MCP
• Notion MCP
• BigQuery MCP
• DBHub MCP
• Chrome DevTools MCP
• AWS Documentation MCP

プロジェクト内ドキュメント

• CLAUDE.md - AIエージェント向けガイドライン（Claude Code）
• KIRO.md - AIエージェント向けガイドライン（Kiro CLI）
• LICENSE - MITライセンス

コントリビューション

1. このリポジトリをフォーク
2. 新しいプラグインを作成または既存のものを改善
3. プルリクエストを送信
4. 新しいプラグインを追加する場合は marketplace.json を更新

サポート

問題が発生した場合：

1. 各プラグインの README.md を確認
2. 公式ドキュメントを参照
3. このリポジトリにイシューを開く
4. プラグイン作者に連絡（plugin.json を参照）

ライセンス

MIT License - 詳細は LICENSE ファイルを参照

---

作成者: takemi-ohama - https://github.com/takemi-ohama