スキルアーキテクチャと設計計画
プロセス
ステップ1：ドメイン発見
ユーザーに以下の質問をします（コンテキストに応じて調整）：
- このスキルのドメインは何ですか？（例：SEO、広告、DevOps、データ分析）
- 上位2～3のユースケースは何ですか？ ユーザーが達成できるべきことは？
- ユーザーが言うであろうトリガーフレーズは？ 自然言語トリガーを5～10個挙げてください。
- 外部ツールは必要ですか？ MCPサーバー、API、CLIツール？
- ターゲットユーザーは誰ですか？ 開発者、マーケター、アナリスト、一般ユーザー？
ステップ2：ユースケースの分解
各ユースケースについて、以下を定義します：
ユースケース：[名前]
トリガー：ユーザーが「[フレーズ]」と言ったとき
手順：
1. [最初のアクション]
2. [判断ポイントまたは検証]
3. [次のアクション]
結果：[成功した状態]
必要なツール：[組み込み、MCP、スクリプト]
ステップ3：複雑性ティア評価
回答に基づいて評価します：
| シグナル | ティア1 | ティア2 | ティア3 | ティア4 |
|---|---|---|---|---|
| ユースケース数 | 1～2 | 2～3 | 4～8 | 8以上 |
| スクリプトが必要？ | いいえ | はい | 場合により | はい |
| サブスキルが必要？ | いいえ | いいえ | はい | はい |
| 並列実行？ | いいえ | いいえ | いいえ | はい |
| 参照ドキュメント？ | いいえ | 場合により | はい | はい |
| 業界テンプレート？ | いいえ | いいえ | 場合により | はい |
判定マトリックス：
- 単一ワークフロー、スクリプトなし → ティア1（最小）
- 決定論的な検証が必要 → ティア2（ワークフロー）
- 複数の異なるワークフロー → ティア3（マルチスキル）
- 並列委任が必要な複雑ドメイン → ティア4（エコシステム）
ステップ4：アーキテクチャ設計
ティアに基づいてアーキテクチャを生成します：
ティア1の出力：
skill-name/
SKILL.md
ティア2の出力：
skill-name/
SKILL.md
scripts/
validate.py
process.py
references/
domain-knowledge.md
ティア3の出力：
skill-name/ # メインオーケストレータ
SKILL.md
references/
shared-reference.md
skills/
skill-name-sub1/
SKILL.md
skill-name-sub2/
SKILL.md
ティア4の出力：
skill-name/ # メインオーケストレータ
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：サブスキルの分解（ティア3～4のみ）
各サブスキルについて以下を定義します：
- 名前：
{親}-{機能}（ケバブケース） - 責任：単一で明確な目的
- 入力：オーケストレータから何が必要か
- 出力：何を返すか
- 相互参照：必要な他のサブスキルや参照ファイル
- 自己完結性：独立して実行できるか、オーケストレーションが必要か
ステップ6：ルーティングテーブル
コマンドルーティングを設計します：
| コマンド | ルーティング先 | 目的 |
|---------|---------------|------|
| /skill-name | メインSKILL.md | 対話モード |
| /skill-name sub1 | skills/skill-name-sub1/ | サブワークフロー1 |
| /skill-name sub2 | skills/skill-name-sub2/ | サブワークフロー2 |
ステップ7：参照ファイル計画
参照ファイルに抽出すべき知識を特定します：
- ドメイン固有のルールとしきい値
- 業界テンプレート
- APIドキュメント
- 品質ゲートと検証基準
経験則：情報が50行を超え、特定のサブワークフローにのみ必要な場合は、references/に抽出します。
ステップ8：計画ドキュメントの生成
構造化された計画ドキュメントを作成します：
# スキル計画：[名前]
## 概要
- ドメイン：[ドメイン]
- ティア：[1～4]
- サブスキル数：[数]
- スクリプト数：[数]
## ユースケース
[ステップ2からのリスト]
## アーキテクチャ
[ステップ4の図]
## サブスキル
[ステップ5の詳細]
## ルーティング
[ステップ6のテーブル]
## 参照ファイル
[ステップ7のリスト]
## 次のステップ
`/skill-forge build [名前]` を実行してスキルをスキャフォールドします。
例
例：DevOpsスキルの計画
ユーザー：「DockerコンテナとKubernetesデプロイメントを管理するスキルを作成したい」
発見結果：
- 6つのユースケース（コンテナ管理、K8sデプロイ、監視、ログ、スケーリング、トラブルシューティング）
- kubectlやdockerコマンド用のスクリプトが必要
- 複数の異なるワークフロー
- 監視とトラブルシューティングの相互参照あり
評価：ティア3（マルチスキルオーケストレータ）
アーキテクチャ：
devops/ # メインオーケストレータ
SKILL.md
scripts/
health_check.py # クラスタヘルスチェック
log_parser.py # ログ解析
references/
k8s-patterns.md # デプロイメントパターン
docker-best-practices.md
skills/
devops-docker/SKILL.md # コンテナ管理
devops-k8s/SKILL.md # Kubernetesデプロイメント
devops-monitor/SKILL.md # 監視とアラート
devops-logs/SKILL.md # ログ解析
devops-scale/SKILL.md # スケーリング戦略
devops-fix/SKILL.md # トラブルシューティング