Command Spec

Command Spec スキル

Claude Code プラグインの command（スラッシュコマンド）仕様知識を提供する。

Instructions

このスキルは command の正しい形式と実装パターンについての知識を提供します。

重要: 実装前に必ず公式ドキュメント（英語版）を確認し、最新の仕様に従ってください。

公式ドキュメント

• Slash Commands

ファイル配置

commands/{command-name}.md

• ファイル名がコマンド名になる
• kebab-case を使用（例: my-command.md）

フロントマター

必須フィールド

---
description: コマンドの説明（必須）
---

オプションフィールド

---
description: コマンドの説明
model: claude-haiku-4-5-20251001
allowed-tools: Read, Glob, Grep, Bash
argument-hint: [引数のヒント]
disable-model-invocation: false
---

model フィールド

commands では model フィールドの省略を推奨（ユーザーの使用モデルがそのまま使われる）。

特定のモデルを指定する場合はフルモデル ID を使用：

注意: Sonnet は現在の Claude Code では推奨されません。

変数

使用例

# 単一引数
コミットメッセージ: $ARGUMENTS

# 複数引数
PR #$1 をレビュー（優先度: $2）

コマンド呼び出し

/plugin-name:command-name [arguments]

例:

• /git-actions:commit-push "fix: bug修正"
• /plugin-generator:create my-plugin

実装例

基本的なコマンド

---
description: ファイルを検索する
---

# Search

指定されたパターンでファイルを検索します。

引数: $ARGUMENTS

1. パターンを解析
2. Glob で検索を実行
3. 結果を報告

ツール制限付きコマンド

---
description: コードをレビューする
allowed-tools: Read, Glob, Grep
---

# Code Review

指定されたファイルのコードをレビューします。

対象: $ARGUMENTS

1. ファイルを読み込む
2. コード品質をチェック
3. 改善点を報告

動的コンテキスト埋め込み

構文:

• Bash コマンド実行: ! + バッククォートで囲んだコマンド（例: ! + `git status`）
• ファイル参照: @/path/to/file

重要: !プレフィックス記法はスラッシュコマンド（commands/*.md）でのみ有効です。スキルファイル（SKILL.md）では使用できません。

使用例（コマンドファイル内での記述）:

現在の状態:
- Status: !` + `git status` + `
- Diff: !` + `git diff HEAD` + `

コミットメッセージ: $ARGUMENTS

※ 上記のバッククォートを連結してください（例: ! と git status を連結 → 感嘆符+バッククォート+コマンド+バッククォート）

バリデーションルール

Examples

コマンド作成の相談

Q: 新しいコマンドを作りたい
A: commands/{name}.md を作成し、フロントマターに description を必ず含めてください。
   $ARGUMENTS で引数を受け取れます。model を指定する場合はフルモデル ID を使用してください。

model 指定の相談

Q: コマンドで使うモデルを指定したい
A: 通常は model フィールドを省略することを推奨します（ユーザーのモデルを継承）。
   特定のモデルが必要な場合のみ model: claude-haiku-4-5-20251001 などを指定してください。