Meta Skill Creator

Skill Creator

概要

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

設計原則

モード一覧

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

抽象度レベル

抽象度が高いほど、インタビューを通じて具体化する。 📖 詳細: 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

Part 0.5: Orchestrate モード（実行エンジン選択）

スキル作成プロセス内で、特定のサブタスクを最適な実行エンジンに委譲するモード。

skill-creator実行中 → 特定タスクでCodex使用 → Claude Code継続

ワークフロー

Phase 1-2: ヒアリング
  → .claude/skills/meta-skill-creator/agents/interview-execution-mode.md
  タスク内容・コンテキスト判定 → モード推奨・選択
      ↓
Phase 3: 実行（モード別分岐）
  claude: 直接実行
  codex: .claude/skills/meta-skill-creator/scripts/assign_codex.js
  claude-to-codex: コンテキスト収集 → Codex
      ↓
Phase 4: 結果確認・統合

📖 モード選択基準・詳細フローチャート: references/execution-mode-guide.md

関連リソース

Part 1: スキル作成ワークフロー（createモード）

Phase 1: 分析（LLM）
  .claude/skills/meta-skill-creator/agents/analyze-request.md
  → .claude/skills/meta-skill-creator/agents/extract-purpose.md
  → .claude/skills/meta-skill-creator/agents/define-boundary.md
      ↓
Phase 2: 設計（LLM + Script検証）
  .claude/skills/meta-skill-creator/agents/select-anchors.md ─┐
  .claude/skills/meta-skill-creator/agents/define-trigger.md ─┤
      → .claude/skills/meta-skill-creator/agents/design-workflow.md
      → .claude/skills/meta-skill-creator/scripts/validate_workflow.js
      ↓
Phase 3: 構造計画（LLM + Script検証）
  .claude/skills/meta-skill-creator/agents/plan-structure.md
  → .claude/skills/meta-skill-creator/scripts/validate_plan.js
      ↓
Phase 4: 生成（Script）
  .claude/skills/meta-skill-creator/scripts/init_skill.js
  → .claude/skills/meta-skill-creator/scripts/generate_skill_md.js
  → .claude/skills/meta-skill-creator/scripts/generate_agent.js
      ↓
Phase 5: フィードバック機構生成（Script）
  → LOGS.md, EVALS.json, references/patterns.md を生成
      ↓
Phase 6: 検証（Script）
  .claude/skills/meta-skill-creator/scripts/validate_all.js
  → .claude/skills/meta-skill-creator/scripts/log_usage.js

Part 2: スクリプト生成ワークフロー

24種類のスクリプトタイプ

📖 詳細: references/script-types-catalog.md

生成ワークフロー

Phase 1: 要件分析（LLM）→ script-requirement.json
Phase 2: ランタイム判定（Script）→ runtime-config.json
Phase 3: 設計（LLM）→ script-design.json
Phase 4: 変数設計（LLM）→ variables.json
Phase 5: コード生成（LLM）→ script-template.{ext}
Phase 6: コード展開（Script）→ 実行可能スクリプト
Phase 7: 検証（Script）

📖 カスタムスクリプト: agents/design-custom-script.md

Part 3: フィードバック＆自己改善ワークフロー

3.1 毎回実行後（必須）

スキル実行後は必ずフィードバックを記録する：

# 成功時
node .claude/skills/meta-skill-creator/scripts/log_usage.js --result success --phase "Phase 4" --notes "完了"

# 失敗時
node .claude/skills/meta-skill-creator/scripts/log_usage.js --result failure --phase "Phase 3" --error "ValidationError" --notes "理由"

記録先:

3.2 パターン発見時

成功/失敗パターンを発見したら記録する：

.claude/skills/meta-skill-creator/agents/analyze-feedback.md → パターン検出
     ↓
.claude/skills/meta-skill-creator/agents/save-patterns.md
     → .claude/skills/meta-skill-creator/references/patterns.md 更新

パターン形式:

• 成功パターン: 状況 → アプローチ → 結果 → 適用条件
• 失敗パターン: 状況 → 問題 → 原因 → 教訓

3.3 改善サイクル

定期的（10回実行ごと、またはエラー率閾値超過時）に改善を検討：

.claude/skills/meta-skill-creator/scripts/collect_feedback.js → feedback-data.json出力
     ↓
.claude/skills/meta-skill-creator/agents/analyze-feedback.md → パターン分析・改善提案生成
     ├─ patterns[] あり → .claude/skills/meta-skill-creator/agents/save-patterns.md
     │                  → .claude/skills/meta-skill-creator/references/patterns.md更新
     └─ suggestions[] あり → .claude/skills/meta-skill-creator/agents/design-self-improvement.md
     ↓
.claude/skills/meta-skill-creator/scripts/apply_self_improvement.js → 改善適用
  --dry-run: 事前確認（推奨）
  --backup: バックアップ作成
  --auto-only: 自動適用可能なもののみ

📖 詳細: references/self-improvement-cycle.md

3.4 フィードバック対象ファイル

Part 4: ライブラリ管理（Self-Contained Skills）

スキルは自己完結型。依存関係はスキルディレクトリ内で管理し、PNPMを使用する。

4.1 設計思想

4.2 依存関係管理コマンド

# スキルの依存関係をインストール
node .claude/skills/meta-skill-creator/scripts/install_deps.js

# パッケージを追加
node .claude/skills/meta-skill-creator/scripts/add_dependency.js axios

# 開発依存関係として追加
node .claude/skills/meta-skill-creator/scripts/add_dependency.js typescript --dev

# 他のスキルに対して実行
node .claude/skills/meta-skill-creator/scripts/install_deps.js --skill-path .claude/skills/my-skill

4.3 スキル構造（依存関係あり）

.claude/skills/my-skill/
├── package.json       # 依存関係定義
├── pnpm-lock.yaml     # 依存関係ロック（自動生成）
├── node_modules/      # 依存関係（スキル内に配置）
├── SKILL.md
├── scripts/
│   └── my-script.js   # import from 'axios' 等が使用可能
└── ...

📖 詳細: references/library-management.md

Part 5: Progressive Disclosure リソースマップ

リソースは必要な時のみ読み込む。詳細は resource-map.md を参照。

リソース概要

主要リソース（高頻度）

📖 全リソース詳細: references/resource-map.md

ベストプラクティス

変更履歴