Claude Code のカスタムコマンド:/deploy、/review、/standup を自作する

Dev.to / 2026/4/5

💬 オピニオンDeveloper Stack & InfrastructureTools & Practical Usage

要点

  • Claude Code のカスタムスラッシュコマンドは、<project>/.claude/commands/ 配下の Markdown ファイルとして定義し、各ファイル名(例:review.md)は対応するスラッシュコマンド(例:/review)に直接マッピングされます。
  • この記事では、ステージ済みの PR 差分を読み取り、ロジック/エッジケース、欠落しているエラーハンドリング、安全性に関する懸念、テストカバレッジ、そして 1 行の PR 説明を含む、構造化された実行可能なコードレビューを生成する /review コマンドの作り方を示します。
  • さらに、事前確認(テストと lint)を実行し、未コミットの変更がないことを検証したうえで、慣例的コミット(conventional commit)と日付付き git タグを生成し、プッシュは行わずにデプロイ用のチェックリストを出力する /deploy コマンドの例を提示します。
  • また、最近の git アクティビティを使って、完了した作業を平易な英語で簡潔に要約する standup 更新を生成する /standup コマンドも紹介します。
  • 全体として、このガイドは、チームのワークフローを再現可能な「1 行プロンプト」としてコード化し、レビューやリリース手順を標準化することを強調しています。

Claude Code カスタムコマンド:自分で作る /deploy、/review、/standup

Claude Code の組み込みスラッシュコマンドは便利です。ですが、本当の強みは自分で作ることにあります。

カスタムコマンドを使うと、チームのワークフローを繰り返し使える1行プロンプトとしてエンコードできます。作り方は以下です。

カスタムコマンドはどこに置く?

カスタムコマンドは、プロジェクトのルートにある .claude/commands/ 配下の markdown ファイルです:

my-project/
  .claude/
    commands/
      deploy.md
      review.md
      standup.md
  src/
  package.json

各ファイルがスラッシュコマンドになります。deploy.md/deployreview.md/review

最初のカスタムコマンド:/review

.claude/commands/review.md を作成します:

この PR のステージ済み変更をレビューしてください。ファイルごとに:
1. ロジックエラーや想定外のケース(エッジケース)がないか確認
2. 省略されているエラーハンドリングがないか指摘
3. セキュリティ上の懸念をメモ(SQL インジェクション、XSS、認証回避)
4. 変更されたコードのテストカバレッジを確認
5. 1行の PR 説明文を提案

簡潔に。称賛は不要。実行可能なフィードバックのみ。

これで Claude Code で:

/review

Claude はステージ済みの差分を読み取り、構造化されたコードレビューを返します。

/deploy コマンド

.claude/commands/deploy.md を作成します:

このブランチをデプロイのために準備します:
1. `npm test` を実行 — 続行する前に失敗をすべて修正
2. `npm run lint` を実行 — エラーをすべて修正
3. 未コミットの変更がないか git log を確認
4. すべての変更を要約する慣例的なコミットメッセージを書きます
5. 今日の日付で git タグを作成:v$(date +%Y-%m-%d)
6. デプロイ手順チェックリストを markdown として出力

push はしないでください。準備して報告するだけです。

すべてのリリースの前に /deploy を実行します。Claude が事前チェックリストを処理します。

/standup コマンド

.claude/commands/standup.md を作成します:

私のスタンドアップ更新を生成:
1. `git log --since='24 hours ago' --author='$USER' --oneline` を実行
2. 平易な英語(2〜3 個の箇条書き)で完了したことを要約
3. 変更されたファイル内の未解決の TODO コメントを確認
4. 失敗しているテストや lint の警告をブロッカーとして列挙

形式:Yesterday / Today / Blockers
100語以内に収めること。

これで /standup が毎日あなたの更新を自動で書き込みます。

$ARGUMENTS で引数を渡す

カスタムコマンドは、$ARGUMENTS プレースホルダーを使って引数を受け取れます:

.claude/commands/ticket.md を作成します:

チケット用に新しい機能ブランチを作成し、雛形を用意:$ARGUMENTS

1. ブランチを作成:feature/$ARGUMENTS
2. ファイルを作成:src/features/$ARGUMENTS/index.ts(基本的な export を追加)
3. テストファイルを作成:src/features/$ARGUMENTS/index.test.ts
4. チケット参照付きの TODO コメントを追加
5. 新しいファイルをすべてステージする

使用例:

/ticket AUTH-247

Claude はブランチ feature/AUTH-247 を作成し、ファイルを雛形化して、それらをステージします。

本番トラブル向けの /debug コマンド

.claude/commands/debug.md を作成します:

この本番の問題をデバッグ:$ARGUMENTS

1. 次に関連するファイルをコードベースから検索:$ARGUMENTS
2. それらのファイルに対する最近の git 変更を確認(過去7日間)
3. エラーハンドリングの抜けがないか探す
4. このパスをカバーする既存のテストがあるか確認
5. 起こりうる原因を3つ挙げ、確率が高い順に順位付けする
6. 最も可能性が高い原因に対する最小の修正案を提案する

使用例:

/debug checkout で 500 が表示されるユーザー

コマンドをチームと共有する

.claude/commands/ を git にコミットします。全員が同じコマンドを受け取れます:

git add .claude/commands/
git commit -m "add team Claude Code commands"

新しいメンバーは数秒でオンボードできます。/review/deploy/standup は初日からプロジェクトの一部です。

グローバルコマンド(個人用、共有しない)

チーム全体ではなく個人用のコマンドには、代わりに ~/.claude/commands/ を使います:

~/.claude/
  commands/
    explain.md      # 新人開発者にコードを説明する
    refactor.md     # 私の個人的なリファクタリングの流儀
    commit.md       # 私のコミットメッセージのフォーマット

これらはすべてのプロジェクトで利用できますが、決して git にはコミットされません。

ちょいコツ:フックでコマンドを連結する

カスタムコマンド + フック = 完全に自動化されたワークフロー。

.claude/settings.json で:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {"type": "command", "command": "npm run lint --fix"}
        ]
      }
    ]
  }
}

これで Claude がファイルを書き込むたびに、自動的に lint が実行されます。/deploy と組み合わせれば、タッチレスのリリースパイプラインが手に入ります。

レート制限が自動化を壊す

カスタムコマンドのワークフローを壊してしまう唯一のものが、レート制限です。

Claudeがコマンドの途中でレート制限に当たると、/deploy のチェックリストが途中で止まります。/review もセキュリティチェックの前に切り off されます。

ANTHROPIC_BASE_URL で直してください:

export ANTHROPIC_BASE_URL=https://simplylouie.com

SimplyLouie は、レート制限を取り除く ✌️月額2 の Claude プロキシです。あなたのカスタムコマンドは毎回最後まで実行されます。

# .bashrc または .zshrc に追加
export ANTHROPIC_BASE_URL=https://simplylouie.com
export ANTHROPIC_API_KEY=your-simply-louie-key

これで /deploy は決して中断されません。/review も決して切り off されません。✌️月額2。

Summary

Command What it does
/review 段階的に行われる変更の構造化されたコードレビュー
/deploy リリース前の事前チェックリスト
/standup git log から毎日のスタンドアップを自動生成
/ticket AUTH-247 新しい機能ブランチをひな形作成
/debug users seeing 500 原因分析と修正案

カスタムコマンドは、Claude Code の機能の中でも最も使われていません。今週この3つを作れば、もう戻れません。

レート制限による中断を避けるために ANTHROPIC_BASE_URL を使う? SimplyLouie は ✌️月額2 — 7日間の無料トライアル、縛りなし。