Claude Codeで業務用スラッシュコマンドセットを構築する｜設計からチーム展開まで一気通貫

スラッシュコマンドを個別に作れるようになったら、次のステップは「業務全体をカバーするコマンドセット」の構築です。
朝のルーティン、PR提出前チェック、デプロイ準備――こうした定型ワークフローをコマンドの組み合わせで標準化すれば、チーム全体の作業品質が底上げされます。
本記事では、実務で使える5つのコマンドの設計・実装から、ワークフロー連携、チーム展開、ライフサイクル管理までを一気に解説します。

1 前提知識
2 「点」から「線」へ――コマンドセットの設計思想
3 ハンズオン：コマンドセットを構築する
4 完成したコマンドセット一覧
5 チーム展開とライフサイクル管理
6 まとめ
7 次に試してみよう

前提知識

Claude Codeのスラッシュコマンド（Built-in / Skill由来）の基本を理解していることを前提とします。.claude/commands/ へのコマンドファイル配置、$ARGUMENTS による引数渡し、命名規約（プレフィックス＋ケバブケース）の知識があるとスムーズです。

前提知識について詳しく知りたい人は、以下の記事を参考にしてください。

「点」から「線」へ――コマンドセットの設計思想

個別コマンドを単独で使うのは「点」の運用です。実務で真価を発揮するのは、複数コマンドを組み合わせた「線」としてのワークフロー設計です。

朝のルーティン:
  /ops-morning-routine（一括チェック）

PR提出前チェック:
  /check-code-quality → /check-pr-ready → /review

デプロイ準備:
  /ops-deploy-prep → /check-code-quality

コマンドセットの品質は 網羅性・一貫性・実用性・保守性 の4観点で評価します。

ハンズオン：コマンドセットを構築する

/check-code-quality — コード品質を総合評価する

cat << 'EOF' > .claude/commands/check-code-quality.md
<!--
command: check-code-quality
version: 1.0.0
author: team
description: src/配下の全ファイルに対してコード品質を総合評価する
arguments: なし
-->

# コード品質チェック

## 目的
src/ 配下のすべてのコードファイルに対して品質チェックを実施し総合評価する。

## 実行内容

1. **ファイル一覧の取得** — src/ 配下の全コードファイルを列挙
2. **品質チェック（各ファイル）** — 型ヒント、docstring、エラーハンドリング、命名規約、コード複雑度
3. **総合スコアの算出** — 各観点5段階評価、平均スコアを算出

## 出力形式

=== Code Quality Report ===
Date: (実行日時)

[File: ファイル名]
- 型ヒント:     ★★★★☆ (4/5)
- docstring:    ★★★☆☆ (3/5)
- エラー処理:   ★★☆☆☆ (2/5)
- 命名規約:     ★★★★★ (5/5)
- コード複雑度: ★★★★☆ (4/5)
- ファイルスコア: 3.6/5.0

[総合評価]
- 全体スコア: X.X/5.0
- 評価: A (4.5以上) / B (3.5以上) / C (2.5以上) / D (2.5未満)
- 最優先改善項目: ○○

=== End of Report ===
EOF

/ops-deploy-prep — デプロイ前準備チェック

$ARGUMENTS で対象環境（dev/staging/production）を指定できるコマンドです。

cat << 'EOF' > .claude/commands/ops-deploy-prep.md
<!--
command: ops-deploy-prep
version: 1.0.0
author: team
description: デプロイ前の準備状態を確認する
arguments: 対象環境（dev/staging/production）。省略時はdevとして扱う
-->

# デプロイ前準備チェック

## 目的
デプロイ前に必要なチェック項目を網羅的に確認し、デプロイ可否を判定する。

## 実行内容

対象環境: $ARGUMENTS (指定がなければ dev として扱う)

1. **Git状態のチェック** — 未コミット変更、ブランチ、リモート同期
2. **コード品質チェック** — シンタックスエラー、TODO/FIXME/HACK残存、デバッグコード残存
3. **設定ファイルチェック** — 必須設定の存在、.gitignore、.envがコミットされていないか
4. **テスト確認** — tests/ の存在、テストファイルの有無
5. **環境別チェック** — dev: 基本のみ / staging: +設定整合性 / production: +セキュリティ強化

## 出力形式

=== Deploy Preparation Check ===
Environment: (対象環境)

[Git Status]        ✓ PASS / ✗ FAIL
[Code Quality]      ✓ PASS / ✗ FAIL
[Config Files]      ✓ PASS / ✗ FAIL
[Tests]             ✓ PASS / ✗ FAIL
[Env-specific]      ✓ PASS / ✗ FAIL

[Deploy Decision]
Result: GO / NO-GO
Reason: (NO-GOの場合はブロッカーを列挙)

=== End of Check ===
EOF

/check-pr-ready — PR提出前の総合チェック

Git差分の分析、コード品質確認、コミット履歴の検証、PR説明文の下書き生成まで一括で行うコマンドです。

cat << 'EOF' > .claude/commands/check-pr-ready.md
<!--
command: check-pr-ready
version: 1.0.0
author: team
description: PR提出前の準備状態を総合チェックする
arguments: なし
-->

# PR提出前チェック

## 実行内容

