command-guide

Claude Code コマンド選択ガイド

さまざまなシナリオに適したコマンド、エージェント、スキルを選ぶためのガイドです。

クイック判断フローチャート

graph TD
    A[User Request] --> B{Request Type?}
    B -->|New Feature| C[/plan]
    B -->|Bug Fix| D[/tdd or build-error-resolver]
    B -->|Code Review| E[/code-review or code-reviewer agent]
    B -->|Testing| F[/e2e or tdd-guide agent]
    B -->|Context Too Long| G[/compact]
    B -->|Documentation| H[/docs or docs-lookup agent]
    B -->|Looping Task| I[/loop]
    B -->|Security Review| J[security-reviewer agent]

    C --> K[planner agent]
    D --> L{Build Failed?}
    L -->|Yes| M[build-error-resolver]
    L -->|No| N[tdd-guide]
    E --> O[code-reviewer]
    F --> P[e2e-runner]

1. 組み込みスラッシュコマンド

セッション管理コマンド

コマンド	使用例	例
/compact	コンテキストが長すぎる（>150K tokens）、応答が遅い、タスクフェーズの移行	/compact または自動実行
/clear	新しい会話を開始する、履歴をクリアする	/clear
/loop	定期的なタスク実行、自動ループ処理	/loop 5m check build status
/help	ヘルプを表示する、コマンドを確認する	/help
/fast	より速い応答が必要な場合（Opus 4.6 のみ）	/fast
/model	モデルを切り替える	/model sonnet

開発ワークフローコマンド

コマンド	使用例	実行タイミング
/plan	新機能の開始、アーキテクチャのリファクタリング、複雑なタスク	プランモードに入る
/tdd	テストの作成、TDD 開発ワークフロー	テストのガイダンスが必要なとき
/e2e	E2E テスト、重要なユーザーフローの検証	ブラウザテストが必要なとき
/code-review	コード品質のレビュー	コード作成後
/build-fix	ビルドの失敗、型エラー	ビルド失敗時
/learn	セッションからパターンを抽出し、学習する	セッション終了前
/skill-create	git の履歴から新しいスキルを作成する	繰り返しのパターンが見つかったとき

ドキュメントとクエリのコマンド

コマンド	使用例	例
/docs	プロジェクトのドキュメントを更新する	/docs
/update-codemaps	コードマップを更新する	/update-codemaps
/remember	メモリーシステムに記憶を保存する	/remember user prefers concise output
/tasks	タスクリストを表示する	/tasks

---

2. エージェントの選択

開発ワークフローエージェント

エージェント	起動条件	目的
planner	複雑な機能リクエスト、アーキテクチャ上の決定	実装計画の作成
architect	システム設計、技術スタックの選定	アーキテクチャの分析と決定
tdd-guide	新機能、バグ修正	TDD ワークフローのガイダンス
code-reviewer	コード作成直後に呼び出す	コード品質のレビュー
security-reviewer	認証、API、機密データの取り扱い	セキュリティ脆弱性の検出

問題解決エージェント

エージェント	起動条件	目的
build-error-resolver	ビルド失敗時にすぐ呼び出す	ビルドエラー／型エラーの修正
e2e-runner	重要なユーザーフロー、PR の前	E2E テストの実行
refactor-cleaner	コードの保守、不要なコードの削除	不要なコードの検出と削除
doc-updater	ドキュメント、コードマップの更新	ドキュメントの同期

調査と探索のエージェント

エージェント	起動条件	目的
Explore	コードベースの探索、ファイルの検索	コードベースの素早い探索
general-purpose	複雑な複数ステップのタスク	一般的なタスクへの対応
docs-lookup	ライブラリ／フレームワークのドキュメントを検索する	最新の API ドキュメントを取得する

---

3. スキルの選択

ワークフロースキル

スキル	実行タイミング	目的
tdd-workflow	新機能の開発／バグの修正時	TDD ワークフロー全体のガイダンス
verification-loop	機能の完了後、PR の前	包括的な検証（ビルド／テスト／lint／セキュリティ）
strategic-compact	長時間のセッション、コンテキストの逼迫	手動で /compact を実行するタイミングのガイド

アーキテクチャとパターンのスキル

スキル	実行タイミング	目的
frontend-patterns	フロントエンド開発	React/Next.js/Vue のベストプラクティス
backend-patterns	バックエンド開発	API／サービスのアーキテクチャパターン
api-design	API の設計	RESTful/API の設計標準
mcp-server-patterns	MCP サーバーの開発	MCP の設定とパターン

テストスキル

スキル	起動タイミング	目的
e2e-testing	E2E テストが必要なとき	Playwright テストの生成
security-review	セキュリティレビューが必要なとき	OWASP Top 10 の検出

リサーチスキル

スキル	起動タイミング	目的
deep-research	詳細なリサーチが必要なとき	複数回にわたる検索とリサーチ
exa-search	ウェブ検索が必要なとき	ウェブコンテンツの検索
documentation-lookup	ライブラリのドキュメントを検索するとき	Context7 によるドキュメント検索

---

4. シナリオ別判断マトリックス

タスクのフェーズ別

