Skill Refinement
既存のClaude Code Skillを分析し、より簡潔で効果的なものに洗練する。
Core Principle
品質 = AIの消費しやすさ。Claude既知の情報は削除。
Workflow
- 読込: 全ファイル読み込み、行数・文字数測定
- 分析: CHECKLIST.mdと照合、問題特定
- 修正: 削除・追加・書き換え適用
- 検証: 行数減少、機能維持、トリガー明確化確認
Actions
- 削除: 「〜とは」説明、背景説明、自明なステップ、重複
- 追加: 具体例、トリガー、失敗対処
- 書き換え: 曖昧→具体的、複雑→シンプル
Patterns
| Pattern | Action | |---------|--------| | Description | 曖昧→具体的、トリガー追加 | | 説明 | 教育的散文→実行可能コード | | ワークフロー | 10+ステップ→3-5ステップ | | Progressive | 500行超→分割+参照 |
詳細例はCHECKLIST.md参照。
Quality Targets
- Description: what + when + triggers (≤1024文字)
- Lines: ≤500
- References: 1階層
- Examples: 具体的・実行可能
詳細: CHECKLIST.md
問題パターン
| 問題 | 対策 | |------|------| | 過剰な説明 | 削除 | | 曖昧な記述 | 具体例に置換 | | 深い参照 | フラット化 | | 冗長なワークフロー | 3-5ステップに統合 | | トリガー不足 | キーワード追加 |
Anti-Patterns
| Anti-Pattern | 代替 |
|--------------|------|
| 教育的散文 | 直接的な指示 |
| 無限の選択肢 | デフォルト + escape hatch |
| Windowsパス | 常に / |
| 時間依存情報 | バージョン非依存 |
| 深い参照 | フラット構造 |