command-creator について
YAML フロントマター付きの Markdown ファイルとして、Claude Code のカスタムスラッシュコマンドを作成するスキルです。目的の確認から配置場所の選定、検証までを案内します。
主な機能
- 01コマンドの目的と入力の確認
- 02プロジェクト用かユーザー用かを選択
- 03YAML フロントマター付き Markdown の作成
- 04引数と許可ツールの設定
- 05構造と配置場所の検証
活用シーン
- 01チーム共有のプロジェクトコマンド作成
- 02個人用の再利用コマンド設定
- 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」に基づいて新しいコマンドを作成します。
- 目的が不明確な場合は、確認の質問をします
- 適切な配置場所とカテゴリを決定します
- 適切な構成でコマンドファイルを作成します
- 作成した内容と使い方を説明します
コメント
Markdown 対応