majiayu000 Role Prompting
概要
AIエージェント・システムロール・ペルソナのための役割プロンプト設計スキル。 単一責務原則に基づく責務分離、専門家思考様式の効果的な適用、構造化されたプロンプト設計を支援する。
ワークフロー
analyze-purpose → design-role → generate-prompt → validate-role
Task 1: 目的分析（analyze-purpose）
目的: ロールが必要な理由と達成すべきゴールを明確化する
アクション:
- ロールが担う責務を特定
- 対象ドメインと専門領域を定義
- 成功基準と制約条件を設定
Task: agents/analyze-purpose.md を参照
Task 2: ロール設計（design-role）
目的: 責務・専門領域・思考様式を体系的に定義する
アクション:
- 参照すべき専門家/思考様式を選定
- 責務と成果物のマッピングを作成
- 知識ベースと参考文献を特定
Task: agents/design-role.md を参照
Task 3: プロンプト生成（generate-prompt）
目的: 設計に基づいて構造化されたロールプロンプトを生成する
アクション:
- メタ情報（名前・専門領域）を記述
- プロフィール（背景・目的・責務）を構成
- 実行仕様（思考プロセス・チェックリスト）を定義
Task: agents/generate-prompt.md を参照
Task 4: 検証（validate-role）
目的: 設計したロールの一貫性と効果を検証する
アクション:
- 責務の重複・欠落をチェック
- 思考様式の適切性を評価
- 実際のユースケースでテスト
Task: agents/validate-role.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-purpose | ロール設計開始時 | 要件・コンテキスト | 目的定義書 |
| design-role | 目的分析完了後 | 目的定義書 | ロール設計書 |
| generate-prompt | ロール設計完了後 | ロール設計書 | ロールプロンプト |
| validate-role | プロンプト生成完了後 | ロールプロンプト | 検証レポート |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| 単一責務原則を適用する | ロールの明確性と保守性を確保 |
| 実在の専門家を参照ラベルとして使用 | 思考様式の一貫性を担保 |
| 責務と成果物を明示的にマッピング | 期待される出力が明確になる |
| 入出力インターフェースを定義 | 他ロールとの連携が容易になる |
| 検証チェックリストを設ける | 品質基準を客観的に確認できる |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 複数責務を1ロールに集中させる | 責務の肥大化と保守困難 |
| 専門家本人を名乗る・発言を捏造 | 倫理的問題 |
| 曖昧な条件記述（「必要に応じて」） | 再現性と予測可能性の低下 |
| 思考様式なしで役割を定義 | 行動パターンが不明確 |
| 入出力仕様を省略 | 連携時のエラーとデバッグ困難 |
リソース参照
agents/（Task仕様書）
| Task仕様書 | 責務 |
|---|---|
agents/analyze-purpose.md |
目的・責務・制約条件の分析 |
agents/design-role.md |
ロール構造と思考様式の設計 |
agents/generate-prompt.md |
構造化プロンプトの生成 |
agents/validate-role.md |
設計の検証と改善提案 |
references/（詳細知識）
| リソース | パス | 読込条件 |
|---|---|---|
| ロール設計パターン | references/role-patterns.md | ロール設計時に参照 |
| 責務分離原則 | references/responsibility-separation.md | 複数ロール設計時に参照 |
| プロンプト構造 | references/prompt-structures.md | プロンプト生成時に参照 |
scripts/（決定論的処理）
| スクリプト | 機能 |
|---|---|
scripts/log_usage.mjs |
使用記録とフィードバック保存 |
assets/（テンプレート）
| アセット | 用途 |
|---|---|
assets/role-prompt-template.md |
ロールプロンプト作成用テンプレート |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2026-01-02 | 18-skills.md仕様完全準拠・責務ベースagents/追加 |
| 1.1.0 | 2025-12-31 | 18-skills.md仕様に準拠、YAML frontmatter整備 |
| 1.0.0 | 2025-12-24 | 初版作成 |