第6章 — Skills と Commands: 手順書の力

<!-- .claude/commands/commit.md -->
 
変更を論理単位に分けて Conventional Commits 形式でコミットする。
 
## 手順
 
1. `git status` と `git diff --staged` で変更内容を確認
2. 変更を論理的な単位に分割（1コミット = 1つの意図）
3. 各単位ごとに:
   - 適切なファイルを `git add` でステージ
   - Conventional Commits 形式でコミットメッセージを作成
   - `git commit` を実行
 
## Conventional Commits の形式
 
type(scope): description
 
- type: feat, fix, docs, style, refactor, test, chore
- scope: 省略可。変更の影響範囲
- description: 命令形、50文字以内
 
## 注意
 
- push はしない（ユーザーが確認してから push する）
- secret が含まれていないか確認する
- 1つのコミットに無関係な変更を混ぜない

<!-- .claude/commands/pr.md -->
 
現在のブランチの変更を要約し PR を作成する。
 
## 手順
 
1. 並列で実行:
   - `git status` で未追跡ファイルを確認
   - `git diff` でステージ済み・未ステージの変更を確認
   - `git log main..HEAD` でコミット履歴を確認
   - `git diff main...HEAD` で差分全体を確認
 
2. すべてのコミットを分析し、PR タイトルと要約を作成:
   - タイトルは70文字以内
   - 要約は箇条書き3点以内
 
3. 並列で実行:
   - 必要なら新ブランチを作成
   - リモートに push（-u フラグ付き）
   - `gh pr create` で PR を作成
 
## PR 本文のフォーマット
 
## Summary
- 変更点1
- 変更点2
 
## Test plan
- [ ] テスト項目1
- [ ] テスト項目2

<!-- .claude/commands/review.md -->
 
指定されたファイルまたは変更をレビューする。
 
## 引数
$ARGUMENTS — レビュー対象（ファイルパス、PR番号、または "diff"）
 
## 手順
 
1. 引数に応じてレビュー対象を特定:
   - ファイルパスの場合: そのファイルを読む
   - PR番号の場合: `gh pr diff <番号>` で差分を取得
   - "diff" の場合: `git diff` で現在の変更を取得
 
2. 以下の観点でレビュー:
   - バグの可能性
   - セキュリティリスク
   - パフォーマンス問題
   - 可読性・保守性
 
3. 問題を重要度順に報告

<!-- ❌ 詰め込みすぎ -->
# deploy.md
テストを実行し、ビルドし、デプロイし、Slack に通知する
 
<!-- ✅ 分割 -->
# test.md — テストを実行
# build.md — ビルドを実行
# deploy.md — デプロイを実行（テストとビルドが通っていることを前提）
# notify.md — Slack に通知

<!-- ❌ 曖昧 -->
コードをレビューしてください
 
<!-- ✅ 具体的 -->
以下の順序でレビュー:
1. `git diff main...HEAD` で変更差分を取得
2. 変更されたファイルを1つずつ読む
3. バグ → セキュリティ → パフォーマンス → 可読性の順で問題を報告
4. 各問題に severity (high/medium/low) を付与

## 出力フォーマット
 
### 発見事項
- **[HIGH]** ファイル:行番号 — 問題の説明
- **[MED]** ファイル:行番号 — 問題の説明
 
### サマリー
- HIGH: N件
- MEDIUM: N件
- LOW: N件