meta-skill-creator

name	meta-skill-creator
description	スキルを作成・更新・プロンプト改善するためのメタスキル。 **collaborative**モードでユーザーと対話しながら共創し、 抽象的なアイデアから具体的な実装まで柔軟に対応する。 **orchestrate**モードでタスクの実行エンジン（Claude Code / Codex / 連携）を選択。 Anchors: • Continuous Delivery (Jez Humble) / 適用: 自動化パイプライン / 目的: 決定論的実行 • The Lean Startup (Eric Ries) / 適用: Build-Measure-Learn / 目的: 反復改善 • Domain-Driven Design (Eric Evans) / 適用: ユビキタス言語 / 目的: 一貫した語彙 • Design Thinking (IDEO) / 適用: ユーザー中心設計 / 目的: 共感と共創 • Microservices Patterns (Richardson) / 適用: サービス委譲 / 目的: 疎結合な連携 Trigger: 新規スキルの作成、既存スキルの更新、プロンプト改善を行う場合に使用。 スキル作成, スキル更新, プロンプト改善, skill creation, skill update, improve prompt, Codexに任せて, assign codex, Codexで実行, GPTに依頼, 実行モード選択, どのAIを使う
allowed-tools	["Read","Write","Edit","Bash","Glob","Grep","Task","AskUserQuestion"]

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/meta-skill-creator/scripts/detect_mode.js --request "新規スキル"
update	既存スキル更新	.claude/skills/meta-skill-creator/scripts/detect_mode.js --request "更新" --skill-path <path>
improve-prompt	プロンプト改善	.claude/skills/meta-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

---

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

関連リソース

リソース	読み込み条件
interview-execution-mode.md	Phase 1-2
delegate-to-codex.md	Codex実行時
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種類のスクリプトタイプ

カテゴリ	タイプ
API関連	api-client, webhook, scraper, notification
データ処理	parser, transformer, aggregator, file-processor
ストレージ	database, cache, queue
開発ツール	git-ops, test-runner, linter, formatter, builder
インフラ	deployer, docker, cloud, monitor
統合	ai-tool, mcp-bridge, shell
汎用	universal

📖 詳細: 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 "理由"

記録先:

ファイル	更新内容
LOGS.md	実行ログ（日時、結果、フェーズ、メモ）
EVALS.json	メトリクス（成功率、実行回数、平均時間）

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 フィードバック対象ファイル

ファイル	用途	更新タイミング	スクリプト/エージェント
LOGS.md	実行ログ	毎回実行後	scripts/log_usage.js
EVALS.json	メトリクス	毎回実行後	scripts/log_usage.js
references/patterns.md	成功/失敗パターン	パターン発見時	agents/save-patterns.md

---

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

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

4.1 設計思想

原則	説明
自己完結	各スキルが独自のnode_modules・package.jsonを持つ
分離	プロジェクト本体の依存関係と干渉しない
再現性	pnpm-lock.yamlで依存関係を固定

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 を参照。

リソース概要

カテゴリ	数	主な読み込み条件
agents/	20	モード・Phase別に必要時のみ
references/	23	設計・判断・詳細確認時
scripts/	25	決定論的処理実行時（utils.js共通）
assets/	17	生成・テンプレート展開時
schemas/	23	JSON検証時

主要リソース（高頻度）

リソース	読み込み条件
agents/interview-user.md	collaborativeモード
agents/analyze-request.md	createモード
scripts/utils.js	全スクリプト共通
scripts/init_skill.js	スキル初期化
scripts/log_usage.js	毎回実行後
references/script-commands.md	スクリプト実行時
references/resource-map.md	全リソース詳細

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

---

ベストプラクティス

すべきこと	避けるべきこと
Script優先（決定論的処理）	全リソースを一度に読み込む
LLMは判断・創造のみ	Script可能な処理をLLMに任せる
Progressive Disclosure	具体例をテンプレートに書く
中間出力は.tmp/に保存	中間ファイルを省略

---

変更履歴

Version	Date	Changes
5.7.0	2026-01-21	SKILL.md最適化: Part 5をresource-map.mdに分離（485→375行、23%削減）、スクリプトutils.js統合完了
5.6.1	2026-01-21	DRYリファクタリング: utils.js共通モジュール作成、約270行の重複コード排除
5.6.0	2026-01-21	Self-Contained Skills: PNPM依存関係管理、package.json自動生成、install_deps.js/add_dependency.js追加
5.5.2	2026-01-20	参照パス完全統一: ワークフロー図・コマンド例・テーブル内のすべての参照を完全パス化（105参照）
5.5.1	2026-01-20	参照パス統一: Markdownリンクをリポジトリルートからの相対パスに統一
5.5.0	2026-01-20	最適化: SKILL.md 521→420行に削減、Part 0.5詳細をexecution-mode-guide.mdへ移動
5.4.0	2026-01-20	フィードバック機構強化: Part 3をフィードバック＆自己改善に拡張、save-patterns.mdエージェント追加
5.3.0	2026-01-15	Progressive Disclosure完全化: 全ファイル（19 refs, 23 schemas, 34 assets, 22 scripts）に読み込み条件追加
5.2.1	2026-01-15	Codex連携の目的明確化: スキル作成内サブタスク委譲用、Claude Code⇄Codexラウンドトリップパターン
5.2.0	2026-01-15	Orchestrateモード追加: Codex連携機能、実行エンジン選択（claude/codex/claude-to-codex）
5.1.0	2026-01-15	リファクタリング: SKILL.md簡素化、agents/フォーマット統一、workflow-patterns.md統合
5.0.0	2026-01-15	Collaborative First追加、抽象度レベル対応、カスタムスクリプト対応
4.0.0	2026-01-13	スクリプト生成ワークフロー追加、自己改善サイクル追加
3.0.0	2026-01-06	3モード対応（create/update/improve-prompt）