skill-generator

スキルジェネレーター

設定可能な実行モードで新しい Claude Code スキルを作成するためのメタスキルです。

アーキテクチャの概要

┌─────────────────────────────────────────────────────────────────┐
│                    Skill Generator                               │
│                                                                  │
│  Input: User Request (skill name, purpose, mode)                │
│                         ↓                                        │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │  Phase 0-5: Sequential Pipeline                          │    │
│  │  ┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌────┐             │    │
│  │  │ P0 │→│ P1 │→│ P2 │→│ P3 │→│ P4 │→│ P5 │             │    │
│  │  │Spec│ │Req │ │Dir │ │Gen │ │Spec│ │Val │             │    │
│  │  └────┘ └────┘ └────┘ └─┬──┘ └────┘ └────┘             │    │
│  │                         │                                │    │
│  │                    ┌────┴────┐                           │    │
│  │                    ↓         ↓                           │    │
│  │              Sequential  Autonomous                      │    │
│  │              (phases/)   (actions/)                      │    │
│  └─────────────────────────────────────────────────────────┘    │
│                         ↓                                        │
│  Output: .claude/skills/{skill-name}/ (complete package)        │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

実行モード

モード 1：シーケンシャル（固定順序）

従来の直線的な実行モデルです。フェーズは数値プレフィックスの順に実行されます。

Phase 01 -> Phase 02 -> Phase 03 -> ... -> Phase N

ユースケース：

• パイプラインタスク（収集 -> 分析 -> 生成）
• フェーズ間に強い依存関係がある場合
• 出力構造が固定されている場合

例：software-manual、copyright-docs

モード 2：自律型（ステートレスな自動選択）

インテリジェントなルーティングモデルです。コンテキストに基づいて、実行経路を動的に選択します。

---------------------------------------------------
                Orchestrator Agent
   (Read state -> Select Phase -> Execute -> Update)
---------------------------------------------------
                |
    ---------+----------+----------
    |        |          |
  Phase A   Phase B    Phase C
  (standalone)  (standalone)  (standalone)

ユースケース：

• 対話型タスク（チャット、Q&A）
• フェーズ間に強い依存関係がない場合
• 動的なユーザーの意図への対応が必要な場合

例：issue-manage、workflow-debug

主な設計原則

1. モード認識：タスクの特性に基づいて、実行モードを自動的に推奨します
2. スケルトンの生成：完全なディレクトリ構造とファイルのスケルトンを生成します
3. 標準への準拠：_shared/SKILL-DESIGN-SPEC.md に厳密に従います
4. 拡張性：生成された Skills は簡単に拡張・変更できます

---

必須の事前準備

重要：生成処理を行う前に、以下の仕様書を読んでください。これらの標準を理解せずに生成すると、要件に適合しない出力になります。

コア仕様（必読）

ドキュメント	目的	優先度
../_shared/SKILL-DESIGN-SPEC.md	汎用設計仕様 — すべての Skills の構造、命名規則、品質基準を定義します	P0 - Critical
specs/reference-docs-spec.md	リファレンスドキュメント生成仕様 — 生成された Skills に、適切なフェーズベースのリファレンスドキュメントと使用タイミングのガイダンスが含まれるようにします	P0 - Critical

テンプレートファイル（生成前に読む）

ドキュメント	目的
templates/skill-md.md	SKILL.md エントリーファイルのテンプレート
templates/sequential-phase.md	シーケンシャルフェーズのテンプレート
templates/autonomous-orchestrator.md	自律型オーケストレーターのテンプレート
templates/autonomous-action.md	自律型アクションのテンプレート
templates/code-analysis-action.md	コード分析アクションのテンプレート
templates/llm-action.md	LLM アクションのテンプレート
templates/script-template.md	統一スクリプトテンプレート（Bash + Python）

仕様書（必要に応じて読む）

ドキュメント	目的
specs/execution-modes.md	実行モード仕様
specs/skill-requirements.md	スキル要件仕様
specs/cli-integration.md	CLI 統合仕様
specs/scripting-integration.md	スクリプト統合仕様

フェーズ実行ガイド（実行中に参照）

ドキュメント	目的
phases/01-requirements-discovery.md	スキル要件の収集
phases/02-structure-generation.md	ディレクトリ構造の生成
phases/03-phase-generation.md	フェーズファイルの生成
phases/04-specs-templates.md	仕様とテンプレートの生成
phases/05-validation.md	検証とドキュメント作成

---

実行フロー

Input Parsing:
   └─ Convert user request to structured format (skill-name/purpose/mode)

