カスタムコマンド

概要

カスタムコマンドはMarkdownファイルとして定義するユーザー独自のスラッシュコマンドです。プロジェクトチームで共有するか、個人用に設定できます。

コマンドの配置場所

種類	場所	スコープ	ヘルプラベル
プロジェクト	.claude/commands/	チーム全体（Git管理）	(project)
ユーザー	~/.claude/commands/	個人（全プロジェクト共通）	(user)
MCP	MCPサーバー提供	動的検出	なし

サブディレクトリでコマンドを整理でき、コマンド名はファイル名から派生します。

.claude/commands/
  fix-issue.md          # /fix-issue
  review/
    pr.md               # /review/pr
    security.md         # /review/security

引数の使用

コマンド内で引数を参照できます。

全引数の取得: $ARGUMENTS

/fix-issue 123 high-priority
# -> $ARGUMENTS = "123 high-priority"

個別引数: $1, $2, $3

/review-pr 456 high alice
# -> $1="456", $2="high", $3="alice"

フロントマター

コマンドの動作をFrontmatterで制御できます。

---
description: "PRレビューを実行"
allowed-tools: ["Read", "Grep", "Bash(git diff:*)"]
argument-hint: "<PR番号>"
model: "sonnet"
---

PR番号 $1 の変更内容をレビューして、以下の観点で評価してください:

- コード品質
- セキュリティ
- パフォーマンス

フィールド	説明	デフォルト
description	コマンドの説明	プロンプトの最初の行
allowed-tools	使用可能なツール	セッションから継承
argument-hint	オートコンプリート時のヒント	なし
model	使用するモデル	セッションから継承

Bash事前実行

コマンドの先頭に ! を付けると、コマンド実行前にBashコマンドを実行し、その出力をコンテキストに含めます。

---
description: "差分レビュー"
---

!`git diff HEAD~1`

直近のコミットの変更をレビューしてください。

allowed-tools でBashが許可されている必要があります。

ファイル参照

@ プレフィックスでファイルの内容をコマンド内に埋め込めます。

---
description: "API仕様ベースのレビュー"
---

@docs/api-spec.md

このAPI仕様に基づいて、現在の実装をレビューしてください。

実用的なコマンド例

---
description: "テスト実行とカバレッジ確認"
argument-hint: "<ファイルパス>"
---

!`npm test -- $1 --coverage`

$1 のテスト結果とカバレッジを分析して、改善点があれば提案してください。