Skills: トラブルシューティングとよくある問題

問題診断4層
├── 第1層：ファイル層
│   ├── ファイルは存在するか？
│   ├── パスは正しいか？
│   └── Frontmatter は有効か？
├── 第2層：設定層
│   ├── トリガーはマッチするか？
│   ├── ツールはバインドされているか？
│   └── 権限は十分か？
├── 第3層：プロンプト層
│   ├── 指示は明確か？
│   ├── サンプルは十分か？
│   └── 制約は明示的か？
└── 第4層：実行層
    ├── ツールは期待通りに呼び出されたか？
    ├── 出力はフォーマットに合致するか？
    └── 結果は目的を満たしているか？

プロンプト A/B テスト
1. 他のすべての条件を同じに保つ
2. プロンプトの1要素だけを変更
3. 出力品質を比較
4. より良い方を採用
5. 変更理由を記録

問題再現の手順
1. 最小の Skill ファイルを作成
2. コアプロンプトだけを残す
3. 問題が再現するか確認
4. 段階的に内容を追加し、トリガー条件を特定
5. 特定の問題に対して修正

一般的な微調整テクニック
├── サンプル追加：出力フォーマットが間違っている → 期待する出力サンプルを追加
├── 制約追加：冗長すぎる → 「簡潔に、N行以内」を追加
├── ステップ追加：ツールが呼び出されない → 「ステップN：XXツールを使用」を追加
├── 条件追加：誤った振る舞い → 「Xの場合はY、それ以外はZ」を追加
└── 否定追加：やってはいけないことをやっている → 「Xをしないで」を追加

ツール問題の修正
├── ツールが呼び出されない：フロー内で「Read ツールでファイルを読み込む」と明示的に指定
├── 間違ったツールが使われる：プロンプトで「Write ではなく Edit でファイルを修正」と記述
├── 権限不足：settings.json の allow/deny 設定を確認
└── ツールタイムアウト：検索範囲を絞り、データ量を削減

トリガー問題の修正
├── トリガーされない：キーワードが一般的すぎる → 一般的な同義語を追加
├── 誤トリガー：キーワードが広すぎる → マッチ範囲を絞る
├── 競合：複数 Skill が競合 → 優先度を調整
└── 頻発：条件が緩すぎる → AND 条件を追加

## デバッグチェックリスト

### 基本チェック
- [ ] ファイルパスが正しい
- [ ] Frontmatter YAML 構文が正しい
- [ ] name と description が記入されている
- [ ] triggers が設定されている

### 機能チェック
- [ ] ツールバインディングが完全
- [ ] プロンプトに明確な実行ステップがある
- [ ] 出力フォーマットのサンプルが存在する
- [ ] 制約と境界条件がある

### 品質チェック
- [ ] テストプロジェクトで検証済み
- [ ] 出力フォーマットが安定している
- [ ] ツール呼び出しが合理的
- [ ] セキュリティリスクがない