convention-skill-generator

# Convention Skill Generator

## 概要

このSkillは、ユーザーが提供する規約・ガイドライン情報を基に、Convention Skillのマークダウンファイル（SKILL.md）を生成する。ユーザーとの対話を通じて必要な情報を収集し、適切なテンプレートを選択して、標準化されたコンベンションスキルのドキュメントを作成する。

## 責任範囲

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

- 既存スキルの確認と重複チェック
- ユーザーとの対話による規約・ガイドライン情報の収集
- 規約のカテゴリ分類と整理
- 良い例/悪い例の作成支援
- テンプレート（simple版/full版）の選択
- SKILL.mdファイルの生成
- プラグインアーキテクチャ規約の遵守確認
- markdownlint検証の実施
- ユーザーフィードバックの収集と反映

## ワークフロー

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

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

**実施内容:**

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

**確認対象:**

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

**質問例:**

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

- [既存スキル名]: [既存スキルの説明]

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

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

```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. 良い例/悪い例を記述する（full版の場合）
7. チェックリストを作成する

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

```markdown
---
name: スキル名（ケバブケース、例: coding-conventions）
description: スキルの簡潔な説明（1行、50文字以内）
---
```

**概要の記述:**

- スキルの目的を明確に記述する
- 定義する規約・ガイドラインの範囲を説明する
- 簡潔に1〜2段落で記述する

**責任範囲の定義:**

- 箇条書きで3〜5項目を記述する
- 「〜の定義」「〜のガイドライン」「〜のルール」のような表現を使用する
- スキルがカバーする範囲を明確にする

**カテゴリ別の規約記述:**

各カテゴリに以下を含める:

- カテゴリ名（例: 命名規則、コードレイアウト）
- カテゴリの説明（1〜2行）