C
Claude Academy
Slash Commands

Slash Commands (スラッシュコマンド)

約 12 分 · クイズ 4 問 · 演習 2 問
重要キーワード (3 語)
Slash Command (スラッシュコマンド) — / で始まる定型タスク呼び出し
Frontmatter (フロントマター) — Markdown 冒頭の YAML メタデータ
$ARGUMENTS (引数変数) — コマンド呼び出し時の引数を展開する変数

Slash Commands

/ で始まるコマンドで、よく使うタスクをショートカット化できます。・

組み込みコマンド (一部)

コマンド 機能
/help ヘルプ
/clear コンテキストクリア
/model モデル切替
/init CLAUDE.md 雛形生成
/review PR レビュー
/security-review セキュリティ観点でのレビュー
/config 設定
/agents サブエージェント一覧
/permissions 権限ルール編集
/cost セッションのトークン消費表示
/compact 会話の要約圧縮

カスタムコマンド

.claude/commands/<name>.md を作るだけで自分の slash command を定義できます。・

例: .claude/commands/test.md・

wzxhzdk:0

$ARGUMENTS・

引数を受け取れます。

wzxhzdk:1

呼び出し:

wzxhzdk:2

階層

  • ~/.claude/commands/... ユーザーグローバル
  • <repo>/.claude/commands/... プロジェクト固有

チームでカスタムコマンドを共有するなら、リポジトリにコミットしましょう。

よく使われる自作コマンド例

コマンド 用途
/lint-fix フォーマッタ + 自動修正 + テスト
/changelog 直前のコミット群から CHANGELOG エントリを生成
/migrate-test DB マイグレーションのテスト
/triage 直近の Issues を優先度順にトリアージ
/release-notes リリースノートを下書き

Frontmatter の主な項目

wzxhzdk:2

Plugin としての配布

カスタムコマンド・スキル・MCP を一括配布する Plugin という仕組みもあります。 GitHub に公開して、claude plugin install <user>/<repo> のように受講者全員に配るのに便利。


実用例: 5 つの自作コマンド完全版

すぐコピペで使える 本格的な自作コマンド集。.claude/commands/ に置くだけで動きます。

① /review — git diff レビュー

.claude/commands/review.md

wzxhzdk:3

呼び出し: /review

② /ship — テスト → コミット → push の連鎖

.claude/commands/ship.md

wzxhzdk:0

呼び出し: /ship feat: add OAuth login

③ /debug — エラー再現と原因特定

.claude/commands/debug.md

wzxhzdk:2

呼び出し: /debug TypeError: Cannot read property 'name' of undefined at user.js:42

④ /cleanup — 削除候補のスキャン

.claude/commands/cleanup.md

wzxhzdk:3

呼び出し: /cleanup

⑤ /explain — コード解説

.claude/commands/explain.md

wzxhzdk:0

呼び出し: /explain src/auth/oauth.py


コマンド設計 4 原則

  1. 動詞 + 目的が一目で分かる名前 (/review ◎ vs /check △)
  2. allowed-tools で最小権限 (Read だけで済むものに Bash を渡さない)
  3. 出力フォーマットを明示 (絵文字・表・優先度ラベル)
  4. 「やってはいけないこと」を書く (/debug の「修正は適用しない」など)

💡 自分が 週 3 回以上打つフレーズ は Slash Command 化すると劇的に速くなります。

▶ Hands-on 演習

演習 1: /test カスタムコマンドを作る

あなたのプロジェクトで .claude/commands/test.md を作成し、次の動作をするようにしてください:

  1. pytest または npm test を実行
  2. 失敗があれば失敗テスト名を一覧化
  3. 失敗の根本原因を 1 行で推定

実装後、Claude Code セッションで /test を打って動作確認してください。

▶ Playground を開いて実行
💡 ヒント

Frontmatter は必ず --- で囲むこと。allowed-tools を絞ると安全 (例: Bash, Read のみ)。

演習 2: /explain $ARGUMENTS を作る

ファイル名を引数に取り、コードを 200 字以内で説明する /explain コマンドを作ってください。

呼び出し例: /explain app.py

▶ Playground を開いて実行
💡 ヒント

@$ARGUMENTS と書くと Claude Code がそのパスを Read してくれます。

進捗保存にはログインが必要 クイズに挑戦 (4問)

💬 このレッスンへの質問 (0)

全質問を見る →
質問の投稿には ログイン が必要です。閲覧は誰でも可能です。

まだ質問はありません。最初の 1 件を投稿してみましょう。