Skills (スキル) と専門知識

~/.claude/skills/
└── pdf-extraction/
    ├── SKILL.md            # 概要 (Claude がまず読むファイル)
    ├── reference.md        # 詳細リファレンス (必要時に参照)
    ├── examples.md
    └── scripts/
        └── extract.py

---
name: pdf-extraction
description: PDF からテキスト・表を抽出する手順
---

# PDF 抽出スキル

## いつ使うか
ユーザーが「PDF を要約」「PDF から表を抜く」などを依頼したとき。

## 手順
1. `pip install pdfplumber`
2. `scripts/extract.py <path>` を実行
3. 出力 JSON を要約

## 落とし穴
- スキャン PDF は OCR が必要。Tesseract を案内すること。

---
name: api-versioning
description: REST API のバージョニング規約を提供。ユーザーが「API のバージョン」「v2 endpoint」「後方互換」「deprecate」などについて質問したり、新しいエンドポイントを追加するときに自動発火。
---

# REST API バージョニング・スキル

## いつ発火するか
- 新しい API エンドポイントを追加する依頼
- 既存エンドポイントの破壊的変更
- 「v2 にしたい」「deprecate」などの言葉が出たとき

## 採用している規約
- URL パスベース (`/api/v1/...`, `/api/v2/...`)
- ヘッダ: `Accept: application/vnd.our-app.v2+json` (二重サポート時のみ)

## 破壊的変更の手順
1. 新しい version の endpoint を **追加** (旧版は残す)
2. 旧版に `Deprecation: true` ヘッダ + `Sunset: <日付>` を付与
3. レスポンスに `_deprecated: true` フィールドを追加 (JSON の場合)
4. 6 ヶ月の移行期間を経て旧版を削除

## してはいけないこと
- 既存の `v1` のレスポンス形を変える (新フィールド追加は OK)
- 既存の HTTP ステータスコードを変える
- 旧版を予告なく削除

詳細な手順は @reference.md

---
name: pii-redaction
description: ログや顧客データを Claude に貼る前に PII (個人情報) をマスキングする手順。ユーザーが「ログを分析」「顧客データを見せる」「PII」「マスキング」と言ったとき発火。
---

# PII マスキング・スキル

## いつ発火
ユーザーが顧客データ・ログ・スクショを Claude に渡そうとするとき。

## マスキング対象
- 氏名 → 「ユーザー A」「ユーザー B」
- メール → `[email_1]`, `[email_2]`
- 電話 → `[phone_1]`
- 住所 → 「[住所_1]」(都道府県以下を削除)
- クレジットカード → `[card_xxxx]`
- IP アドレス → `[ip_1]` (デバッグ目的なら下位 octet だけ残す)
- 社内 URL → `[internal_url_1]`

## 推奨フロー
1. 元データをコピー
2. `scripts/redact.py` を実行 (下記参照)
3. 出力を確認
4. 確認 OK なら Claude に渡す

## scripts/redact.py
@scripts/redact.py を参照。

## 注意
- 同一顧客は同じ ID にマッピング (関係性が保たれるよう)
- マスキング後の文字数が大幅に変わると統計が崩れるので注意

---
name: commit-message-jp
description: 日本語のコミットメッセージ規約。git commit を依頼されたときに自動発火。Conventional Commits を日本語で運用するチーム向け。
---

# 日本語コミットメッセージ規約

## いつ発火
git commit を Claude が打とうとするとき。

## フォーマット
\`\`\`
<種別>: <概要 (50 字以内)>

<詳細 (任意。何を/なぜ。72 字で改行)>
\`\`\`

## 種別
- `feat`: 新機能
- `fix`: バグ修正
- `refactor`: リファクタ (挙動変更なし)
- `docs`: ドキュメント
- `test`: テスト
- `chore`: ビルド・設定・依存
- `perf`: パフォーマンス改善
- `style`: フォーマット (挙動変更なし)

## 良い例
\`\`\`
feat: ログイン画面に Google OAuth を追加

ユーザーが Google アカウントでログインできるようにする。
authlib を使い OAuth 2.0 フローを実装。テスト 3 件追加。
\`\`\`

## 悪い例
\`\`\`
update                  ← 種別なし、概要なし
fix: バグ修正           ← 何のバグかわからない
すごい機能を追加した！   ← 種別なし、感情的
\`\`\`

## 禁止事項
- 概要に絵文字 (Slack 通知が崩れる現場用)
- 概要に末尾ピリオド・句点
- 「ちょっと」「とりあえず」などの曖昧表現
- 「Co-authored-by: Claude」などの追記 (人がコミットする想定)