Phase 0: Specification Study (MANDATORY - Must complete before proceeding)
   - Read specification documents
   - Load: ../_shared/SKILL-DESIGN-SPEC.md
   - Load: All templates/*.md files
   - Understand: Structure rules, naming conventions, quality standards
   - Output: Internalized requirements (in-memory, no file output)
   - Validation: MUST complete before Phase 1

Phase 1: Requirements Discovery
   - Gather skill requirements via user interaction
   - Tool: AskUserQuestion
   - Collect: Skill name, purpose, execution mode
   - Collect: Phase/Action definition
   - Collect: Tool dependencies, output format
   - Process: Generate configuration object
   - Output: skill-config.json
   - Contains: skill_name, execution_mode, phases/actions, allowed_tools

Phase 2: Structure Generation
   - Create directory structure and entry file
   - Input: skill-config.json (from Phase 1)
   - Tool: Bash
   - Execute: mkdir -p .claude/skills/{skill-name}/{phases,specs,templates,scripts}
   - Tool: Write
   - Generate: SKILL.md (entry point with architecture diagram)
   - Output: Complete directory structure

Phase 3: Phase/Action Generation
   - Decision (execution_mode check):
   - IF execution_mode === "sequential": Generate Sequential Phases
   - Read template: templates/sequential-phase.md
   - Loop: For each phase in config.sequential_config.phases
   - Generate: phases/{phase-id}.md
   - Link: Previous phase output -> Current phase input
   - Write: phases/_orchestrator.md
   - Write: workflow.json
   - Output: phases/01-{name}.md, phases/02-{name}.md, ...

   - ELSE IF execution_mode === "autonomous": Generate Orchestrator + Actions
   - Read template: templates/autonomous-orchestrator.md
   - Write: phases/state-schema.md
   - Write: phases/orchestrator.md
   - Write: specs/action-catalog.md
   - Loop: For each action in config.autonomous_config.actions
   - Read template: templates/autonomous-action.md
   - Generate: phases/actions/{action-id}.md
   - Output: phases/orchestrator.md, phases/actions/*.md

Phase 4: Specs & Templates
   - Generate domain specifications and templates
   - Input: skill-config.json (domain context)
   - Reference: [specs/reference-docs-spec.md](specs/reference-docs-spec.md) for document organization
   - Tool: Write
   - Generate: specs/{domain}-requirements.md
   - Generate: specs/quality-standards.md
   - Generate: templates/agent-base.md (if needed)
   - Output: Domain-specific documentation

Phase 5: Validation & Documentation
   - Verify completeness and generate usage guide
   - Input: All generated files from previous phases
   - Tool: Glob + Read
   - Check: Required files exist and contain proper structure
   - Tool: Write
   - Generate: README.md (usage instructions)
   - Generate: validation-report.json (completeness check)
   - Output: Final documentation

実行プロトコル：

// Phase 0: Read specifications (in-memory)
Read('.claude/skills/_shared/SKILL-DESIGN-SPEC.md');
Read('.claude/skills/skill-generator/templates/*.md'); // All templates

// Phase 1: Gather requirements
const answers = AskUserQuestion({
  questions: [
    { question: "Skill name?", header: "Name", options: [...] },
    { question: "Execution mode?", header: "Mode", options: ["Sequential", "Autonomous"] }
  ]
});

const config = generateConfig(answers);
const workDir = `.workflow/.scratchpad/skill-gen-${timestamp}`;
Write(`${workDir}/skill-config.json`, JSON.stringify(config));

// Phase 2: Create structure
const skillDir = `.claude/skills/${config.skill_name}`;
Bash(`mkdir -p "${skillDir}/phases" "${skillDir}/specs" "${skillDir}/templates"`);
Write(`${skillDir}/SKILL.md`, generateSkillEntry(config));

// Phase 3: Generate phases (mode-dependent)
if (config.execution_mode === 'sequential') {
  Write(`${skillDir}/phases/_orchestrator.md`, generateOrchestrator(config));
  Write(`${skillDir}/workflow.json`, generateWorkflowDef(config));
  config.sequential_config.phases.forEach(phase => {
    Write(`${skillDir}/phases/${phase.id}.md`, generatePhase(phase, config));
  });
} else {
  Write(`${skillDir}/phases/orchestrator.md`, generateAutonomousOrchestrator(config));
  Write(`${skillDir}/phases/state-schema.md`, generateStateSchema(config));
  config.autonomous_config.actions.forEach(action => {
    Write(`${skillDir}/phases/actions/${action.id}.md`, generateAction(action, config));
  });
}

// Phase 4: Generate specs
Write(`${skillDir}/specs/${config.skill_name}-requirements.md`, generateRequirements(config));
Write(`${skillDir}/specs/quality-standards.md`, generateQualityStandards(config));


// Phase 5: Validate & Document
const validation = validateStructure(skillDir);
Write(`${skillDir}/validation-report.json`, JSON.stringify(validation));
Write(`${skillDir}/README.md`, generateReadme(config, validation));

---

フェーズ別のリファレンスドキュメント

重要：このセクションでは、skill-generator が自身のリファレンスドキュメントをどのように整理しているかを示します。生成されるすべての Skill は、このパターンに従ってください。詳細については、specs/reference-docs-spec.md を参照してください。

フェーズ 0：仕様の確認（必須の前提条件）

生成操作を行う前に必ず読む必要がある仕様ドキュメント

ドキュメント	目的	使用するタイミング
../_shared/SKILL-DESIGN-SPEC.md	汎用的な Skill 設計仕様	Skill の構造と命名規則を理解するため - 必須
specs/reference-docs-spec.md	リファレンスドキュメント生成仕様	リファレンスドキュメントがフェーズ別に適切に整理されていることを確認するため - 必須

フェーズ 1：要件の確認

Skill の要件と設定を収集します

ドキュメント	目的	使用するタイミング
phases/01-requirements-discovery.md	フェーズ 1 の実行ガイド	ユーザー要件を収集し、設定を生成する方法を理解するため
specs/skill-requirements.md	Skill 要件仕様	Skill に含めるべき情報を理解するため

フェーズ 2：構造の生成

ディレクトリ構造とエントリーファイルを生成します

ドキュメント	目的	使用するタイミング
phases/02-structure-generation.md	フェーズ 2 の実行ガイド	ディレクトリ構造の生成方法を理解するため
templates/skill-md.md	SKILL.md テンプレート	エントリーファイルの生成方法を学ぶため

フェーズ 3：フェーズ／アクションの生成

実行モードに基づいて、特定のフェーズまたはアクションファイルを生成します

ドキュメント	目的	使用するタイミング
phases/03-phase-generation.md	フェーズ 3 の実行ガイド	Sequential と Autonomous の生成ロジックを理解するため
templates/sequential-phase.md	Sequential フェーズテンプレート	Sequential モード用のフェーズファイルを生成するため
templates/autonomous-orchestrator.md	オーケストレーターテンプレート	Autonomous モード用のオーケストレーターを生成するため
templates/autonomous-action.md	アクションテンプレート	Autonomous モード用のアクションファイルを生成するため

フェーズ 4：仕様とテンプレート

ドメイン固有の仕様とテンプレートを生成します

ドキュメント	目的	使用するタイミング
phases/04-specs-templates.md	フェーズ 4 の実行ガイド	ドメイン固有のドキュメントを生成する方法を理解するため
specs/reference-docs-spec.md	リファレンスドキュメント仕様	重要：仕様を生成する際は、この仕様に従ってください

フェーズ 5：検証とドキュメント作成

結果を検証し、最終ドキュメントを生成します

ドキュメント	目的	使用するタイミング
phases/05-validation.md	フェーズ 5 の実行ガイド	生成された Skill の完全性を検証する方法を理解するため

デバッグとトラブルシューティング

問題が発生したときに参照するドキュメント

問題	解決ドキュメント
生成された Skill にリファレンスドキュメントがない	specs/reference-docs-spec.md - フェーズ別の整理に従っていることを確認してください
リファレンスドキュメントの整理方法が不明確	specs/reference-docs-spec.md - 基本原則のセクション
生成されたドキュメントが品質基準を満たしていない	../_shared/SKILL-DESIGN-SPEC.md

リファレンスと背景

ディープラーニングと設計上の決定に関するドキュメント

ドキュメント	目的	備考
specs/execution-modes.md	実行モードの詳細な仕様	Sequential と Autonomous の比較とユースケース
specs/cli-integration.md	CLI 統合仕様	生成された Skill を CLI と統合する方法
specs/scripting-integration.md	スクリプト統合仕様	Phase でスクリプトを使用する方法
templates/script-template.md	スクリプトテンプレート	Bash と Python を統合したテンプレート

---

出力構造

Sequential モード

.claude/skills/{skill-name}/
├── SKILL.md                        # Entry file
├── phases/
│   ├── _orchestrator.md            # Declarative orchestrator
│   ├── workflow.json               # Workflow definition
│   ├── 01-{step-one}.md           # Phase 1
│   ├── 02-{step-two}.md           # Phase 2
│   └── 03-{step-three}.md         # Phase 3
├── specs/
│   ├── {skill-name}-requirements.md
│   └── quality-standards.md
├── templates/
│   └── agent-base.md
├── scripts/
└── README.md

Autonomous モード

.claude/skills/{skill-name}/
├── SKILL.md                        # Entry file
├── phases/
│   ├── orchestrator.md             # Orchestrator (state-driven)
│   ├── state-schema.md             # State schema definition
│   └── actions/
│       ├── action-init.md
│       ├── action-create.md
│       └── action-list.md
├── specs/
│   ├── {skill-name}-requirements.md
│   ├── action-catalog.md
│   └── quality-standards.md
├── templates/
│   ├── orchestrator-base.md
│   └── action-base.md
├── scripts/
└── README.md

---

Phase 別リファレンスドキュメント

重要：このセクションでは、skill-generator が独自のリファレンスドキュメントをどのように構成しているかを示します。これは、生成されるすべての Skill が踏襲すべきパターンです。詳細は specs/reference-docs-spec.md を参照してください。

Phase 0：仕様の確認（必須の前提条件）

生成操作の前に必ず読む仕様ドキュメント

ドキュメント	目的	使用するタイミング
../_shared/SKILL-DESIGN-SPEC.md	共通の Skill 設計仕様	Skill の構造と命名規則を理解するため — 必須
specs/reference-docs-spec.md	リファレンスドキュメント生成仕様	リファレンスドキュメントが適切に Phase 別に構成されていることを確認するため — 必須

Phase 1：要件の確認

Skill の要件と設定を収集します

ドキュメント	目的	使用するタイミング
phases/01-requirements-discovery.md	Phase 1 の実行ガイド	ユーザー要件を収集し、設定を生成する方法を理解するため
specs/skill-requirements.md	Skill 要件仕様	Skill に含める情報を理解するため

Phase 2：構造の生成

ディレクトリ構造とエントリーファイルを生成します

ドキュメント	目的	使用するタイミング
phases/02-structure-generation.md	Phase 2 の実行ガイド	ディレクトリ構造の生成方法を理解するため
templates/skill-md.md	SKILL.md テンプレート	エントリーファイルの生成方法を確認するため

Phase 3：Phase／Action の生成

実行モードに応じて、特定の Phase または Action のファイルを生成します

ドキュメント	目的	使用するタイミング
phases/03-phase-generation.md	Phase 3 の実行ガイド	Sequential と Autonomous の生成ロジックを理解するため
templates/sequential-phase.md	Sequential Phase テンプレート	Sequential モード用の Phase ファイルを生成するため
templates/autonomous-orchestrator.md	オーケストレーターテンプレート	Autonomous モード用のオーケストレーターを生成するため
templates/autonomous-action.md	Action テンプレート	Autonomous モード用の Action ファイルを生成するため

Phase 4：仕様とテンプレート

ドメイン固有の仕様とテンプレートを生成します

ドキュメント	目的	使用するタイミング
phases/04-specs-templates.md	Phase 4 の実行ガイド	ドメイン固有のドキュメントを生成する方法を理解するため
specs/reference-docs-spec.md	リファレンスドキュメント仕様	重要：仕様を生成する際はこの仕様に従ってください

フェーズ 5：検証とドキュメント作成

結果を検証し、最終ドキュメントを作成します

ドキュメント	目的	使用するタイミング
phases/05-validation.md	フェーズ 5 の実行ガイド	生成された Skill の完全性を検証する方法を理解する

デバッグとトラブルシューティング

問題が発生した際に参照するドキュメント

問題	解決方法のドキュメント
生成された Skill にリファレンスドキュメントがない	specs/reference-docs-spec.md - フェーズベースの構成に従っているか確認します
リファレンスドキュメントの構成が不明瞭	specs/reference-docs-spec.md - コア原則のセクション
生成されたドキュメントが品質基準を満たしていない	../_shared/SKILL-DESIGN-SPEC.md

リファレンスと背景情報

詳しい学習や設計上の判断のためのドキュメント

ドキュメント	目的	備考
specs/execution-modes.md	実行モードの詳細な仕様	順次実行と自律実行の比較およびユースケース
specs/cli-integration.md	CLI 統合の仕様	生成された Skill を CLI と統合する方法
specs/scripting-integration.md	スクリプト統合の仕様	フェーズでスクリプトを使用する方法
templates/script-template.md	スクリプトテンプレート	Bash と Python を統一したテンプレート