1. **Git差分の確認** — 変更ファイル一覧、追加・削除行数、巨大変更(300行以上)の警告
2. **コード品質** — 変更ファイルの品質チェック、CLAUDE.md規約違反、TODO/FIXMEの新規追加
3. **コミット履歴** — メッセージの適切さ、WIPコミットの残存確認
4. **PR説明の下書き生成** — 変更内容を要約

## 出力形式

=== PR Readiness Check ===
Branch: (ブランチ名)

[Changes Summary]
- Files changed: N / Lines: +N / -N

[Code Quality]    ✓ PASS / ✗ FAIL
[Commit History]  ✓ PASS / ✗ FAIL
[Conventions]     ✓ PASS / ✗ FAIL

[PR Description Draft]
## 変更概要
(自動生成)

[Verdict]
Ready: YES / NO

=== End of Check ===
EOF

/gen-test — ユニットテスト自動生成

cat << 'EOF' > .claude/commands/gen-test.md
<!--
command: gen-test
version: 1.0.0
author: team
description: 指定ファイルのユニットテストを自動生成する
arguments: テスト対象のファイルパス
-->

# テストコード生成

対象ファイル: $ARGUMENTS

## 実行内容

1. **対象ファイルの分析** — 公開関数・クラス・メソッドの列挙、引数と戻り値の特定
2. **テストケースの設計** — 正常系、異常系、境界値
3. **テストコードの生成** — tests/ に pytest形式で作成、日本語docstring付与
4. **結果報告** — 生成テストケース数と実行方法の案内

実行: pytest (生成先パス) -v
EOF

/ops-morning-routine — 朝の作業開始ルーティン

環境チェック・CLAUDE.md確認・コード状態確認・推奨事項の提示を一括実行するワークフローコマンドです。

cat << 'EOF' > .claude/commands/ops-morning-routine.md
<!--
command: ops-morning-routine
version: 1.0.0
author: team
description: 朝の作業開始時に実行する一連のチェックを順次実行する
arguments: なし
-->

# 朝の作業開始ルーティン

## 実行内容

1. **環境チェック** — ディレクトリ確認、Git状態、リモートとの差分
2. **CLAUDE.md確認** — 存在チェック、最終更新日、ルール件数
3. **コード状態の確認** — src/のファイル数、直近5コミット、TODO/FIXME一覧
4. **本日の作業推奨事項** — チェック結果から優先度順にリストアップ

## 出力形式

========================================
  Morning Routine Report
  Date: (今日の日付)
========================================

[1. Environment]
- Branch: / Uncommitted: あり/なし / Remote sync: 同期済み or N commits behind

[2. CLAUDE.md]
- Status: 存在する/しない / Rules: N items

[3. Code Status]
- Files in src/: N / TODO/FIXME: N items

[4. Today's Recommendations]
1. (最優先) ○○
2. (推奨) ○○
3. (余裕があれば) ○○

========================================
  Ready to start! Have a productive day.
========================================
EOF

完成したコマンドセット一覧

カテゴリ	コマンド	機能
check-	/check-code-quality	src/全体の品質評価
check-	/check-pr-ready	PR提出前チェック
gen-	/gen-test	ユニットテスト自動生成
ops-	/ops-deploy-prep	デプロイ前準備チェック
ops-	/ops-morning-routine	朝のルーティン

Built-inコマンド（/status, /review, /compact, /memory, /doctor）と組み合わせれば、開発ライフサイクル全体をカバーできます。

チーム展開とライフサイクル管理

展開に必要な3点セット

コマンドファイル一式: .claude/commands/ をGitにコミット
コマンドカタログ: 一覧とワークフローをまとめたドキュメント
オンボーディングガイド: セットアップ手順と日常の使い方

これらの作業もスラッシュコマンドでまとめることで、より作業が効率化されます。

コマンドのライフサイクル

追加: 命名規約に従い、テンプレートベースで作成 → テスト → カタログ追記 → PRでレビュー

更新: メタ情報の version を上げ、updated を更新 → カタログ反映 → コミット

廃止: メタ情報に deprecated: true 追加 → 代替コマンド案内 → 1ヶ月猶予後に削除

まとめ

業務コマンドセットは「網羅性」「一貫性」「実用性」「保守性」の4観点で品質を担保する
個別コマンドを「線」としてのワークフローに組み上げることで、チーム全体の作業品質が均一化される
チーム展開には「コマンドファイル」「カタログ」「オンボーディングガイド」の3点セットが必要
ライフサイクル管理（追加・更新・廃止）のプロセスを明文化して長期的な保守を可能にする

次に試してみよう

今回構築したコマンドセットをベースに、自分の業務に合わせたオリジナルコマンドを2つ追加してみましょう。「テンプレートからの作成 → 動作テスト → カタログ追記」の流れを一度体験すると、チーム展開のイメージがつかめます。

さらに深く学びたい方へ
Claude Codeの Skills・MCP・Agent・Hooks・Plugin を体系的に学べる実践ガイドを Zenn Book で公開中です。
全5章・41記事のハンズオン教材を、章ごとに順次公開しています。現在公開中の章は無料で読めます。
Claude Code 実践ガイド｜Skills・MCP・Agent・Hooks・Plugin（Zenn Book）