フェーズ	推奨ツールの組み合わせ	理由
要件分析	planner + Explore	まず計画し、その後に調査します
アーキテクチャ設計	architect + api-design スキル	専門的なアーキテクチャのガイダンス
開発前	tdd-guide + tdd-workflow スキル	まずテストを書きます
開発中	直接編集 + 素早い反復	作業の流れを維持します
開発後	code-reviewer + verification-loop	品質ゲート
テストフェーズ	e2e-runner + e2e-testing スキル	テストを網羅します
PR の前	security-reviewer + verification-loop	最終確認
ビルド失敗時	build-error-resolver	問題に絞った修正

問題の種類別

問題	すぐに呼び出すツール	備考
ビルド失敗	build-error-resolver	変更を最小限に抑え、すばやく修正します
型エラー	build-error-resolver	TypeScript の専門家
バグ修正	tdd-guide	テストを書いてから修正します
セキュリティの脆弱性	security-reviewer	OWASP の検出
コード品質の低下	code-reviewer	すぐにレビューします
ドキュメントの不足	doc-updater	自動更新
デッドコード	refactor-cleaner	安全にクリーンアップします

開発の種類別

開発の種類	スキルの組み合わせ
フロントエンド機能	frontend-patterns + tdd-workflow
バックエンド API	backend-patterns + api-design + tdd-workflow
MCP サーバー	mcp-server-patterns + tdd-workflow
データベース	database-reviewer エージェント
セキュリティ機能	security-reviewer + security-review スキル

---

5. 並列実行戦略

並列実行が可能なシナリオ

推奨：複数の独立したタスクを同時に開始します

シナリオ：コード完成後の PR 準備

• エージェント 1：code-reviewer（コード品質）
• エージェント 2：security-reviewer（セキュリティレビュー）
• エージェント 3：e2e-runner（E2E テスト）

シナリオ：大規模なリファクタリングの分析

• エージェント 1：architect（アーキテクチャ分析）
• エージェント 2：Explore（コード調査）
• エージェント 3：refactor-cleaner（デッドコード検出）

順次実行が必要なシナリオ

並列化できません：依存関係があるためです

シナリオ：ビルドエラーの修正

• 順序：build-error-resolver -> テストによる検証 -> code-reviewer

シナリオ：新機能の開発

• 順序：planner -> tdd-guide（テスト作成）-> 実装 -> code-reviewer

---

6. 自動起動ルール

ユーザーからの依頼がなくても呼び出す

状況	自動アクション
コードを作成・変更した	すぐに code-reviewer を呼び出す
ビルドに失敗した	すぐに build-error-resolver を呼び出す
複雑な機能の依頼	すぐに planner を呼び出す
認証や機密データを扱う	すぐに security-reviewer を呼び出す
新機能・バグ修正	すぐに tdd-guide を呼び出す
アーキテクチャ上の判断	すぐに architect を呼び出す

---

7. コンテキスト管理のタイミング

指標	/compact を実行するタイミング
トークン > 150K	直ちにコンパクト化する
応答が遅い	コンパクト化を提案する
タスクフェーズの切り替え	境目でコンパクト化する
主要なマイルストーンの完了	コンパクト化してから続行する
デバッグ終了 -> 新しいタスク	デバッグの痕跡を消去する

ベストプラクティス：

• 調査の後、実装の前にコンパクト化する（計画を保持する）
• マイルストーン完了後にコンパクト化する（中間状態を消去する）
• 実装の途中ではコンパクト化しない（変数やパスが失われる）

---

8. コマンド早見表

Development Workflow:
/plan        -> Enter planning mode (complex tasks)
/tdd         -> TDD workflow
/e2e         -> E2E testing
/code-review -> Code review
/build-fix   -> Fix build

Session Management:
/compact     -> Compact context
/clear       -> Clear session
/loop        -> Looping task
/fast        -> Fast mode

Documentation & Memory:
/docs        -> Update docs
/remember    -> Save memory
/tasks       -> View tasks

Help:
/help        -> View all commands

---

9. 使用例

例 1：新機能の開発

ユーザー：ユーザー認証機能を追加する

ワークフロー：

1. /plan -> planner エージェントが計画を作成
2. tdd-guide -> テストを記述
3. 実装 -> コードを編集
4. code-reviewer -> コードレビュー
5. security-reviewer -> セキュリティレビュー（認証は機密性が高いため）
6. e2e-runner -> E2E テスト
7. /compact -> マイルストーン完了後にコンパクト化

例 2：ビルドの失敗

ユーザー：npm run build が失敗した

ワークフロー：

1. build-error-resolver -> エラーを分析し、最小限の修正を行う
2. ビルドの成功を確認
3. code-reviewer -> 修正の品質を確認

例 3：コードのリファクタリング

ユーザー：認証モジュールをリファクタリングする

ワークフロー：

1. architect -> アーキテクチャを分析
2. planner -> 実装計画を作成
3. refactor-cleaner -> デッドコードを検出
4. tdd-guide -> テストカバレッジを確保
5. 実装 -> コードをリファクタリング
6. verification-loop -> 包括的な検証

---

基本原則：

1. まず計画し、その後に実装する - 複雑なタスクには /plan を使用する
2. まずテストする - 新機能には tdd-guide を使用する
3. コーディング後すぐにレビューする - コードが完成したら code-reviewer を使用する
4. ビルドに失敗したらすぐに修正する - build-error-resolver を使用する
5. 機密性の高いコードをレビューする - 認証/API には security-reviewer を使用する
6. PR の前に包括的に検証する - verification-loop を使用する