majiayu000 目的
ユーザーの曖昧な要求から、実用的で再利用可能な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一覧 | 重複確認時 |