mcpField
C
command-creator

command-creator

github.com/feiskyerエージェントワークフロー1.7k122 回インストール5 週間前に更新
リポジトリ

command-creator について

YAML フロントマター付きの Markdown ファイルとして、Claude Code のカスタムスラッシュコマンドを作成するスキルです。目的の確認から配置場所の選定、検証までを案内します。

主な機能

  1. 01コマンドの目的と入力の確認
  2. 02プロジェクト用かユーザー用かを選択
  3. 03YAML フロントマター付き Markdown の作成
  4. 04引数と許可ツールの設定
  5. 05構造と配置場所の検証

活用シーン

  1. 01チーム共有のプロジェクトコマンド作成
  2. 02個人用の再利用コマンド設定
  3. 03引数を受け取るコマンドの定義

インストール

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

$npx skills add https://github.com/feiskyer/claude-code-settings --skill command-creator

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

詳細

コマンド作成ツール

適切な構成とベストプラクティスに沿って、Claude Code のカスタムスラッシュコマンドを作成します。

コマンドについて

Claude Code のコマンドは、再利用可能なワークフローを定義する YAML フロントマター付きの Markdown ファイルです。/command-name で呼び出します。スコープに応じて、以下の場所に配置されます。

  • プロジェクトレベル:プロジェクトルートの .claude/commands/(git で共有)
  • ユーザーレベル:~/.claude/commands/(個人用。どこでも利用可能)
  • カテゴリ別:名前空間を分けるため、サブディレクトリに配置します(例:gh/review-pr.md は /gh:review-pr になります)

手順

1. 目的を明確にする

作成を始める前に、以下を確認します。

  • コマンドで何をしますか?(明確な目的を1つ)
  • 誰が使いますか?このユーザーだけですか、それともチーム全体ですか?(プロジェクトレベルかユーザーレベルかを決めます)
  • 引数は必要ですか?どのような引数ですか?
  • どのツールへのアクセスが必要ですか?
  • 属するカテゴリはありますか?(例:GitHub 用の gh、Claude Code のメタコマンド用の cc)
2. コマンドを作成する

すべてのコマンドファイルは、次の構成に従います。

---
description: Brief description shown in command list
argument-hint: [expected-arguments]
allowed-tools: Tool1, Tool2, Bash(prefix:*)
---

# Command Name

What this command does and when to use it.

## Process:

Step-by-step instructions for the agent to follow.

## Your Task:

Act on "$ARGUMENTS" following these guidelines.
フロントマターのフィールド
フィールド必須用途
descriptionはいコマンド一覧に表示される簡潔な説明
argument-hintいいえ想定する引数のヒント(自動補完時に表示)
allowed-toolsいいえコマンドが使用できるツールを制限します
主な規約
  • $ARGUMENTS は、ユーザーがコマンド名の後に入力した内容に置き換えられます。ユーザーの入力に対してコマンドが動作するよう、必ず「Your Task」セクションで参照してください。
  • allowed-tools ではパターンを使用します。ツール名を指定する形式(Read、Write)や、Bash 用のプレフィックスグロブ(Bash(git:*)、Bash(npm:*))があります。
  • コマンドは目的を絞り、単一の用途にすることが大切です。1つのコマンドにつき、1つのタスクにします。
  • 指示は命令形で書きます(「コードを分析する」。「コードを分析してください」ではありません)。
  • 使用例と期待される動作を具体的に示します。
3. 適切な配置場所を選ぶ
スコープパス使用する場面
プロジェクト(共有).claude/commands/チームのワークフロー、プロジェクト固有のタスク
プロジェクト(カテゴリ別).claude/commands/<category>/コマンドのグループ化(例:gh/、db/)
ユーザー(個人用)~/.claude/commands/個人の生産性向上、複数プロジェクトで使うツール
4. 検証する

コマンドファイルを作成したら、以下を確認します。

  • YAML フロントマターが正しく解析されること(構文エラーがないこと)
  • ファイルが適切なディレクトリにあること
  • コマンドが入力を受け付ける場合、$ARGUMENTS が参照されていること
  • コマンドに必要なすべてのツールが allowed-tools に含まれていること

例:シンプルなコマンド

---
description: Review a pull request with detailed analysis
argument-hint: [PR-number-or-URL]
allowed-tools: Bash(gh:*), Read, Grep, Glob
---

# Review PR

Perform a thorough code review of a GitHub pull request.

## Process:

1. Fetch PR details and diff using `gh pr view` and `gh pr diff`
2. Read changed files for full context
3. Analyze changes for:
   - Correctness and potential bugs
   - Code style consistency
   - Missing tests or edge cases
   - Security concerns
4. Provide a structured review summary

## Your Task:

Review PR "$ARGUMENTS" following these guidelines. If no PR number is given,
use `gh pr list` to show recent PRs and ask which one to review.

ベストプラクティス

  • 説明的な名前:ファイル名がコマンド名になります。内容がわかる名前にします(fi.md ではなく fix-issue.md)。
  • 引数を適切に処理する:$ARGUMENTS が空の場合も必ず処理します。
  • ツールの権限を最小限にする:allowed-tools には、コマンドが実際に必要とするツールだけを指定します。
  • 既存のパターンに従う:規約を確認するため、同じディレクトリにある他のコマンドを参照します。
  • 公開前にテストする:さまざまな入力でコマンドを試し、正しく動作することを確認します。

タスク

「$ARGUMENTS」に基づいて新しいコマンドを作成します。

  1. 目的が不明確な場合は、確認の質問をします
  2. 適切な配置場所とカテゴリを決定します
  3. 適切な構成でコマンドファイルを作成します
  4. 作成した内容と使い方を説明します

コメント