/スラッシュコマンド一覧

Claude Code カスタムコマンド リファレンスガイド

17
総コマンド数
5
カテゴリ
~/.claude/commands/
保存場所

開発ワークフロー

/plan ワークフロー

要件を明確化し、リスクを評価し、実装計画を作成します。コード実装前にユーザー承認を待ちます。

実行内容
  • 要件の再定義・明確化
  • フェーズ分けされた実装ステップの作成
  • 依存関係の特定
  • リスク評価(HIGH/MEDIUM/LOW)
  • 複雑度の見積もり
/plan ユーザー認証機能を追加
/do ワークフロー

タスクを開始します。git worktree使用、モック禁止、動画エビデンスで確認することを前提に実装。

実装方針
  • git worktreeでメインブランチを汚さない
  • モック・スタブ・ハードコード禁止
  • 最終成果物は動画エビデンス

禁止事項

「実装しました!」だけの報告、動作確認なしの完了宣言

/do ダークモード切り替え機能を実装
/done ワークフロー

タスク完了時に動画エビデンスを作成して成果物を確認。E2Eテストで動画撮影して初めて完了。

必須要件
  • E2Eテストの実装(スクリーンショット+動画)
  • gotoは最初の「/」のみ許容
  • Sign Up/ログインから開始
  • DBレコード変化をassert
/done
/full-workflow ワークフロー

要件定義から実装・テスト・レビューまで一括実行。/plan + /tdd + /e2e + /code-review を統合したフルワークフロー。

5つのフェーズ
  • Phase 1: 計画(/plan相当)
  • Phase 2: TDD実装(RED→GREEN→REFACTOR)
  • Phase 3: E2Eテスト
  • Phase 4: コードレビュー
  • Phase 5: ビルド確認
/full-workflow ユーザーログイン機能を追加
/vibe スペシャル

Full Vibe Coding 2025。Serenaで60-80%トークン削減+必須動画エビデンスで品質保証。

コア原則
  • 実装を委譲し、検証ゲートで品質を担保
  • Serena MCPでトークン60-80%削減
  • 3段階検証(実装→動作検証→レビュー)

参考

https://zenn.dev/kazuph/articles/full-vibe-coding-2025

/vibe 新機能を実装

テスト

/tdd テスト

テスト駆動開発(TDD)ワークフローを強制。インターフェース定義→テスト作成→最小限実装→80%以上カバレッジ確保。

TDDサイクル
  • RED: 失敗するテストを書く
  • GREEN: テストが通る最小限のコード
  • REFACTOR: コード改善(テスト維持)
  • カバレッジ80%以上必須
/tdd 流動性スコア計算関数を作成
/e2e テスト

Playwrightを使用したE2Eテストの生成・実行。テストジャーニーの作成、スクリーンショット・動画・トレースのキャプチャ。

機能
  • ユーザーフローのテスト生成
  • 複数ブラウザでの実行
  • 失敗時のアーティファクト保存
  • フレーキーテストの検出
/e2e マーケット検索フローをテスト
/test-coverage テスト

テストカバレッジを分析し、不足しているテストを生成。80%以上のカバレッジを目標。

分析対象
  • カバレッジレポート解析
  • 80%未満のファイル特定
  • ユニット・統合・E2Eテスト生成
  • エッジケース・エラーハンドリング
/test-coverage

コード品質

/code-review 品質

コミット前の変更に対する包括的なセキュリティ&品質レビュー。

チェック項目
  • CRITICAL: ハードコード認証情報、SQLインジェクション、XSS
  • HIGH: 50行超の関数、800行超のファイル、エラーハンドリング漏れ
  • MEDIUM: ミューテーションパターン、テスト不足

注意

CRITICAL/HIGH問題がある場合はコミットをブロック

/code-review
/build-fix 品質

TypeScriptおよびビルドエラーを段階的に修正。

修正プロセス
  • ビルド実行 → エラー解析
  • ファイルごとにグループ化
  • 1つずつ修正 → 再ビルド → 検証
  • 3回試行で解決しない場合は停止
/build-fix
/refactor-clean 品質

デッドコードの特定と安全な削除(テスト検証付き)。

分析ツール
  • knip: 未使用エクスポート・ファイル
  • depcheck: 未使用依存関係
  • ts-prune: 未使用TypeScriptエクスポート

安全措置

削除前後に必ずテストを実行し、失敗時はロールバック

/refactor-clean

ドキュメント

/update-codemaps ユーティリティ

