writing-prds について
目標やユーザーストーリーから要件、レビューまで、プロダクト要件文書(PRD)の作成を支援するスキルです。機能仕様をまとめるための構成とワークフローを示します。
主な機能
- 01目標と成功指標の定義
- 02ステークホルダーとユーザーストーリーの整理
- 03機能要件と非機能要件
- 04PRDの構成と保存先
- 05Given/When/Then形式の受け入れ条件
活用シーン
- 01機能のPRD作成
- 02ユーザーニーズのユーザーストーリー化
- 03テスト可能な受け入れ条件の定義
- 04レビュー用要件文書の準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dralgorhythm/ claude-agentic-framework --skill writing-prdsインストール後、Claude Code で/writing-prdsを入力して読み込まれたか確認します。
同梱ファイルresources/prd.template.md
詳細
PRD の作成
ワークフロー
- 目標の定義:ビジネス目標と成功指標を明確にします
- ステークホルダーの特定:関連するすべてのステークホルダーをリストアップします
- ユーザーストーリーの作成:ユーザーのニーズをまとめます
- 要件の詳細化:機能要件と非機能要件をリストアップします
- 成果物の保存:
./artifacts/prd_[feature].mdに保存します - レビュー:ステークホルダーによるレビューを実施します
PRD の構成
- 概要:何を、なぜ行うのか
- 目標と成功指標:成功をどのように測定するか
- ユーザーストーリー:誰が、どのようなメリットを得るのか
- 要件:何を構築する必要があるか
- 対象外:構築しないもの
- タイムライン:主なマイルストーン
ユーザーストーリーの形式
As a [role],
I want [feature],
So that [benefit].
例
As a registered user,
I want to reset my password via email,
So that I can regain access to my account if I forget it.
受け入れ基準
Given/When/Then 形式を使用します。
Given I am on the login page
When I click "Forgot Password"
Then I see a form to enter my email
Given I enter a valid registered email
When I submit the form
Then I receive a password reset email within 5 minutes
INVEST 基準
優れたユーザーストーリーの条件:
- Independent(独立している):個別に開発できます
- Negotiable(交渉可能である):詳細について話し合うことができます
- Valuable(価値がある):ユーザーに価値を提供します
- Estimable(見積もり可能である):規模を見積もることができます
- Small(小さい):スプリント内に収まります
- Testable(テスト可能である):明確な受け入れ基準があります
リソース
コメント
Markdown 対応