skill-forge-plan

スキルのアーキテクチャと設計計画

プロセス

ステップ 1：ドメインの把握

ユーザーに次の質問をします（状況に応じて調整してください）。

1. このスキルの対象ドメインは何ですか？（例：SEO、広告、DevOps、データ分析）
2. 主なユースケースを 2～3 個挙げてください。 ユーザーは何を達成できるようになるべきですか？
3. ユーザーはどのようなトリガーフレーズを使いますか？ 自然言語のトリガーを 5～10 個挙げてください。
4. 外部ツールが必要ですか？ MCP サーバー、API、CLI ツールなど。
5. 対象ユーザーは誰ですか？ 開発者、マーケター、アナリスト、一般ユーザーなど。

ステップ 2：ユースケースの分解

各ユースケースについて、次を定義します。

Use Case: [Name]
Trigger: User says "[phrases]"
Steps:
1. [First action]
2. [Decision point or validation]
3. [Next action]
Result: [What success looks like]
Tools Needed: [built-in, MCP, scripts]

ステップ 3：複雑さの段階評価

回答に基づいて評価します。

指標	Tier 1	Tier 2	Tier 3	Tier 4
ユースケース	1～2	2～3	4～8	8+
スクリプトが必要か？	いいえ	はい	場合による	はい
サブスキルが必要か？	いいえ	いいえ	はい	はい
並列実行が必要か？	いいえ	いいえ	いいえ	はい
リファレンスドキュメントが必要か？	いいえ	場合による	はい	はい
業界テンプレートが必要か？	いいえ	いいえ	場合による	はい

判断マトリクス：

• 単一のワークフローで、スクリプトが不要 -> Tier 1（最小構成）
• 決定論的な検証が必要 -> Tier 2（ワークフロー）
• 複数の異なるワークフローがある -> Tier 3（マルチスキル）
• 並列委任が必要な複雑なドメイン -> Tier 4（エコシステム）

ステップ 4：アーキテクチャの設計

段階に基づいて、アーキテクチャを生成します。

Tier 1 の出力：

skill-name/
  SKILL.md

Tier 2 の出力：

skill-name/
  SKILL.md
  scripts/
    validate.py
    process.py
  references/
    domain-knowledge.md

Tier 3 の出力：

skill-name/              # Main orchestrator
  SKILL.md
  references/
    shared-reference.md
skills/
  skill-name-sub1/
    SKILL.md
  skill-name-sub2/
    SKILL.md

Tier 4 の出力：

skill-name/              # Main orchestrator
  SKILL.md
  references/
    ref1.md
    ref2.md
  scripts/
    script1.py
    script2.py
  assets/
    template1.md
    template2.md
skills/
  skill-name-sub1/
    SKILL.md
  skill-name-sub2/
    SKILL.md
  ...
agents/
  skill-name-role1.md
  skill-name-role2.md

ステップ 5：サブスキルの分解（Tier 3～4 のみ）

各サブスキルについて、次を定義します。

• 名前：{parent}-{function}（ケバブケース）
• 責務：明確で単一の目的
• 入力：オーケストレーターから必要とするもの
• 出力：返す内容
• 相互参照：必要となる他のサブスキルやリファレンス
• 自己完結型か？：独立して実行できるか、オーケストレーションが必要か

ステップ 6：ルーティングテーブル

コマンドのルーティングを設計します。

| Command | Routes to | Purpose |
|---------|-----------|---------|
| /skill-name | main SKILL.md | Interactive mode |
| /skill-name sub1 | skills/skill-name-sub1/ | Sub-workflow 1 |
| /skill-name sub2 | skills/skill-name-sub2/ | Sub-workflow 2 |

ステップ 7：リファレンスファイルの計画

リファレンスファイルに抽出すべき知識を特定します。

• ドメイン固有のルールとしきい値
• 業界テンプレート
• API ドキュメント
• 品質ゲートと検証基準

目安：情報が 50 行を超え、特定のサブワークフローでのみ必要な場合は、 references/ に抽出します。

ステップ 8：計画ドキュメントの生成

構造化された計画ドキュメントを作成します。

# Skill Plan: [name]

## Overview
- Domain: [domain]
- Tier: [1-4]
- Sub-skills: [count]
- Scripts: [count]

## Use Cases
[list from Step 2]

## Architecture
[diagram from Step 4]

## Sub-Skills
[details from Step 5]

## Routing
[table from Step 6]

## Reference Files
[list from Step 7]

## Next Steps
Run `/skill-forge build [name]` to scaffold the skill.

例

例：DevOps スキルの計画

ユーザー：「Docker コンテナと Kubernetes のデプロイを管理するスキルを作りたいです」

把握した内容：

• 6 つのユースケース（コンテナ管理、K8s デプロイ、モニタリング、ログ、スケーリング、トラブルシューティング）
• kubectl と docker のコマンドを実行するスクリプトが必要
• 複数の異なるワークフローがある
• モニタリングとトラブルシューティングの間に相互参照がある

評価：Tier 3（マルチスキルオーケストレーター）

アーキテクチャ：

devops/                     # Main orchestrator
  SKILL.md
  scripts/
    health_check.py         # Cluster health check
    log_parser.py           # Log analysis
  references/
    k8s-patterns.md         # Deployment patterns
    docker-best-practices.md
skills/
  devops-docker/SKILL.md  # Container management
  devops-k8s/SKILL.md     # Kubernetes deployments
  devops-monitor/SKILL.md # Monitoring and alerts
  devops-logs/SKILL.md    # Log analysis
  devops-scale/SKILL.md   # Scaling strategies
  devops-fix/SKILL.md     # Troubleshooting