コードベース構造を分析し、アーキテクチャドキュメントを更新。

生成ファイル
  • codemaps/architecture.md
  • codemaps/backend.md
  • codemaps/frontend.md
  • codemaps/data.md
/update-codemaps
/update-docs ユーティリティ

package.jsonと.env.exampleから自動的にドキュメントを同期。

生成内容
  • docs/CONTRIB.md(開発ワークフロー)
  • docs/RUNBOOK.md(デプロイ・運用手順)
  • 環境変数ドキュメント
  • 90日以上更新のない古いドキュメントの特定
/update-docs

特殊用途

/serena スペシャル

Serena MCP(AIの賢い通訳者)。60-80%トークン削減、セマンティック検索、シンボルレベル編集。

4大利点
  • トークン効率: 60-80%削減
  • セマンティック理解: 意味で検索
  • 自動依存関係: 関連コード自動発見
  • 安全な編集: シンボルレベルで整合性保証

禁止事項

grepで全ファイル検索、ファイル全体を無差別に読み込み(Serenaで十分)

/serena シンボル検索 "UserService"
/create-pptx スペシャル

PowerPoint雛形を既存資料に適用して高品質なスライドを作成。

パラメータ
  • template: 雛形PowerPointファイルのパス
  • source: 元となるPowerPointファイルのパス
  • output: 出力先PowerPointファイルのパス
/create-pptx template="雛形.pptx" source="資料.pptx" output="完成版.pptx"
/web-health-app スペシャル

健康チェック系Webアプリの開発ガイド。仕様書に従った一貫した品質での開発。

開発プロセス
  • 要件確認 → 実装 → ビルドテスト → E2Eテスト → デプロイ
  • スマホ対応必須
  • 医療機関受診を促す文言は禁止
  • Google Sheets連携
/web-health-app
/web-build-health-app スペシャル

健康チェック系Webアプリを最初から最後まで一気に構築。

12ステップ
  • プロジェクト作成(Vite + React + TypeScript)
  • 共通コンポーネント・画面実装
  • 結果画面の必須機能(画像保存・共有・印刷)
  • Google Sheets連携
  • ビルドテスト・E2Eテスト
  • Git初期化・Vercelデプロイ
/web-build-health-app

コマンド体系図

                    ┌─────────────────────────────────────────────┐
                    │         /full-workflow (統合)                │
                    │   要件定義 → 実装 → テスト → レビュー        │
                    └─────────────────────────────────────────────┘
                                        │
        ┌───────────────┬───────────────┼───────────────┬───────────────┐
        ▼               ▼               ▼               ▼               ▼
  ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
  │  /plan   │   │   /tdd   │   │   /e2e   │   │/code-    │   │/build-   │
  │  計画    │ → │  実装    │ → │  検証    │ → │ review   │ → │  fix     │
  │          │   │          │   │          │   │レビュー  │   │ビルド    │
  └──────────┘   └──────────┘   └──────────┘   └──────────┘   └──────────┘
        │               │               │               │               │
        ▼               ▼               ▼               ▼               ▼
   要件整理        テスト先行      E2Eテスト      品質チェック    エラー修正
   リスク評価      RED→GREEN      動画撮影       セキュリティ    自動修復
   ステップ分解    REFACTOR       スクショ       コード品質
                

推奨ワークフロー

新機能開発時
ステップ
  • 1. /plan → 要件整理・承認取得
  • 2. /tdd → テスト先行で実装
  • 3. /e2e → E2Eテストで検証
  • 4. /code-review → 品質チェック
  • 5. /build-fix → ビルド確認

または

/full-workflow 新機能の説明 で一括実行

バグ修正時
ステップ
  • 1. /tdd バグを再現するテストを書く
  • 2. /build-fix エラーがあれば修正
  • 3. /code-review 修正内容を確認
リファクタリング時
ステップ
  • 1. /refactor-clean 不要コード検出
  • 2. /test-coverage テスト追加
  • 3. /code-review レビュー

重要な注意事項

1. 計画フェーズでは必ず承認を待つ

/plan 実行後、ユーザーの「yes」なしにコードは書かない

2. テストは先に書く(TDD)

実装後ではなく、必ずテストを先に書く

3. モック・スタブ・ハードコード禁止

実際に動作するコードを実装すること

4. 動画エビデンスで実装を証明

「実装しました!」だけの報告は禁止

5. セキュリティ問題は即座に修正

CRITICAL問題がある場合はコミット禁止