411 lines
14 KiB
Markdown
411 lines
14 KiB
Markdown
---
|
||
name: domain-analyzer
|
||
description: ユーザーの業務領域や目的を分析し、必要な機能を抽出する。プラグイン企画時、業務分析時、機能要件定義時、またはユーザーが業務領域分析、ドメイン分析、機能抽出、プラグイン設計に言及した際に使用する。
|
||
---
|
||
|
||
# Domain Analyzer
|
||
|
||
## 概要
|
||
|
||
このSkillは、ユーザーが提供する業務領域や目的の情報を基に、プラグイン化に必要な機能を分析・抽出する。ユーザーとの対話を通じて業務の本質を理解し、自動化すべき作業や必要なプラグイン要素を特定する。
|
||
|
||
## 責任範囲
|
||
|
||
このSkillは以下の範囲をカバーする:
|
||
|
||
- ユーザーの業務領域や目的の理解
|
||
- 業務の特徴・制約・前提条件の把握
|
||
- 自動化可能な機能の抽出
|
||
- 機能のカテゴリ分類と優先順位付け
|
||
- 推奨エージェント・スキル・コマンドの提案
|
||
- 業務領域分析レポートの作成
|
||
|
||
## ワークフロー
|
||
|
||
### フェーズ1: 情報収集
|
||
|
||
ユーザーとの対話を通じて、業務領域や目的に関する基本情報を収集する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 業務領域の概要を確認する
|
||
2. プラグイン化の目的を明確にする
|
||
3. 対象ユーザー（利用者）を特定する
|
||
4. 現在の課題や問題点を把握する
|
||
5. 期待される効果や成果を確認する
|
||
|
||
**質問例:**
|
||
|
||
```markdown
|
||
【業務領域の確認】
|
||
プラグイン化したい業務領域を教えてください。以下のどれに近いですか？
|
||
|
||
1. 開発プロセス（要件定義、設計、実装、テストなど）
|
||
2. ドキュメント作成（技術文書、仕様書、マニュアルなど）
|
||
3. データ処理（分析、変換、集計など）
|
||
4. その他（具体的に教えてください）
|
||
```
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
業務領域: データベース設計
|
||
目的: データベーススキーマ設計を効率化し、設計品質を向上させる
|
||
対象ユーザー: バックエンド開発者、データベースエンジニア
|
||
課題: 手作業でのER図作成に時間がかかり、正規化の検証が不十分
|
||
期待効果: 設計時間を50%削減し、正規化ルール違反をゼロにする
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
業務領域: いろいろなこと
|
||
目的: 便利にしたい
|
||
対象ユーザー: みんな
|
||
課題: よくわからない
|
||
期待効果: 良くなる
|
||
```
|
||
|
||
### フェーズ2: 領域分析
|
||
|
||
収集した情報を基に、業務領域の特徴や制約を分析する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 業務の特徴を整理する
|
||
2. 技術的制約を特定する
|
||
3. ビジネス的制約を特定する
|
||
4. 前提条件や依存関係を把握する
|
||
5. 既存ツールやプロセスとの関係を確認する
|
||
|
||
**分析観点:**
|
||
|
||
- 業務の複雑度（シンプル/標準/複雑）
|
||
- 自動化の難易度（容易/中程度/困難）
|
||
- 必要な専門知識のレベル（基本/中級/上級）
|
||
- 対象範囲の広さ（狭い/中程度/広い）
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
【分析結果】
|
||
業務の特徴:
|
||
- データベース設計は段階的なプロセス（概念設計 → 論理設計 → 物理設計）
|
||
- 正規化ルールや命名規則など、明確な規約が存在する
|
||
- ER図やテーブル定義書など、複数の成果物が必要
|
||
|
||
技術的制約:
|
||
- データベース製品（MySQL, PostgreSQL, SQL Serverなど）により構文が異なる
|
||
- 既存データベースとの互換性を考慮する必要がある
|
||
|
||
ビジネス的制約:
|
||
- 設計変更のコストが高いため、初期段階での品質確保が重要
|
||
- チーム内での設計レビューが必須
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
【分析結果】
|
||
業務の特徴: 複雑
|
||
制約: いろいろある
|
||
```
|
||
|
||
### フェーズ3: 機能抽出
|
||
|
||
業務領域から、プラグインとして実装すべき機能を抽出する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 業務の各ステップを分解する
|
||
2. 自動化可能な作業を特定する
|
||
3. 手作業が必要な部分を明確にする
|
||
4. 各機能の入力と出力を定義する
|
||
5. 機能間の依存関係を整理する
|
||
|
||
**抽出基準:**
|
||
|
||
- 繰り返し実施される作業
|
||
- 明確なルールやパターンがある作業
|
||
- 検証や品質チェックが必要な作業
|
||
- ドキュメント生成が必要な作業
|
||
- テンプレートファイルを使用する作業（ドキュメント生成、フォーム入力、定型文作成など）
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
【抽出された機能】
|
||
|
||
1. エンティティ定義の収集
|
||
- 入力: ユーザーからの要求、既存システムの情報
|
||
- 処理: エンティティの特定、属性の定義、関連の整理
|
||
- 出力: エンティティ一覧、属性リスト
|
||
|
||
2. 正規化の実施
|
||
- 入力: エンティティ定義
|
||
- 処理: 第1正規形〜第3正規形への変換、正規化ルール検証
|
||
- 出力: 正規化されたテーブル定義
|
||
|
||
3. ER図の生成
|
||
- 入力: 正規化されたテーブル定義
|
||
- 処理: ER図の自動生成、レイアウト最適化
|
||
- 出力: ER図（Mermaid形式）
|
||
|
||
4. テーブル定義書の作成
|
||
- 入力: テーブル定義、制約情報
|
||
- 処理: 定義書フォーマットへの変換
|
||
- 出力: テーブル定義書（Markdown形式）
|
||
- テンプレート: table-definition-template.md（テーブル名、カラム定義、インデックス、制約の記述フォーマット）
|
||
|
||
5. DDLスクリプトの生成
|
||
- 入力: テーブル定義、対象データベース製品
|
||
- 処理: データベース製品別のDDL生成
|
||
- 出力: CREATE TABLE文、制約定義
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
【抽出された機能】
|
||
|
||
1. データベースを作る
|
||
2. 便利にする
|
||
3. 良くする
|
||
```
|
||
|
||
### フェーズ4: 要素分類
|
||
|
||
抽出した機能を、エージェント・スキル・コマンドに分類する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 責任範囲の広い機能をエージェント候補として分類する
|
||
2. 具体的な作業手順をスキル候補として分類する
|
||
3. エージェントとスキルの組み合わせをコマンド候補として分類する
|
||
4. 規約やガイドラインをコンベンションスキル候補として分類する
|
||
5. 必要なテンプレートファイルと対応するスキルの関係を特定する
|
||
6. 要素間の依存関係を整理する
|
||
|
||
**分類基準:**
|
||
|
||
- **エージェント**: 特定フェーズや領域全体に対する責任を持つ
|
||
- **スキル（ワークフロー）**: 具体的な作業手順を定義する
|
||
- **スキル（コンベンション）**: 規約やガイドラインを定義する
|
||
- **コマンド**: エージェントとスキルを組み合わせて実行可能にする
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
【分類結果】
|
||
|
||
エージェント候補:
|
||
- database-design-agent: データベース設計全体に対する責任を持つ
|
||
|
||
ワークフロースキル候補:
|
||
- entity-definition-collector: エンティティ定義を収集する
|
||
- normalization-processor: 正規化を実施する
|
||
- er-diagram-generator: ER図を生成する
|
||
- table-definition-writer: テーブル定義書を作成する
|
||
- ddl-script-generator: DDLスクリプトを生成する
|
||
|
||
コンベンションスキル候補:
|
||
- database-naming-conventions: データベース命名規則
|
||
- normalization-rules: 正規化ルール
|
||
|
||
コマンド候補:
|
||
- design-database: データベース設計全体を実行（全スキルを順次実行）
|
||
- generate-schema: スキーマ定義のみを生成（一部スキルを実行）
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
【分類結果】
|
||
|
||
エージェント: データベース
|
||
スキル: いろいろ
|
||
コマンド: 実行
|
||
```
|
||
|
||
### フェーズ5: 推奨提示
|
||
|
||
分類結果を基に、推奨されるプラグイン構成をユーザーに提示する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 推奨されるエージェント構成を提示する
|
||
2. 推奨されるスキル構成を提示する
|
||
3. 推奨されるコマンド構成を提示する
|
||
4. 実装の優先順位を提案する
|
||
5. 次のステップ（各要素の詳細設計）を案内する
|
||
|
||
**提示形式:**
|
||
|
||
```markdown
|
||
【推奨プラグイン構成】
|
||
|
||
プラグイン名: database-design-plugin
|
||
|
||
エージェント (1個):
|
||
- database-design-agent: データベース設計全体に対する責任を持つ
|
||
|
||
スキル (7個):
|
||
ワークフロースキル:
|
||
- entity-definition-collector: エンティティ定義を収集する
|
||
- normalization-processor: 正規化を実施する
|
||
- er-diagram-generator: ER図を生成する
|
||
- table-definition-writer: テーブル定義書を作成する
|
||
- ddl-script-generator: DDLスクリプトを生成する
|
||
|
||
コンベンションスキル:
|
||
- database-naming-conventions: データベース命名規則
|
||
- normalization-rules: 正規化ルール
|
||
|
||
コマンド (2個):
|
||
- design-database: データベース設計全体を実行
|
||
- generate-schema: スキーマ定義のみを生成
|
||
|
||
【実装優先順位】
|
||
|
||
優先度1（必須）:
|
||
- database-design-agent
|
||
- entity-definition-collector
|
||
- normalization-processor
|
||
- database-naming-conventions
|
||
- normalization-rules
|
||
|
||
優先度2（推奨）:
|
||
- er-diagram-generator
|
||
- table-definition-writer
|
||
- design-database コマンド
|
||
|
||
優先度3（オプション）:
|
||
- ddl-script-generator
|
||
- generate-schema コマンド
|
||
```
|
||
|
||
**良い例:**
|
||
|
||
推奨構成が明確で、各要素の役割が説明されており、優先順位が付けられている。
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
【推奨プラグイン構成】
|
||
|
||
いろいろ作る
|
||
```
|
||
|
||
## アウトプット
|
||
|
||
このスキルは以下を生成する:
|
||
|
||
- **必要な機能リスト**: 抽出された機能の一覧（入力・処理・出力を含む）
|
||
- **推奨エージェント/スキル/コマンド候補**: プラグイン要素の推奨構成
|
||
- **テンプレートファイルリスト**: ドキュメント生成機能で使用するテンプレートファイルの一覧（配置先を含む）
|
||
- **業務領域分析レポート**: 業務の特徴、制約、前提条件をまとめたドキュメント
|
||
|
||
## 想定されるエラーと対処法
|
||
|
||
### エラー1: 業務領域が曖昧
|
||
|
||
**検出例:**
|
||
|
||
```markdown
|
||
業務領域: いろいろなこと
|
||
```
|
||
|
||
**対処法:**
|
||
|
||
- 具体的な業務名や作業内容を確認する
|
||
- 既存の業務プロセスやドキュメントを参照する
|
||
- ユーザーに具体例を尋ねる
|
||
|
||
### エラー2: 機能の粒度が不適切
|
||
|
||
**検出例:**
|
||
|
||
```markdown
|
||
機能: データベース全体を作成する
|
||
```
|
||
|
||
**対処法:**
|
||
|
||
- 機能を小さなステップに分解する
|
||
- 各ステップの入力と出力を明確にする
|
||
- 1つの機能は1つの明確な目的を持つようにする
|
||
|
||
### エラー3: 要素分類が不明確
|
||
|
||
**検出例:**
|
||
|
||
エージェントとスキルの区別が曖昧で、どちらに分類すべきか不明確。
|
||
|
||
**対処法:**
|
||
|
||
- エージェントは「責任範囲」、スキルは「具体的な作業手順」と区別する
|
||
- 複数のスキルをまとめる役割はエージェントにする
|
||
- 1つの明確な作業フローを持つものはスキルにする
|
||
|
||
## ベストプラクティス
|
||
|
||
- 業務領域の理解には十分な時間をかける（急がず丁寧に）
|
||
- ユーザーとの対話を重視し、推測や仮定を避ける
|
||
- 機能は小さく分解し、単一責任の原則に従う
|
||
- 要素分類は明確な基準に基づいて行う
|
||
- 推奨構成は実装の優先順位を明示する
|
||
- 業務領域分析レポートは後続フェーズで参照できるようにする
|
||
|
||
## チェックリスト
|
||
|
||
### 情報収集完了時
|
||
|
||
- [ ] 業務領域の概要が明確になっている
|
||
- [ ] プラグイン化の目的が明確になっている
|
||
- [ ] 対象ユーザーが特定されている
|
||
- [ ] 現在の課題や問題点が把握されている
|
||
- [ ] 期待される効果や成果が確認されている
|
||
|
||
### 領域分析完了時
|
||
|
||
- [ ] 業務の特徴が整理されている
|
||
- [ ] 技術的制約が特定されている
|
||
- [ ] ビジネス的制約が特定されている
|
||
- [ ] 前提条件や依存関係が把握されている
|
||
- [ ] 既存ツールやプロセスとの関係が確認されている
|
||
|
||
### 機能抽出完了時
|
||
|
||
- [ ] 業務の各ステップが分解されている
|
||
- [ ] 自動化可能な作業が特定されている
|
||
- [ ] 手作業が必要な部分が明確になっている
|
||
- [ ] 各機能の入力と出力が定義されている
|
||
- [ ] ドキュメント生成機能で使用するテンプレートファイルが特定されている
|
||
- [ ] 機能間の依存関係が整理されている
|
||
- [ ] 機能の粒度が適切である（単一責任の原則）
|
||
|
||
### 要素分類完了時
|
||
|
||
- [ ] エージェント候補が特定されている
|
||
- [ ] ワークフロースキル候補が特定されている
|
||
- [ ] コンベンションスキル候補が特定されている
|
||
- [ ] コマンド候補が特定されている
|
||
- [ ] 要素間の依存関係が整理されている
|
||
- [ ] 分類基準が明確である
|
||
|
||
### 推奨提示完了時
|
||
|
||
- [ ] 推奨プラグイン構成が明確に提示されている
|
||
- [ ] 各要素の役割が説明されている
|
||
- [ ] 実装の優先順位が付けられている
|
||
- [ ] 次のステップが案内されている
|
||
- [ ] ユーザーの承認を得ている
|
||
|
||
### 最終確認
|
||
|
||
- [ ] 必要な機能リストが作成されている
|
||
- [ ] 推奨エージェント/スキル/コマンド候補が提示されている
|
||
- [ ] 業務領域分析レポートが作成されている
|
||
- [ ] すべてのアウトプットが明確で理解しやすい
|
||
- [ ] ユーザーが次のステップに進める状態になっている
|