455 lines
16 KiB
Markdown
455 lines
16 KiB
Markdown
---
|
||
name: responsibility-mapper
|
||
description: 作業の責任範囲を整理し、エージェント定義に必要な情報を抽出する。エージェント設計時、責任範囲整理時、またはユーザーが責任範囲、役割分担、責任境界、エージェント構成に言及した際に使用する。
|
||
---
|
||
|
||
# Responsibility Mapper
|
||
|
||
## 概要
|
||
|
||
このSkillは、ユーザーが提供する作業や業務の情報を基に、責任範囲を整理し、エージェント定義に必要な情報を抽出する。ユーザーとの対話を通じて責任の境界を明確にし、適切なエージェント構成を提案する。
|
||
|
||
## 責任範囲
|
||
|
||
このSkillは以下の範囲をカバーする:
|
||
|
||
- 作業や業務の責任範囲の収集
|
||
- 責任範囲の分類と整理
|
||
- 責任範囲内・責任範囲外の明確化
|
||
- エージェント候補の特定と分類
|
||
- 推奨エージェント構成の提案
|
||
- エージェント定義情報の作成
|
||
|
||
## ワークフロー
|
||
|
||
### フェーズ1: 責任収集
|
||
|
||
ユーザーとの対話を通じて、作業や業務の責任範囲に関する情報を収集する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 対象となる作業や業務を確認する
|
||
2. 作業の目的と範囲を把握する
|
||
3. 担当者や役割を特定する
|
||
4. 責任の境界を確認する
|
||
5. 関連する作業やシステムを把握する
|
||
|
||
**質問例:**
|
||
|
||
```markdown
|
||
【責任範囲の確認】
|
||
エージェントに担当させたい責任範囲を教えてください。
|
||
|
||
1. フェーズ全体（例: 要件定義フェーズ全体、設計フェーズ全体）
|
||
2. 領域全体（例: セキュリティ領域全体、品質管理領域全体）
|
||
3. 特定の役割（例: レビュー担当、ドキュメント作成担当）
|
||
4. その他（具体的に教えてください）
|
||
```
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
責任範囲: データベース設計フェーズ全体
|
||
目的: データベーススキーマの設計、正規化、ドキュメント作成を一貫して管理する
|
||
担当者: データベースエンジニア、バックエンド開発者
|
||
境界:
|
||
- 開始: 要件定義が完了し、エンティティの候補が特定された時点
|
||
- 終了: テーブル定義書とDDLスクリプトが作成され、レビューが完了した時点
|
||
関連:
|
||
- 前工程: 要件定義（エンティティ候補の提供）
|
||
- 後工程: データベース構築（DDLスクリプトの実行）
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
責任範囲: データベース
|
||
目的: いろいろやる
|
||
担当者: 誰か
|
||
境界: よくわからない
|
||
```
|
||
|
||
### フェーズ2: 責任分類
|
||
|
||
収集した責任範囲を、カテゴリ別に分類し整理する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 責任範囲をフェーズ別、領域別、役割別に分類する
|
||
2. 責任の粒度を評価する（大きすぎる、適切、小さすぎる）
|
||
3. 責任の重複を確認する
|
||
4. 責任のギャップを特定する
|
||
5. 責任の優先順位を付ける
|
||
|
||
**分類基準:**
|
||
|
||
- **フェーズ別**: 開発プロセスの特定フェーズに対する責任（要件定義、設計、実装など）
|
||
- **領域別**: 特定の技術領域や品質領域に対する責任（セキュリティ、パフォーマンス、テストなど）
|
||
- **役割別**: 特定の役割や作業に対する責任（レビュー、ドキュメント作成、検証など）
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
【責任分類結果】
|
||
|
||
フェーズ別責任:
|
||
- データベース設計フェーズ全体
|
||
- エンティティ定義
|
||
- 正規化
|
||
- ER図作成
|
||
- テーブル定義書作成
|
||
- DDLスクリプト生成
|
||
|
||
粒度評価: 適切
|
||
- 1つのフェーズとして明確な範囲がある
|
||
- 作業の開始と終了が明確
|
||
- 成果物が定義されている
|
||
|
||
重複確認:
|
||
- 要件定義フェーズとの境界: エンティティ候補の特定は要件定義の責任
|
||
- データベース構築フェーズとの境界: DDLスクリプトの実行は構築の責任
|
||
|
||
優先順位:
|
||
1. エンティティ定義（最も重要、後続作業の基礎）
|
||
2. 正規化（品質の要）
|
||
3. テーブル定義書作成（ドキュメント）
|
||
4. ER図作成（可視化）
|
||
5. DDLスクリプト生成（自動化）
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
【責任分類結果】
|
||
|
||
フェーズ: いろいろ
|
||
粒度: たぶん良い
|
||
重複: 知らない
|
||
```
|
||
|
||
### フェーズ3: 範囲定義
|
||
|
||
責任範囲内と責任範囲外を明確に定義する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 責任範囲内の項目を列挙する
|
||
2. 責任範囲外の項目を列挙する
|
||
3. 境界が曖昧な項目を明確にする
|
||
4. 注意事項を整理する
|
||
5. 制約条件を確認する
|
||
|
||
**定義基準:**
|
||
|
||
- **責任範囲内**: エージェントが明確に担当する範囲
|
||
- 具体的で検証可能
|
||
- 開始と終了が明確
|
||
- 成果物が定義されている
|
||
- **責任範囲外**: エージェントが担当しない範囲
|
||
- 混同しやすい範囲
|
||
- 他のエージェントや人間の責任
|
||
- 明示的に除外すべき範囲
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
【責任範囲定義】
|
||
|
||
責任範囲内:
|
||
|
||
**エンティティ定義:** エンティティの特定、属性の定義、関連の整理を行う
|
||
**正規化:** 第1正規形〜第3正規形への変換、正規化ルールの検証を行う
|
||
**ER図作成:** エンティティ関連図の生成、レイアウト最適化を行う
|
||
**テーブル定義書作成:** テーブル定義、カラム定義、制約定義をドキュメント化する
|
||
**DDLスクリプト生成:** データベース製品別のCREATE TABLE文、制約定義を生成する
|
||
|
||
責任範囲外:
|
||
|
||
**エンティティ候補の特定:** 要件定義フェーズの責任であり、このエージェントは候補を受け取る側
|
||
**DDLスクリプトの実行:** データベース構築フェーズの責任であり、このエージェントはスクリプトを提供する側
|
||
**パフォーマンスチューニング:** データベース運用の責任であり、設計フェーズでは考慮するが実施しない
|
||
|
||
注意事項:
|
||
|
||
- エンティティ定義は要件定義からの引き継ぎを明確にする
|
||
- 正規化は必ずルールに基づいて実施する
|
||
- ER図は自動生成を基本とし、手動調整は最小限にする
|
||
- テーブル定義書はMarkdown形式で作成する
|
||
- DDLスクリプトは対象データベース製品を明示する
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
【責任範囲定義】
|
||
|
||
責任範囲内: データベースのこと
|
||
責任範囲外: データベース以外のこと
|
||
```
|
||
|
||
### フェーズ4: エージェント分類
|
||
|
||
定義した責任範囲を基に、エージェント候補を特定し分類する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 責任範囲からエージェント候補を特定する
|
||
2. エージェントの役割を定義する
|
||
3. エージェントの使用可能なツールを確認する
|
||
4. エージェントの表示色を決定する
|
||
5. エージェント間の依存関係を整理する
|
||
|
||
**分類基準:**
|
||
|
||
- 1エージェントは1つの明確な責任範囲を持つ
|
||
- エージェントの粒度は適切である（大きすぎず、小さすぎず）
|
||
- エージェント間の境界が明確である
|
||
- エージェントの役割が重複していない
|
||
|
||
**良い例:**
|
||
|
||
```markdown
|
||
【エージェント分類結果】
|
||
|
||
エージェント候補:
|
||
|
||
1. database-design-agent
|
||
- 役割: データベース設計フェーズ全体に対する責任を持つ
|
||
- 責任範囲: エンティティ定義、正規化、ER図作成、テーブル定義書作成、DDLスクリプト生成
|
||
- 使用可能なツール: All tools (Read, Write, Bash, Grep, Glob など)
|
||
- 表示色: blue（設計フェーズを示す色）
|
||
- モデル: inherit（デフォルトモデルを使用）
|
||
|
||
責任範囲内:
|
||
- エンティティ定義: エンティティの特定、属性の定義、関連の整理を行う
|
||
- 正規化: 第1正規形〜第3正規形への変換、正規化ルールの検証を行う
|
||
- ER図作成: エンティティ関連図の生成、レイアウト最適化を行う
|
||
- テーブル定義書作成: テーブル定義、カラム定義、制約定義をドキュメント化する
|
||
- DDLスクリプト生成: データベース製品別のCREATE TABLE文、制約定義を生成する
|
||
|
||
責任範囲外:
|
||
- エンティティ候補の特定: 要件定義フェーズの責任
|
||
- DDLスクリプトの実行: データベース構築フェーズの責任
|
||
- パフォーマンスチューニング: データベース運用の責任
|
||
|
||
注意事項:
|
||
- エンティティ定義は要件定義からの引き継ぎを明確にする
|
||
- 正規化は必ずルールに基づいて実施する
|
||
- ER図は自動生成を基本とし、手動調整は最小限にする
|
||
- テーブル定義書はMarkdown形式で作成する
|
||
- DDLスクリプトは対象データベース製品を明示する
|
||
|
||
依存関係:
|
||
- 前工程: 要件定義エージェント（エンティティ候補の提供を受ける）
|
||
- 後工程: データベース構築エージェント（DDLスクリプトを提供する）
|
||
- 使用するスキル: entity-definition-collector, normalization-processor, er-diagram-generator など
|
||
```
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
エージェント: データベース担当
|
||
役割: データベースのことをやる
|
||
```
|
||
|
||
### フェーズ5: 推奨提示
|
||
|
||
分類結果を基に、推奨されるエージェント構成をユーザーに提示する。
|
||
|
||
**実施内容:**
|
||
|
||
1. 推奨されるエージェント構成を提示する
|
||
2. 各エージェントの定義情報をまとめる
|
||
3. エージェント間の関係を図示する
|
||
4. 実装の優先順位を提案する
|
||
5. 次のステップ（エージェントの詳細設計）を案内する
|
||
|
||
**提示形式:**
|
||
|
||
```markdown
|
||
【推奨エージェント構成】
|
||
|
||
エージェント数: 1個
|
||
|
||
エージェント1: database-design-agent
|
||
- 説明: データベース設計フェーズ全体に対する責任を持つ
|
||
- 責任範囲: エンティティ定義、正規化、ER図作成、テーブル定義書作成、DDLスクリプト生成
|
||
- 表示色: blue
|
||
- 使用可能なツール: All tools
|
||
|
||
【責任範囲マップ】
|
||
|
||
database-design-agent の責任範囲:
|
||
|
||
責任範囲内:
|
||
- エンティティ定義
|
||
- 正規化
|
||
- ER図作成
|
||
- テーブル定義書作成
|
||
- DDLスクリプト生成
|
||
|
||
責任範囲外:
|
||
- エンティティ候補の特定（要件定義の責任）
|
||
- DDLスクリプトの実行（データベース構築の責任）
|
||
- パフォーマンスチューニング（データベース運用の責任）
|
||
|
||
【エージェント定義情報】
|
||
|
||
database-design-agent 用のエージェント定義ファイル情報:
|
||
|
||
フロントマター:
|
||
- name: database-design-agent
|
||
- description: データベース設計フェーズ全体に対する責任を持つ
|
||
- tools: "*"
|
||
- model: inherit
|
||
- color: blue
|
||
|
||
役割:
|
||
データベース設計フェーズ全体に対する責任を持ち、エンティティ定義から DDL スクリプト生成までを一貫して管理する。要件定義フェーズから引き継いだエンティティ候補を基に、正規化されたテーブル定義を作成し、ER 図とテーブル定義書、DDL スクリプトを生成する。
|
||
|
||
責任範囲:
|
||
（上記の責任範囲内・外をそのまま使用）
|
||
|
||
注意事項:
|
||
- エンティティ定義は要件定義からの引き継ぎを明確にする
|
||
- 正規化は必ずルールに基づいて実施する
|
||
- ER図は自動生成を基本とし、手動調整は最小限にする
|
||
- テーブル定義書はMarkdown形式で作成する
|
||
- DDLスクリプトは対象データベース製品を明示する
|
||
|
||
【実装優先順位】
|
||
|
||
優先度1（必須）:
|
||
- database-design-agent の作成
|
||
|
||
【次のステップ】
|
||
|
||
1. database-design-agent の詳細設計（agent-generator スキルを使用）
|
||
2. 関連するスキルの設計（workflow-analyzer スキルを使用）
|
||
3. コマンドの設計（command-generator スキルを使用）
|
||
```
|
||
|
||
**良い例:**
|
||
|
||
推奨構成が明確で、エージェント定義情報が詳細に記述されており、次のステップが案内されている。
|
||
|
||
**悪い例:**
|
||
|
||
```markdown
|
||
エージェントを作る
|
||
```
|
||
|
||
## アウトプット
|
||
|
||
このスキルは以下を生成する:
|
||
|
||
- **責任範囲マップ**: 作業と責任範囲の対応関係を整理したマッピング
|
||
- **推奨エージェント構成**: 責任範囲を実現するために必要なエージェントの推奨案
|
||
- **エージェント定義情報**: 各エージェントの責任範囲内・外、注意事項などの詳細情報
|
||
|
||
## 想定されるエラーと対処法
|
||
|
||
### エラー1: 責任範囲が曖昧
|
||
|
||
**検出例:**
|
||
|
||
```markdown
|
||
責任範囲: データベース全般
|
||
```
|
||
|
||
**対処法:**
|
||
|
||
- 具体的な作業や成果物を明示する
|
||
- 開始条件と終了条件を明確にする
|
||
- 責任の境界を明示する
|
||
|
||
### エラー2: 責任範囲が大きすぎる
|
||
|
||
**検出例:**
|
||
|
||
```markdown
|
||
責任範囲: システム開発全体
|
||
```
|
||
|
||
**対処法:**
|
||
|
||
- 責任範囲をフェーズ別、領域別、役割別に分割する
|
||
- 1エージェントは1つの明確な責任範囲を持つようにする
|
||
- 複数のエージェントに分割することを検討する
|
||
|
||
### エラー3: 責任範囲内・外が不明確
|
||
|
||
**検出例:**
|
||
|
||
```markdown
|
||
責任範囲内: いろいろ
|
||
責任範囲外: その他
|
||
```
|
||
|
||
**対処法:**
|
||
|
||
- 具体的な作業や成果物を列挙する
|
||
- 「〜を行う」という動詞で表現する
|
||
- 混同しやすい範囲を明示的に除外する
|
||
|
||
## ベストプラクティス
|
||
|
||
- 責任範囲は具体的で検証可能にする
|
||
- 責任の境界を明確にする（開始条件、終了条件）
|
||
- 責任範囲内・外を明示的に定義する
|
||
- エージェントの粒度は適切にする（1エージェント1責任）
|
||
- 推奨構成は実装の優先順位を明示する
|
||
- エージェント定義情報は詳細に記述する
|
||
|
||
## チェックリスト
|
||
|
||
### 責任収集完了時
|
||
|
||
- [ ] 対象となる作業や業務が確認されている
|
||
- [ ] 作業の目的と範囲が把握されている
|
||
- [ ] 担当者や役割が特定されている
|
||
- [ ] 責任の境界が確認されている
|
||
- [ ] 関連する作業やシステムが把握されている
|
||
|
||
### 責任分類完了時
|
||
|
||
- [ ] 責任範囲がフェーズ別、領域別、役割別に分類されている
|
||
- [ ] 責任の粒度が評価されている
|
||
- [ ] 責任の重複が確認されている
|
||
- [ ] 責任のギャップが特定されている
|
||
- [ ] 責任の優先順位が付けられている
|
||
|
||
### 範囲定義完了時
|
||
|
||
- [ ] 責任範囲内の項目が列挙されている
|
||
- [ ] 責任範囲外の項目が列挙されている
|
||
- [ ] 境界が曖昧な項目が明確になっている
|
||
- [ ] 注意事項が整理されている
|
||
- [ ] 制約条件が確認されている
|
||
|
||
### エージェント分類完了時
|
||
|
||
- [ ] エージェント候補が特定されている
|
||
- [ ] エージェントの役割が定義されている
|
||
- [ ] エージェントの使用可能なツールが確認されている
|
||
- [ ] エージェントの表示色が決定されている
|
||
- [ ] エージェント間の依存関係が整理されている
|
||
- [ ] エージェントの粒度が適切である
|
||
|
||
### 推奨提示完了時
|
||
|
||
- [ ] 推奨エージェント構成が明確に提示されている
|
||
- [ ] 各エージェントの定義情報がまとめられている
|
||
- [ ] エージェント間の関係が図示されている
|
||
- [ ] 実装の優先順位が提案されている
|
||
- [ ] 次のステップが案内されている
|
||
- [ ] ユーザーの承認を得ている
|
||
|
||
### 最終確認
|
||
|
||
- [ ] 責任範囲マップが作成されている
|
||
- [ ] 推奨エージェント構成が提示されている
|
||
- [ ] エージェント定義情報が作成されている
|
||
- [ ] すべてのアウトプットが明確で理解しやすい
|
||
- [ ] ユーザーが次のステップに進める状態になっている
|