スキルデザイナー は何をしますか？
概要
構造化されたスキルアイデア仕様から、包括的なClaude CLIプロンプトを生成します。このプロンプトは、リポジトリの規則（YAMLフロントマター付きSKILL.md、リファレンス文書、ヘルパースクリプト、テストテンプレート）に従った完全なスキルディレクトリをClaudeに作成するよう指示します。
使用するタイミング
- スキル自動生成パイプラインがバックログからアイデアを選択し、
claude -p用のデザインプロンプトが必要なとき - 開発者がJSONアイデア仕様から新しいスキルをブートストラップしたいとき
- 生成されたスキルの品質レビューにスコアリングルーブリックの認識が必要なとき
前提条件
- Python 3.9+
- 外部APIキーは不要
- リファレンスファイルが
references/以下に存在すること
ワークフロー
ステップ1: アイデア仕様の準備
以下の内容を含むJSONファイル（--idea-json）を受け付けます：
title: 人間が読めるアイデア名description: スキルの説明category: スキルカテゴリ（例：trading-analysis, developer-tooling）
ディレクトリ名およびYAMLフロントマターのname:フィールドとして使用される正規化されたスキル名（--skill-name）を受け付けます。
ステップ2: デザインプロンプトの構築
プロンプトビルダーを実行します：
python3 skills/skill-designer/scripts/build_design_prompt.py \
--idea-json /tmp/idea.json \
--skill-name "my-new-skill" \
--project-root .
スクリプトは以下の処理を行います：
- アイデアJSONを読み込む
- 3つのリファレンスファイル（構造ガイド、品質チェックリスト、テンプレート）をすべて読み込む
- 既存スキル（最大20個）をリストアップして重複を防止する
- 完全なプロンプトを標準出力に出力する
ステップ3: Claude CLIにプロンプトを渡す
呼び出し元のパイプラインがプロンプトをclaude -pにパイプします：
python3 skills/skill-designer/scripts/build_design_prompt.py \
--idea-json /tmp/idea.json \
--skill-name "my-new-skill" \
--project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep
ステップ4: 出力の検証
Claudeがスキルを作成した後、以下を確認します：
skills/<skill-name>/SKILL.mdが存在し、正しいフロントマターを持つこと- ディレクトリ構造が規則に従っていること
- dual-axis-skill-reviewerによるスコアがしきい値を超えていること
出力形式
スクリプトはプレーンテキストのプロンプトを標準出力に出力します。成功時は終了コード0、必要なリファレンスファイルが見つからない場合は1を返します。
リソース
references/skill-structure-guide.md-- ディレクトリ構造、SKILL.mdの形式、命名規則references/quality-checklist.md-- デュアルアクシスレビューア用の5カテゴリチェックリスト（100点満点）references/skill-template.md-- YAMLフロントマターと標準セクションを含むSKILL.mdテンプレートscripts/build_design_prompt.py-- プロンプトビルダースクリプト（CLIインターフェース）