目的
ユーザーの曖昧な要求から、実用的で再利用可能なSkillを設計・生成する。 「こんなことができるSkillが欲しい」を、高品質なSKILL.mdに変換する。
トリガー語
- 「Skillを作って」
- 「新しいSkillを作成」
- 「〇〇ができるSkillが欲しい」
- 「Skills Creator」
入力で最初に聞くこと
| # | 質問 | 目的 | |---|------|------| | 1 | 何を実現したいですか? | ゴール・課題を把握 | | 2 | 誰が使いますか? | トーン・専門度を調整 | | 3 | どんな成果物が欲しい? | 出力形式を決定 |
任意: 参考資料、品質基準、利用頻度
手順(4フェーズ)
Phase 1: 要件分析
- ゴールを「〇〇が△△できるようになる」形式で明確化
- スコープ定義(やること / やらないこと)
- カテゴリ判定
| カテゴリ | 判定基準 |
|----------|----------|
| business/ | ビジネス文書・経営判断 |
| pm/ | プロジェクト管理・リスク |
| engineering/ | 開発・実装・技術設計 |
| meta/ | Skill生成・自動化基盤 |
Phase 2: 設計
- 入力設計: 必須3〜5項目 → 入力設計ガイド
- 手順設計: 3〜7ステップ → 手順設計ガイド
- 成果物設計: 主成果物 + 副成果物 → 成果物設計ガイド
- 検証設計: 完了条件3〜5項目 → 検証設計ガイド
Phase 3: 生成
- SKILL.mdテンプレートに従って生成
- トリガー語を3〜5個設計 → トリガー語ガイド
- ディレクトリ作成:
.agent/skills/<category>/<skill-name>/
Phase 4: 統合
- registry.md更新
- 関連Skill/Workflowとの連携確認
- 動作確認
SKILL.mdテンプレート
---
name: <skill-name>
description: <1行説明>
---
## 目的
<2-3文で目的を説明>
## トリガー語
- 「<トリガー1>」
- 「<トリガー2>」
## 入力で最初に聞くこと
1. <質問1>(<なぜ必要か>)
2. <質問2>(<なぜ必要か>)
## 手順
### Step 1: <ステップ名>
- <アクション>
## 成果物
| 成果物 | 内容 |
|--------|------|
| <成果物1> | <説明> |
## 検証(完了条件)
- [ ] <条件1>
## 参照
- Workflow: <関連Workflow>
品質基準
必須(全て満たすこと)
- [ ] 各ステップが具体的で実行可能
- [ ] SKILL.mdだけで実行できる
- [ ] 完了条件が客観的に判定可能
- [ ] 500行以下である
禁止事項
- ❌ 曖昧な指示(「適宜」の多用)
- ❌ 検証不能な完了条件
- ❌ 深いネスト参照(2階層以上)
→ 詳細は REFERENCE.md#8-品質チェックリスト
成果物
| 成果物 | 必須 | 内容 | |--------|:----:|------| | SKILL.md | ◯ | Skill定義(500行以下) | | REFERENCE.md | △ | 詳細説明(100行超の場合) | | registry.md更新 | ◯ | 対応表・一覧への追記 |
検証(完了条件)
- [ ] SKILL.mdが保存されている
- [ ] SKILL.mdが500行以下
- [ ] トリガー語が3つ以上
- [ ] 手順が3〜7ステップ
- [ ] registry.mdに登録済み
困ったときは
→ PATTERNS.md - よくあるパターンと対処法
参照ドキュメント
| ドキュメント | 内容 | いつ読むか | |--------------|------|-----------| | REFERENCE.md | 設計原則・ベストプラクティス | 詳細設計時 | | PATTERNS.md | よくあるパターン集 | 困ったとき | | registry.md | 既存Skills一覧 | 重複確認時 |