このスキルは、ユーザーがPRDを作成したいときに呼び出されます。必要ないと思われる手順はスキップしても構いません。
-
ユーザーに、解決したい問題の長く詳細な説明と、潜在的な解決策のアイデアを求めます。
-
リポジトリを探索して、ユーザーの主張を検証し、コードベースの現在の状態を理解します。
-
この計画のあらゆる側面について、共通の理解に達するまでユーザーに徹底的にインタビューします。設計ツリーの各ブランチを下り、決定間の依存関係を一つずつ解決します。
-
実装を完了するために構築または変更する必要がある主要なモジュールのスケッチを作成します。積極的に、単独でテストできる深いモジュールを抽出する機会を探します。
深いモジュール(浅いモジュールの対義語)とは、シンプルでテスト可能な、めったに変更されないインターフェースに多くの機能をカプセル化したモジュールのことです。
これらのモジュールがユーザーの期待に合っているか確認します。また、どのモジュールに対してテストを記述してほしいかユーザーに確認します。
- 問題と解決策を完全に理解したら、以下のテンプレートを使用してPRDを作成します。PRDはGitHub Issueとして提出する必要があります。
問題の説明
ユーザーが直面している問題を、ユーザーの視点から説明します。
解決策
問題に対する解決策を、ユーザーの視点から説明します。
ユーザーストーリー
長い番号付きリストのユーザーストーリー。各ユーザーストーリーは以下の形式とします。
- <アクター>として、<機能>を実現したい、<ベネフィット>のため
<ユーザーストーリーの例>
- モバイルバンキングの顧客として、口座の残高を確認したい、支出についてより情報に基づいた判断ができるようにするため </ユーザーストーリーの例>
このユーザーストーリーのリストは非常に網羅的で、機能のあらゆる側面をカバーする必要があります。
実装の決定
行われた実装上の決定のリスト。これには以下が含まれます。
- 構築/変更されるモジュール
- 変更されるモジュールのインターフェース
- 開発者からの技術的な明確化
- アーキテクチャ上の決定
- スキーマの変更
- API契約
- 特定のインタラクション
特定のファイルパスやコードスニペットは含めないでください。すぐに古くなる可能性があります。
テストの決定
行われたテスト上の決定のリスト。以下を含めます。
- 良いテストとは何か(外部の動作のみをテストし、実装の詳細はテストしない)
- どのモジュールをテストするか
- テストに関する先行事例(つまり、コードベース内の類似のテストタイプ)
スコープ外
このPRDのスコープ外となる事項の説明。
その他のメモ
機能に関するその他のメモ。