agent-generator

# Agent Generator

## 概要

このSkillは、ユーザーが提供する責任範囲や対象フェーズの情報を基に、Agentのマークダウンファイルを生成する。ユーザーとの対話を通じて必要な情報を収集し、標準化されたエージェントのドキュメントを作成する。

## 責任範囲

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

- 既存エージェントの確認と重複チェック
- ユーザーとの対話による責任範囲情報の収集
- 対象フェーズや役割の明確化
- エージェントファイルの生成
- プラグインアーキテクチャ規約の遵守確認
- markdownlint検証の実施
- ユーザーフィードバックの収集と反映

## ワークフロー

### フェーズ1: 既存エージェント確認

エージェント生成前に、既存のエージェントを確認し、重複を避ける。

**実施内容:**

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

**確認対象:**

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

**質問例:**

```markdown
【既存エージェント確認】
プラグインディレクトリ内の既存エージェントを確認しました。
以下のエージェントと責任範囲が重複する可能性があります：

- [既存エージェント名]: [既存エージェントの説明]

作成予定のエージェントから、これらの重複内容を除外してよろしいですか？
```

**既存エージェントで代用可能な場合:**

```markdown
【確認】
作成予定のエージェントと同じ責任範囲のエージェントが既に存在します：
- [既存エージェント名]: [既存エージェントの説明]

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

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

ユーザーとの対話を通じて、エージェントに必要な情報を収集する。

**実施内容:**

1. エージェントの目的と役割を確認する
2. 責任範囲内の項目を把握する
3. 責任範囲外の項目を把握する
4. 対象フェーズや役割を明確にする
5. 注意事項として記述すべき内容を確認する
6. 使用可能なツール（tools）を確認する
7. 表示色（color）の希望を確認する
8. ユーザーとの対話時は、明確なタイトル付き質問、複数選択肢の提示、推奨オプションの明示を行う

**質問例:**

```markdown
【責任範囲の確認】
このエージェントが担当する責任範囲を確認します。以下のどの範囲ですか？

1. 特定フェーズ全体（要件定義、設計、実装など）【推奨】
2. 特定領域全体（セキュリティ、パフォーマンス、品質管理など）
3. 複数フェーズにまたがる横断的な役割
```

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

収集した情報を基に、エージェントファイルのコンテンツを生成する。

**実施内容:**

1. フロントマター（name, description, tools, model, color）を作成する
2. 役割セクションを記述する
3. 責任範囲を定義する（責任範囲内と責任範囲外に分けて記述）
4. 注意事項を記述する

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

```markdown
---
name: エージェント名（ケバブケース、例: requirements-agent）
description: エージェントの簡潔な説明（1行、50文字以内）
tools: 使用可能な外部ツール（例: "*", "Read", "Write", "Bash"など）
model: inherit（通常はinherit、特定のモデルを指定する場合のみ変更）
color: 表示色（例: blue, green, redなど）
---
```

**役割の記述:**

- エージェントの目的と役割を明確に記述する
- 担当する責任範囲の概要を説明する
- 簡潔に1〜2段落で記述する

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

責任範囲は「責任範囲内」と「責任範囲外」の2つのサブセクションに分けて記述する。

**責任範囲内:**

- 太字の見出しと説明を組み合わせた形式で記述する
- 「**[項目名]:** [説明]」の形式を使