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
---

フィールド	型	説明
description	String	コマンドの説明（必須）
model	String	使用モデル（フルモデル ID）
allowed-tools	String	使用可能ツールを制限
argument-hint	String	引数のヒント表示
disable-model-invocation	Boolean	true でモデル呼び出し無効化

---

model フィールド

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

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

モデル	ID	用途
(省略)	-	ユーザーのモデルを継承（推奨）
Haiku 4.5	claude-haiku-4-5-20251001	高速・定型タスク向け
Opus 4.6	claude-opus-4-6	高精度・複雑なタスク向け

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

---

変数

変数	説明	例
$ARGUMENTS	引数全体	fix bug
$1	第1引数	fix
$2	第2引数	bug
$3, $4, ...	第3引数以降

使用例

# 単一引数
コミットメッセージ: $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 を連結 → 感嘆符+バッククォート+コマンド+バッククォート）

---

バリデーションルール

ルール	重要度
フロントマターに description 必須	エラー
ファイル名は kebab-case	推奨
model はフルモデル ID	必須（指定時）

Examples

コマンド作成の相談

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

model 指定の相談

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