Skip to content

devbasex/ai-plugins

BranchesTags

Repository files navigation

AI Plugins

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

概要

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

NDFプラグイン v4.19.0 は、同じ ndf@ai-plugins という名前で Claude Code / Codex / Kiro CLI へ配布されるランタイム別プラグインです。共通ソースは plugins/ndf-shared/ に集約し、利用者が install する配布物は plugins/ndf-claude/ / plugins/ndf-codex/ / plugins/ndf-kiro/ に分かれています。

  • 公開Skills: Claude Code向け core 29個、Kiro向け core 28個、Codex向け core 30個に分離。
  • 元Skills（49個）:
    • PR/レビューワークフロー (13): pr, pr-tests, fix, review, review-branch, review-pr-comments, resolve-pr-comments, cherry-pick-pr, deploy, sync-main, merged, clean, browser-test
    • 原則・ガイドライン (10): ndf-policies, branch-fix-strategy, implementation-plan, plan-to-spec, investigation-rules, problem-solving, logging-guidelines, markdown-writing, issue-plan-strategy, ml-model-structure
    • データ分析・品質・環境 (12): data-analyst-sql-optimization, data-analyst-export, qa-security-scan, python-execution, docker-container-access, git-gh-operations, google-auth, codex, deepwiki-transfer, knowledge-reorg, mcp-builder, official-skills-autoloader
    • E2Eテスト/Playwright (6): playwright-test-planning, playwright-script-creation, playwright-execution, playwright-report, playwright-kit-ops, playwright-scenario-test
    • 外部サービス連携 (2): google-drive, google-chat
    • AIクロスレビュー (2): cross-review, gemini
    • 運用 (1): 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 サーバは廃止)
  • AIクロスレビュー強化: /ndf:cross-review は codex/gemini 両方に PR レビューを委譲し、Gemini の進捗 heartbeat、--focus / --extra-instructions-file、PR 種別別の自動レビュー観点テンプレートに対応
  • Kiro CLI対応: plugins/ndf-kiro/install.sh によるワンコマンドセットアップ
  • MCPプラグイン: plugins/mcp/shared/ を編集元とし、Claude / Codex / Kiro 向け配布物を plugins/mcp/{claude,codex,kiro}/ に生成

利用方法

Claude Code

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

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

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

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

Codex

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

ローカルで検証する場合:

codex plugin marketplace add ./local/path/to/ai-plugins
codex plugin add ndf@ai-plugins

Kiro CLI

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

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

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

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

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

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

インストーラーは plugins/ndf-kiro/skills/ から .kiro/skills/ への symlink と .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.19.0 Claude Code / Codex / Kiro CLI 向けに runtime 別配布物を提供する NDF プラグイン。8個の専門エージェント（Claude版）、公開Skills（Claude Code向け core 29個、Kiro向け core 28個、Codex向け core 30個）、Claude SessionStart/Stopフック、Codex/Kiro向け通知・実行補助を提供。v4.0.0 で Codex MCP サーバを廃止し、/ndf:codex skill + corder エージェント経由の CLI 直接実行に一本化。 Claude / Codex / Kiro

NDF v4.19.0 の主な変更

  • plan-to-spec skill を追加し、実装完了後の plan を docs/ 配下の確定仕様書へ移動・リライト・レビューする標準フローを定義しました。
  • 完了報告テンプレートを追加し、元 plan、確定仕様書、レビュー結果、検証内容を一貫した形式で報告できるようにしました。

開発ガイドライン

プラグイン開発

ディレクトリ構造

ai-plugins/
├── .agents/
│   └── plugins/
│       └── marketplace.json      # Codexマーケットプレイスメタデータ
├── .claude-plugin/
│   └── marketplace.json          # Claude Codeマーケットプレイスメタデータ
├── plugins/
│   ├── ndf-shared/               # NDF共通編集元（直接installしない）
│   ├── ndf-claude/               # Claude Code版NDF配布物
│   ├── ndf-codex/                # Codex版NDF配布物
│   ├── ndf-kiro/                 # Kiro CLI版NDF配布物/installer
│   └── mcp/
│       ├── shared/               # MCPプラグイン共通編集元
│       ├── claude/               # Claude Code版MCP配布物
│       ├── codex/                # Codex版MCP配布物
│       └── kiro/                 # Kiro CLI版MCP配布物/installer
├── README.md
└── CLAUDE.md                     # AIエージェント向けガイドライン

Runtime plugin の検証

共通ソースや runtime 配布物を変更した場合は、生成物同期と manifest / link 検証を実行します。

bash scripts/build-runtime-plugins.sh
bash scripts/validate-runtime-plugins.sh

実ランタイムのインストール経路を確認する場合は、Docker コンテナ内で smoke test を実行します。

bash scripts/runtime-smoke-test.sh
bash scripts/runtime-smoke-test.sh --runtime claude
bash scripts/runtime-smoke-test.sh --runtime codex
bash scripts/runtime-smoke-test.sh --runtime kiro

ローカル hook を使う場合は以下を実行します。

bash scripts/install-dev-hooks.sh

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

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: 破壊的変更

リファレンス

公式ドキュメント

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

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

  • CLAUDE.md - AIエージェント向けガイドライン（Claude Code）
  • KIRO.md - AIエージェント向けガイドライン（Kiro CLI）
  • docs/specifications/ - 完了済みplan/issue由来の確定仕様
  • 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

About

AI Agent Marketplace - Claude Codeプラグインマーケットプレイス

basex.dev

Topics

ai-agents claude-code claude-code-plugin plugin-marketplace

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages