mcpField
W
write-user-story

write-user-story

github.com/testomatio開発1664 回インストール6 日前に更新
リポジトリ

write-user-story について

受け取った資料を、受け入れ基準付きの原子的でテスト可能なユーザーストーリーにまとめるスキルです。要件作成者向けで、不明なルールを補わず確認を促します。

主な機能

  1. 01資料から1件以上のストーリーを作成
  2. 02テスト可能な受け入れ基準を要求
  3. 03明確さと原子性を確認
  4. 04前提と未解決の質問を明示
  5. 05後続のレビュー・テストケース用スキルを案内

活用シーン

  1. 01製品要件からストーリーを作成
  2. 02不完全または曖昧なルールを明確化
  3. 03要件レビューに向けてストーリーを準備
  4. 04ストーリーからテストケースを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/testomatio/skills --skill write-user-story

インストール後、Claude Code で/write-user-storyを入力して読み込まれたか確認します。

詳細

ユーザーストーリーの作成

ソース資料をユーザーストーリー(または複数のストーリー)に変換します。各ストーリーの受け入れ基準は要件です。ストーリーが満たす必要のある、テスト可能で、独立したルールです。

データのソースが PR の場合は、qa-pr-requirements-analyzer スキルを使用してください。 ソースが課題管理システムのチケットの場合は、MCP 接続を依頼してください。

ルール

ユーザーストーリーは、少なくとも次の条件を満たす必要があります。

  • 独立している — アクターは 1 つ、能力は 1 つです。
  • 明確である — 曖昧な言葉(「速い」「関連性がある」「ユーザーフレンドリー」「期待どおりに動作する」「必要に応じて」)を使いません。
  • 完全である — アクター、トリガー、結果、ビジネスルールを含み、受け入れ基準では空の状態、エラー、権限に関するパスも扱います。
  • 一貫している — 用語を全体で統一し、矛盾がありません。
  • テスト可能である — 各ストーリーに、合否を測定可能な受け入れ基準があります。

次のルールに従ってください。

  • ユーザーストーリーを記述する際のその他のベストプラクティスに従ってください。
  • 実装方法ではなく、何を実現するかを記述してください。ユーザーから求められていない限り、UI ウィジェット、API の実装詳細、フレームワークは含めません。
  • 前提条件と未解決の質問を明示してください。不足しているルールを黙って作り出してはいけません。推測、想像、仮定はしないでください。不明な点があれば、必ずユーザーに確認してください。

出力

デフォルトでは、要件(説明)と受け入れ基準を出力します。ユーザーが形式を指定した場合は、その形式に合わせてください。(ユーザーから提供されたコンテキストに応じて、その他のセクションを追加します。)

各要件には、少なくとも 1 つの受け入れ基準が必要です。受け入れ基準には短く一意の ID(例:AC-1)を付けてください。(読みやすくするため、ID は行末に置くのがおすすめです。)

次のアクション

  • 抜け漏れとテスト可能性を確認する → qa-requirement-reviewer
  • リスクシナリオを検討する → qa-thinking
  • これらのユーザーストーリーからテストケースを作成する → qa-write-test-cases

コメント