epic-requirements-specification について
epic-requirements-specificationは、一問ずつ進める手順で、ビジネスレベルのEpic要件を聞き取り、草案を作成するスキルです。発見、草案承認、承認後のファイル保存を分け、明示的な承認前には自動処理を開始しません。
主な機能
- 01焦点を絞った質問を一度に一つ提示
- 02ビジネス範囲と関係者の聞き取り
- 03草案レビューと明示的な承認ゲート
- 04承認済み仕様をMarkdownで保存
- 05自動同期せず次の操作を提示
活用シーン
- 01情報が不足したEpic依頼の明確化
- 02Epic仕様草案のレビューと承認
- 03承認済みEpicを保存して次の手順を選択
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ testomatio/ skills --skill epic-requirements-specificationインストール後、Claude Code で/epic-requirements-specificationを入力して読み込まれたか確認します。
詳細
フェーズ 1:対話による情報収集
-
質問は一度に1つ: 情報収集の段階から先に進んではいけません。ユーザーの入力を分析し、バックグラウンドで構成に当てはめ、不足している点や曖昧な点を埋めるため、焦点を絞った質問を一度に1つだけしてください。
-
ツールの使用は厳禁: このフェーズでは、MCP トラッキングツールを呼び出したり、Jira チケットを作成したり、ワークスペースに Markdown ファイルを書き込んだりしてはいけません。
-
最小限の入力への対応: ユーザーの入力が極端に短い、または曖昧な場合(例:「create blue cup」)、インタビューが完了したと判断してはいけません。代わりに、ビジネス上の背景について、最初の確認質問をするきっかけとして扱ってください。
-
順を追って進行: 次のトピックに進む前に、現在の質問に対するユーザーの明確な回答を待ってください。ビジネス上の事実を捏造してはいけません。ユーザーが項目への回答を見送る場合は、
[Assumption]または[Open Question]を使用してください。 -
エピックの範囲: 質問はすべて、ビジネスおよび機能のレベルにとどめてください。技術的な実装の詳細、API、データベーススキーマ、UI のルールについて質問してはいけません。
フェーズ 2:ドラフトの確認と承認ゲート
-
ドラフトの提示: すべての主要セクションが網羅された場合、またはユーザーから明示的にドラフトの提示を求められた場合に限り、確認用としてエピック仕様書の全文をチャット内に出力してください。
-
実行のトリガー: ユーザーがテキストのドラフトを明示的に確認し、正確に APPROVED と入力した場合に限り、フェーズ 3 に進み、自動化ツールを実行することが許可されます。修正を求められた場合は、テキストのドラフトを更新し、再度承認を求めてください。
フェーズ 3:承認後の実行
-
ファイルへの保存: 承認されたら、確定したテキストをワークスペース内の Markdown ファイル(
epic-<slug>.mdまたはproject-<slug>.md)に書き込んでください。 -
次のアクションの提示: トラッキングシステムに自動同期してはいけません。代わりに、保存したファイルパスを伝え、続けてユーザーに次に実行したい手順を明示的に確認する「次のアクション」セクションを末尾に提示してください。
出力仕様
このやり取りの最後に生成するドキュメントでは、次の Markdown 構造を使用してください。
1. ビジネスの背景
- ビジネス上の課題:
- ビジネス目標:
- ビジネス価値:
- 成功基準/KPI:
2. スコープとステークホルダー
- 対象ユーザー/アクター:
- 最終受益者:
- 対象範囲:
- 対象範囲外:
3. 制約とリスク
- 依存関係:
- 制約:
- 重大なリスク:
- 前提条件:
- 未解決の質問:
4. アナリストの所見
対話の中で意味のある不足、矛盾、またはリスクが特定された場合に限り記載してください。
対話モデル
- フェーズ 1(情報収集): ユーザーの直近のメッセージから把握した内容を述べ、次の質問を1つだけ提示してください。まだ Markdown ドキュメントの構造やコードブロックは出力しないでください。
- フェーズ 2(確認): 完全なテキストのドラフトをチャット内に提示し、ユーザーに明示的に確認を求めてください。
- フェーズ 3(実行): 保存したファイルパスを報告し、末尾に「次のアクション」の選択肢を提示してください。次のように尋ねてください。「エピックをファイルに保存しました。次に何をしますか?」
- 1. このエピックをトラッキングシステム(MCP)に同期する
- 2.
write-user-storyスキルを使って、承認済みのこのエピックを最初のユーザーストーリーに分解する