mcpField
C
commandkit

commandkit

github.com/neplexlabs開発16446 回インストール3 日前に更新
リポジトリ

commandkit について

commandkitは、CommandKitの規約に沿ったプロジェクトの構築と保守を支援するスキルです。設定、コマンドやイベントの配置、ミドルウェア、JSXインタラクション、構造チェックを扱います。

主な機能

  1. 01プロジェクト配置と命名規約の案内
  2. 02設定とプラグイン登録の説明
  3. 03コマンド、イベント、ミドルウェアの実装
  4. 04JSXインタラクションの参照
  5. 05必須プロジェクト構造の検査

活用シーン

  1. 01CommandKitプロジェクトの基本構造を検証
  2. 02規約に沿ったコマンドやイベントの追加
  3. 03プラグインとランタイム初期化の設定
  4. 04規約ベースのレイアウトへの移行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/neplexlabs/commandkit --skill commandkit

インストール後、Claude Code で/commandkitを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
00-filesystem-structure.md
01-config-and-structure.md
02-chat-input-command.md
03-event-handler.md
04-jsx-components.md
05-middlewares.md
06-config-recipes.md
07-sharding-your-bot.md
08-file-naming-conventions.md
09-manual-setup.md
10-cli-api.md
tools/
check-structure.mjs

詳細

CommandKit Core

有効化の指針

フレームワークレベルのアーキテクチャと実装には、このスキルを使用してください。

  • コマンドファイルとイベントファイルの配置
  • commandkit.config の方針とプラグインの接続
  • ミドルウェアのライフサイクル動作
  • JSX インタラクションコンポーネントとハンドラー
  • プロジェクト構造の検証と規約ベースのレイアウトへの移行

必要なファイルシステム要件

  • プロジェクトルートに commandkit.config.ts（または .js）
  • コマンド用の src/app/commands/**
  • イベント用の src/app/events/**
  • プラグインが有効な場合に任意で使用するプラグイン固有のフォルダー（src/app/locales、 src/app/tasks、src/workflows）

設定要件

  • commandkit/config から defineConfig を使用してください。
  • plugins: [] にプラグインを明示的に登録してください。
  • タスク／ドライバーの初期化など、実行時のみの設定には noBuildOnly() のような起動時ガードを使用してください。
  • 環境に応じてプラグインを切り替える場合は、明示的に設定してください。

実行ワークフロー

  1. まず構造と基本設定を検証します。
  2. コマンドファイルとイベントファイルを規約に沿ったパスに配置します。
  3. 型付きコンテキストとメタデータを使用して、コマンドのロジックを実装します。
  4. 横断的な関心事に限り、ミドルウェアを追加します。
  5. ローカルの開発コマンドで実行時の動作を確認します。

ガードレール

  • CommandKit の API を捏造しないでください。
  • 規約に基づく検出を迂回する、登録中心のパターンは避けてください。
  • ハンドラーは小さく保ち、再利用可能なロジックはヘルパー／サービスに移してください。

リファレンス一覧

名前説明
references/00-filesystem-structure.md標準的なプロジェクトレイアウト、必須パス、構造の検証方法に関するガイダンスです。
references/01-config-and-structure.md詳細な設定パターン、プラグインの接続方法、タスク別の設定レシピです。
references/02-chat-input-command.mdメタデータと応答処理を含む、基本的なスラッシュコマンドのパターンです。
references/03-event-handler.mdイベントリスナーの規約とライフサイクルのベストプラクティスです。
references/04-jsx-components.md実際のプロジェクトでの使用例に基づく、有効な JSX コンポーネントのパターン（インタラクティブなハンドラーを含む）です。
references/05-middlewares.mdグローバル、ディレクトリ単位、コマンド固有のミドルウェアのパターンと実行順序です。
references/06-config-recipes.md一般的なボット構成（コアのみ、AI、キャッシュ、タスク、ワークフロー）向けのタスク別設定レシピです。
references/07-sharding-your-bot.mdシャーディングマネージャーの設定、エントリーポイントの動作、スケーリングに関連するシャード計画です。
references/08-file-naming-conventions.mdCommandKit が自動検出する特別なファイル名／ディレクトリと、それらが実行時に及ぼす影響です。
references/09-manual-setup.md設定、アプリのエントリーポイント、コマンド、イベント、実行／ビルド／起動を含む、手動セットアップの全手順です。
references/10-cli-api.mdCLI API をプログラムから使用する際の高度なパターンと制約です。

ツール一覧

名前説明
tools/check-structure.mjs現在のプロジェクトに CommandKit のコアで必要なパスが存在するかを確認します。

コメント

Markdown 対応