skill-designer

スキル設計者

概要

構造化されたスキルのアイデア仕様から、包括的な 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 .

スクリプトは次の処理を行います。

1. アイデア JSON を読み込みます
2. 3 つすべての参考ファイル（構造ガイド、品質チェックリスト、テンプレート）を読み込みます
3. 重複を防ぐため、既存のスキルを最大 20 件一覧表示します
4. 完全なプロンプトを標準出力に出力します

ステップ 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 -- dual-axis reviewer の 5 カテゴリーのチェックリスト（100 点）
• references/skill-template.md -- YAML フロントマターと標準セクションを含む SKILL.md テンプレート
• scripts/build_design_prompt.py -- プロンプトビルダースクリプト（CLI インターフェース）