ビジネス要件定義書(BRD)の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)の中でも最上流に位置する成果物であり、ドメイン定義書・プロダクト要求仕様書(PRD)本体・ドメイン要求仕様書群すべての根拠となる業務観点の要求文書。新規プロジェクト立ち上げ時の最初の成果物作成、戦略・スコープの大きな変更、KPI見直しのタイミングで呼び出す。
d1-actor-list
アクター一覧の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、本システムに関わるすべての人間アクター(関係者)を一覧化する文書。TOGAFのActor Catalog相当。
BRDの下流に位置する成果物。後続の成果物であるプロダクト要求仕様書やユーザーストーリー一覧、C4モデルレベル1、C4モデルレベル2、L1シーケンス、L2シーケンスなど、様々な成果物から参照される。BRD策定後、アクター整理の段階で呼び出す。
含まれるファイル(2)
- SKILL.md4.7 KB
- template.md3.6 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
D1: アクター一覧
inputする成果物
| 成果物のパス | 内容 |
|---|---|
docs/D1.business-requirements/business-requirement-document.md | 上流のBRD(スコープ・対象ユーザー概要・コンプライアンス制約 等を参照) |
docs/D1.business-requirements/actor-list.md | 既存アクター一覧(更新・レビュー時のみ参照。新規作成時は未存在) |
outputする成果物
| 成果物のパス | 内容 |
|---|---|
docs/D1.business-requirements/actor-list.md | アクター一覧本体 |
使用するテンプレート
出力時は以下のテンプレートを読み込み、その章構成・分類軸・書き方ヒントに従う。
| テンプレートのパス | 内容 |
|---|---|
.claude/skills/d1-actor-list/template.md | アクター一覧テンプレート(章構成・分類軸・書き方ヒント) |
新規作成時の振る舞い
新規作成時(docs/D1.business-requirements/actor-list.md 未存在)は ユーザーへのヒアリングを行わず、上流の BRD と業界一般知識から人間アクターを推定して直接生成する。
- BRD(
docs/D1.business-requirements/business-requirement-document.md)を読み込み、スコープ・対象ユーザー概要・コンプライアンス制約 等から人間アクター候補を分類軸(種別・境界・関与の仕方)ごとに抽出する - 直接利用者・間接受け手・統制監督・関係部門 の各観点で網羅性を確認する
- テンプレート(
.claude/skills/d1-actor-list/template.md)の形式に従って書き出す。BRD・業界知識から確定できない値には要確認マーカーを付ける
留意事項
- 人間アクターのみを扱う: システム等の非人間アクターは本書では扱わず、後続の C4 モデル(レベル1・2)で表現する。本書はシステムを直接利用する者だけでなく、システム出力物を他者経由で受け取る者・統制する者など、直接利用しない人間アクターも含めて網羅する
- 分類軸は固定: 「種別・境界・関与の仕方」の3軸を基本とする。プロジェクト固有の分類軸を追加してもよいが、可読性のため4軸以内に留める
- 業務観点に留まる: 機能名・画面名・テーブル名等のシステム実装語は混入させない。詳細仕様(具体的な権限・操作手順・利用シナリオ 等)は下流の PRD・ドメイン要求仕様書等に降ろす
- BRD との整合性: 上流の BRD のスコープ(対象業務範囲)・対象ユーザー概要と整合させる
完成時のセルフチェック
執筆完了時に以下の観点で出力を検査し、不備があれば修正したうえで出力を完了とする。
- 人間アクターのみが記載されているか(システムが紛れ込んでいないか)
- システムを直接使う人だけでなく、システム出力物を他者経由で受け取る人や、システムによって影響を受ける人も挙げられているか
- 重複なく、抜けなく(MECE)挙げられているか
- BRD のスコープ(対象業務範囲)・対象ユーザー概要と整合しているか
- 機能名・画面名・テーブル名等のシステム実装語が混入していないか(業務観点に留まっているか)
{{や XXX のプレースホルダが残っていないか
下流への伝搬関係
作成・更新時は以下の下流成果物との整合を意識する:
| 下流成果物 | アクター一覧から何を引く |
|---|---|
| プロダクト要求仕様書 | 全般(特にシステムの利用ユーザー) |
| ユーザーストーリー一覧 | 全般(ユーザーストーリーのユーザーそのものがアクター一覧そのもの) |
| C4モデルレベル1 | システムの利用ユーザー |
| C4モデルレベル2 | システムの利用ユーザー |
| L1シーケンス | システムの利用ユーザー |
| L2シーケンス | システムの利用ユーザー |
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
ドメイン共通要求仕様書の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、プロダクト要求仕様書(PRD)が方針・概念を扱うのに対し、本書は **3 ドメイン以上で横断的に効く具体的な要求(水準・方針・原則)** を集約する文書。**ドメイン要求仕様書群(個別)とは並列の関係にあり、横断的な水準・方針・原則は本書が単独で責務を持つ(=厳密な MECE。個別ドメインで言い換えない)。** 機能要求・非機能要求・UI/UX 方針・セキュリティ要求・データアクセス要求・法務/コンプライアンス要求 の各節を持つ。PRD・アクター一覧・ドメイン定義書 を上流とし、PRD策定後、ドメイン要求仕様書群(個別)の作成前に呼び出す。
ドメイン定義書の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、本プロダクトを構成する業務領域(ドメイン)を網羅・分類する文書。問題空間(プロダクトが扱う業務領域)の整理であり、DDDにおけるBounded Context(解空間としての実装上の境界)とは別レイヤーで扱う。BRDの下流に位置する成果物。後続のプロダクト要求仕様書、ドメイン要求仕様書群(各ドメインごとに1つ)など、様々な成果物から参照される。BRD策定後、ドメイン整理の段階で呼び出す。
ドメイン要求仕様書の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、プロダクト要求仕様書(PRD)を親文書とし、ドメイン定義書で定義された各ドメインごとに1冊作成される。**ドメイン共通要求仕様書(横断的な水準・方針・原則)とは並列の関係にあり、当該ドメイン固有の業務ルール・業務状態遷移・業務運用(イレギュラー対応)のみを扱う(共通要求と内容が重なる要求は本書に書かない=厳密な MECE)。** PRD・ドメイン定義書の策定後、ドメインごとの業務要求を具体化する段階で呼び出す。下流のユーザーストーリー一覧・ユースケース一覧・機能一覧(D2)・画面要件群(D2)・L1/L2シーケンス図の起点となる。
プロダクト要求仕様書(PRD)の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、方針・概念・体験設計・制約・受け入れ基準を扱う文書。具体的な横断要求(機能要求・非機能要求・UI/UX・セキュリティ・法務 等)は独立成果物のドメイン共通要求仕様書に集約し、PRD は要求 ID を持たない。BRD・アクター一覧・ドメイン定義書 を上流とし、BRD策定後、ドメイン共通要求仕様書の作成前に呼び出す。
画面コンセプト集の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、プロダクト全体の画面体験コンセプト(体験方向性・体験原則・トーン&マナー方針)と、それを体現する代表シーン2-3を、ビジネスサイドが議論・合意できるサイズに整理する文書。業界を問わず利用可能(業務アプリ・ゲーム・コンシューマー向けサービス・SaaS 等)。プロダクト要求仕様書(PRD)・アクター一覧・ユーザーストーリー一覧を上流とし、下流のワイヤーフレーム・画面遷移図・画面要件群(D2)の判断基準となる画面体験の方向性を定める。全画面の網羅は D2 画面要件群に降ろし、本書はコンセプトと代表シーンに集約する。PRD・ユーザーストーリー一覧の策定後、D2 画面要件群の作成前、もしくはデザイン会社への発注前に呼び出す。