workflow-skill-generator

# Workflow Skill Generator

## 概要

このSkillは、ユーザーが提供する作業フローや業務プロセスの情報を基に、Workflow Skillのマークダウンファイル（SKILL.md）を生成する。ユーザーとの対話を通じて必要な情報を収集し、適切なテンプレートを選択して、標準化されたワークフロースキルのドキュメントを作成する。

## 責任範囲

このSkillは以下の範囲をカバーする:

- 既存スキルの確認と重複チェック
- ユーザーとの対話による作業フロー情報の収集
- ワークフローのフェーズ分解と整理
- 入力・出力・実施内容の明確化
- テンプレート（simple版/full版）の選択
- SKILL.mdファイルの生成
- テンプレートファイルの生成（ドキュメント生成を含む場合、skills/[スキル名]/templates/配下）
- プラグインアーキテクチャ規約の遵守確認
- markdownlint検証の実施
- ユーザーフィードバックの収集と反映

## ワークフロー

### フェーズ1: 既存スキル確認

スキル生成前に、既存のスキルを確認し、重複を避ける。

**実施内容:**

1. プラグインディレクトリ内の既存スキルを確認する
2. 作成予定のスキルと同じ目的のスキルが存在しないか確認する
3. 作成予定のスキル内容と重複する記述が他のスキルに含まれていないか確認する
4. 既存スキルで代用できる場合はユーザーに提案する
5. 重複が避けられない場合は、どの内容を削除すべきかユーザーと確認する

**確認対象:**

- プラグインディレクトリ内のskillsディレクトリ内のドキュメント

**質問例:**

```markdown
【既存スキル確認】
プラグインディレクトリ内の既存スキルを確認しました。
以下のスキルと内容が重複する可能性があります：

- interaction-guidelines: ユーザーとの対話パターン、質問技法
- documentation-standards: Markdown記述ルール、markdownlint検証

作成予定のスキルから、これらの重複内容を除外してよろしいですか？
```

**既存スキルで代用可能な場合:**

```markdown
【確認】
作成予定のスキルと同じ目的のスキルが既に存在します：
- [既存スキル名]: [既存スキルの説明]

既存スキルで十分な場合は、新規作成は不要です。
それでも新規作成が必要ですか？必要な場合は、既存スキルとの違いを教えてください。
```

### フェーズ2: 情報収集

ユーザーとの対話を通じて、ワークフロースキルに必要な情報を収集する。

**実施内容:**

1. スキルの目的と対象作業を確認する
2. 作業フローの全体像を把握する
3. フェーズ分解の可能性を検討する
4. 入力データと出力データを特定する
5. 前提条件や制約事項を確認する
6. ユーザーとの対話時は、明確なタイトル付き質問、複数選択肢の提示、推奨オプションの明示を行う

### フェーズ3: テンプレート選択

収集した情報を基に、適切なテンプレート（simple版/full版）を選択する。

**実施内容:**

1. スキルの複雑度を評価する
2. テンプレートの選択肢（simple版/full版）を提示する
3. 推奨テンプレートを明示してユーザーに確認する

**テンプレート選択基準:**

- simple版: フェーズが2〜3個程度のシンプルな作業
- full版: フェーズが4個以上の複雑な作業、良い例/悪い例が必要

### フェーズ4: コンテンツ生成

選択したテンプレートを基に、SKILL.mdファイルのコンテンツを生成する。

**実施内容:**

1. フロントマター（name, description）を作成する
2. 概要セクションを記述する
3. 責任範囲を定義する
4. 前提条件を記述する（該当する場合）
5. 基本方針を記述する（該当する場合）
6. ワークフローをフェーズごとに記述する
7. アウトプット定義を記述する
8. チェックリストを作成する
9. エラー処理・ベストプラクティスを記述する（full版の場合）
10. ドキュメント生成を含む場合、テンプレートファイルを生成し、skills/[スキル名]/templates/配下に配置する

**フロントマターの作成:**

```markdown
---
name: スキル名（ケバブケース、例: database-schema-designer）
description: スキルの簡潔な説明（1行