skill-creator

# Skill Creator

## 概要

スキルを作成・更新・プロンプト改善するためのメタスキル。
**Collaborative First**でユーザーと対話しながら共創、**Script First**で決定論的処理を自動化、**Progressive Disclosure**で必要なリソースのみを読み込む。

## 設計原則

| 原則 | 説明 |
|------|------|
| **Collaborative First** | ユーザーとの対話を通じて要件を明確化 |
| Script First | 決定論的処理はスクリプトで実行（100%精度） |
| Progressive Disclosure | 必要な時に必要なリソースのみ読み込み |
| Custom Script Support | 24タイプに収まらない独自スクリプトも生成 |
| Self-Contained Skills | 各スキルは独自のnode_modules・依存関係を持つ |

## モード一覧

| モード | 用途 | 開始方法 |
|--------|------|----------|
| **collaborative** | ユーザー対話型スキル共創（推奨） | AskUserQuestionでインタビュー開始 |
| **orchestrate** | 実行エンジン選択（Claude/Codex/連携） | AskUserQuestionでヒアリング開始 |
| create | 要件が明確な場合の新規作成 | `.claude/skills/skill-creator/scripts/detect_mode.js --request "新規スキル"` |
| update | 既存スキル更新 | `.claude/skills/skill-creator/scripts/detect_mode.js --request "更新" --skill-path <path>` |
| improve-prompt | プロンプト改善 | `.claude/skills/skill-creator/scripts/analyze_prompt.js --skill-path <path>` |

## 実行エンジン（orchestrateモード）

| エンジン | 説明 | 適用場面 |
|----------|------|----------|
| **claude** | Claude Code単独実行 | ファイル編集、Git操作、コードベース深い理解 |
| **codex** | Codex (GPT-5.2) 単独実行 | 独立したタスク、別視点での分析 |
| **claude-to-codex** | Claude → Codex連携 | コンテキスト共有が必要な複合タスク |

## 抽象度レベル

| レベル | 説明 | 例 |
|--------|------|-----|
| **L1: Concept** | アイデア・課題レベル | 「開発効率を上げたい」 |
| **L2: Capability** | 機能・能力レベル | 「PRを自動作成したい」 |
| **L3: Implementation** | 実装・詳細レベル | 「GitHub APIでPR作成」 |

**抽象度が高いほど、インタビューを通じて具体化する。**
📖 詳細: [references/abstraction-levels.md](.claude/skills/skill-creator/references/abstraction-levels.md)

---

# Part 0: Collaborative モード（推奨）

ユーザーと対話しながらスキルを共創するモード。

## ワークフロー

```
Phase 0-1: 初期ヒアリング
  Q1: 何を実現したいですか？ → 抽象度レベル判定
  Q2: 対象は何ですか？ → コンテキスト特定
  Q3: 頻度・規模は？ → 複雑さ判定
      ↓
Phase 0-2: 機能ヒアリング
  Q4: 必要な機能は？
  Q5: 外部連携は？
  Q6: スクリプトは？
      ↓
Phase 0-3: 構成ヒアリング
  Q7: 構成タイプは？（シンプル/標準/フル）
  Q8: 優先事項は？
      ↓
Phase 0-4: 要件確認
  → ユーザー確認後、Phase 1へ
```

📖 詳細: [agents/interview-user.md](.claude/skills/skill-creator/agents/i