Claude Code カスタムスキル完全ガイド｜.claude/skills/で繰り返し作業をスラッシュコマンド化する方法

.claude/
└── skills/
    ├── review/
    │   └── SKILL.md          # /review コマンドになる
    ├── commit/
    │   └── SKILL.md          # /commit コマンドになる
    └── test-gen/
        ├── SKILL.md          # /test-gen コマンドになる
        ├── examples/
        │   └── sample.md     # 期待出力の例（オプション）
        └── scripts/
            └── helper.sh     # 前処理スクリプト（オプション）

---
name: review
description: 指定したファイルまたは現在の変更をコードレビューする
argument-hint: [ファイルパス]
---

$ARGUMENTSで指定されたファイル（引数なしの場合はgit diffの変更）をコードレビューしてください。

以下の観点でレビューしてください:
1. バグ・潜在的なエラー
2. セキュリティ上の問題（SQLインジェクション、XSS、機密情報の漏洩等）
3. パフォーマンスの問題
4. コードの可読性・命名
5. テストの欠落

問題を発見した場合は、ファイル名と行番号を明記して具体的な修正案を示してください。

---
name: migrate
description: コンポーネントを指定フレームワークから別フレームワークへ移行する
argument-hint: [コンポーネント名] [移行元] [移行先]
---

$0 コンポーネントを $1 から $2 に移行してください。

移行手順:
1. $0 の現在の実装を src/components/$0/ で読み取る
2. $2 の書き方に対応した実装に変換する
3. テストファイル（$0.test.ts）も $2 対応に更新する
4. 変更内容を説明するコメントをコードに追加する

# 1つの引数
/fix 123

# 複数の引数
/migrate SearchBar React Vue

# 引数なし（$ARGUMENTS が空になる）
/review

---
name: pr-review
description: 現在のPRの差分とコメントをもとにコードレビューを行う
---

以下の情報をもとに、このPRをレビューしてください。

## PRの差分
!`gh pr diff`

## PRの説明とコメント
!`gh pr view --comments`

レビューの観点:
1. PRの説明と実際の変更内容が一致しているか
2. バグ・セキュリティ問題
3. テストの十分さ
4. ドキュメントの更新が必要かどうか

---
name: commit
description: git diffのステージング済み変更を分析してコミットメッセージを作成しgit commitする
---

ステージング済みの変更をレビューしてコミットしてください。

## 変更内容
!`git diff --staged`

## 指示
1. 変更内容を分析し、適切なコミットメッセージを作成する
2. Conventional Commits形式で書く（feat/fix/refactor/test/docs/chore）
3. 件名は50文字以内の日本語で書く
4. 変更の「何を」「なぜ」が分かる内容にする
5. `git commit -m "件名"` を実行する

コミットメッセージの例:
- feat: ユーザー認証にOAuth2.0を追加
- fix: セッションタイムアウト時のリダイレクト先を修正
- refactor: UserServiceをRepositoryパターンに分離

---
name: test-gen
description: 指定したファイルのユニットテストを自動生成する
argument-hint: [ファイルパス]
allowed-tools: Read, Write, Bash
---

$ARGUMENTS のユニットテストを作成してください。

## 手順
1. $ARGUMENTS を読み込んで実装を把握する
2. 既存テストファイルがあれば読み込んでスタイルを合わせる
3. 以下の観点でテストケースを作成する:
   - 正常系: 主要な機能が期待通り動作するか
   - 異常系: エラーケース・境界値・nullチェック
   - エッジケース: 空配列・最大値・特殊文字等
4. テストファイルをソースファイルと同ディレクトリに配置（.test.tsサフィックス）
5. `npm run test $ARGUMENTS` で実行してグリーンになることを確認する

テストフレームワーク: このプロジェクトで使用しているものを自動判定する

---
name: fix-issue
description: GitHubのIssue番号を受け取り、内容を読んで実装・PRを作成する
argument-hint: [Issue番号]
---

GitHub Issue #$ARGUMENTS を解決してください。

## Issueの内容
!`gh issue view $ARGUMENTS`

## 手順
1. Issueの内容を読んで実装方針を決定する
2. 新しいブランチを作成する: `git checkout -b fix/issue-$ARGUMENTS`
3. 実装する（テストも含めて）
4. `git add` して変更をステージングする
5. コミットする（コミットメッセージにIssue番号を含める）
6. PRを作成する: `gh pr create --title "fix: Issue #$ARGUMENTS の修正" --body "Closes #$ARGUMENTS"`

実装前に計画を提示して承認を取ってから進めること。

---
name: debug
description: エラーメッセージや症状を受け取ってバグの原因を特定し修正する
argument-hint: [エラーメッセージまたは症状の説明]
---

以下のバグを調査して原因を特定し、修正してください。

## 症状・エラー
$ARGUMENTS

## 手順
1. エラーメッセージ・スタックトレースを分析する
2. 関連するソースファイルを読む（エラーが発生している箇所から追う）
3. 原因を特定する（複数ある場合はすべて列挙）
4. 最も可能性が高い原因から修正する
5. 修正後にテストを実行して確認する

注意: 根本原因を修正すること。症状を隠すような修正（try/catchで握りつぶす等）は避ける。

---
name: arch-review
description: プロジェクト全体のアーキテクチャを分析してレポートを作成する（読み取り専用）
allowed-tools: Read, Glob, Grep
context: fork
effort: high
---

このプロジェクトのアーキテクチャを分析してレポートを作成してください。

## 分析観点
1. レイヤー構造と依存関係（循環依存の有無）
2. 責務の分離（単一責任原則の遵守状況）
3. テスタビリティ（DIの使用・モック可能性）
4. 技術的負債と改善優先度
5. スケール時のボトルネック候補

## 出力形式
`docs/architecture-review.md` として保存すること。
変更・削除・コマンド実行は行わず、レポート作成のみ行うこと。

# Claude Code の個人設定は共有しない
.claude/settings.local.json
.claude/MEMORY.md
.claude/memory/

# スキルはチームで共有する（除外しない）
# .claude/skills/ はgitに追加する

## カスタムスキル一覧

このプロジェクトでは以下のカスタムコマンドが使えます:

| コマンド | 説明 | 使い方 |
|---------|------|-------|
| `/review` | コードレビュー | `/review src/auth/login.ts` |
| `/commit` | ステージング済み変更をコミット | `/commit` |
| `/test-gen` | テストコード自動生成 | `/test-gen src/services/user.ts` |
| `/fix-issue` | GitHub Issue を実装 | `/fix-issue 123` |
| `/debug` | バグの原因調査と修正 | `/debug "TypeError: Cannot read property..."` |
| `/arch-review` | アーキテクチャレビュー | `/arch-review` |