--- 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責任） - 推奨構成は実装の優先順位を明示する - エージェント定義情報は詳細に記述する ## チェックリスト ### 責任収集完了時 - [ ] 対象となる作業や業務が確認されている - [ ] 作業の目的と範囲が把握されている - [ ] 担当者や役割が特定されている - [ ] 責任の境界が確認されている - [ ] 関連する作業やシステムが把握されている ### 責任分類完了時 - [ ] 責任範囲がフェーズ別、領域別、役割別に分類されている - [ ] 責任の粒度が評価されている - [ ] 責任の重複が確認されている - [ ] 責任のギャップが特定されている - [ ] 責任の優先順位が付けられている ### 範囲定義完了時 - [ ] 責任範囲内の項目が列挙されている - [ ] 責任範囲外の項目が列挙されている - [ ] 境界が曖昧な項目が明確になっている - [ ] 注意事項が整理されている - [ ] 制約条件が確認されている ### エージェント分類完了時 - [ ] エージェント候補が特定されている - [ ] エージェントの役割が定義されている - [ ] エージェントの使用可能なツールが確認されている - [ ] エージェントの表示色が決定されている - [ ] エージェント間の依存関係が整理されている - [ ] エージェントの粒度が適切である ### 推奨提示完了時 - [ ] 推奨エージェント構成が明確に提示されている - [ ] 各エージェントの定義情報がまとめられている - [ ] エージェント間の関係が図示されている - [ ] 実装の優先順位が提案されている - [ ] 次のステップが案内されている - [ ] ユーザーの承認を得ている ### 最終確認 - [ ] 責任範囲マップが作成されている - [ ] 推奨エージェント構成が提示されている - [ ] エージェント定義情報が作成されている - [ ] すべてのアウトプットが明確で理解しやすい - [ ] ユーザーが次のステップに進める状態になっている