[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77JEP4V4XNW55VDF0K58HA8":3,"skill-same:01M77JEP4V4XNW55VDF0K58HA8":128},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M77JEP4V4XNW55VDF0K58HA8","user-story-review",null,"現在のブランチと main・master などの統合先との差分、要件定義、実装から、人間が画面で試せるユーザーストーリーの確認用 HTML を生成する。実画面のキャプチャ、確認用ダミーデータの作成スクリプト、そのデータを片付ける手順を揃えたいときに使う。","seiei-sogen\u002Fagent-skills","seiei-sogen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F66318252?v=4","01M77JBBV0RG0YC1XP2EP9GCW9","聖永宗玄 Seiei Sōgen","01M77JBBVNEGW6EPDCJECRQ1G5",0,"MIT","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: user-story-review\ndescription: 現在のブランチと main・master などの統合先との差分、要件定義、実装から、人間が画面で試せるユーザーストーリーの確認用 HTML を生成する。実画面のキャプチャ、確認用ダミーデータの作成スクリプト、そのデータを片付ける手順を揃えたいときに使う。\n---\n\n# User story review\n\n変更された機能を、人間が自分で操作して確かめられる日本語の HTML にする。\n読み手はコードを読まない利用者や動作確認の担当者である。\n操作する画面、使うデータ、期待する表示、確認後の片付けまでを一続きにする。\n\n## 入力と成果物\n\n通常は `$user-story-review` と引数なしで呼び出す。\n作業中のリポジトリと現在のブランチを対象にする。\nユーザーが比較先や確認範囲を指定した場合は、その指定を優先する。\n\n既存の確認資料の保存場所があれば、その規約に合わせる。\nなければリポジトリ直下の `check\u002Fuser-story-review-\u003Cbranch>-\u003CYYYY-MM-DD-HHMMSS>\u002F` に次を作る。\n`branch` はパス区切りや特殊文字を除いた名前にし、既存の成果物を上書きしない。\n\n- `check-story.html`。確認手順、画像、データの準備と削除方法を含む。\n- `screenshots\u002F`。実画面の画像を手順番号と内容が分かる名前で保存する。\n- データ作成と削除のスクリプト。同じスクリプトの明示的なモードで兼ねてもよい。\n- `data-manifest.json`。作成したデータの識別子、対象環境、ストーリーとの対応を記録する。\n\nスクリプトは対象プロジェクトの言語と実行方法に合わせる。\n確認資料の作成を理由に、アプリケーションの実装変更、依存追加、コミット、push、PR 作成を行わない。\n\n## 1. 比較範囲と要件を確定する\n\nリポジトリのルートで次を確認する。\n\n```bash\ngit rev-parse --show-toplevel\ngit status --short --branch\ngit branch --show-current\ngit rev-parse HEAD\ngit symbolic-ref --quiet --short refs\u002Fremotes\u002Forigin\u002FHEAD\ngit for-each-ref --format='%(refname:short)' refs\u002Fheads refs\u002Fremotes\n```\n\n比較先は、ユーザーの指定、リポジトリが定める統合先、`origin\u002FHEAD` の順に探す。\nそれでも決まらなければ、存在する `origin\u002Fmain`、`main`、`origin\u002Fmaster`、`master`、`origin\u002Fdevelop`、`develop` から祖先関係と開発規約を確認して選ぶ。\n候補が一つに絞れない場合だけ、比較先をユーザーに確認する。\nリモート参照はローカルにある時点の情報として扱い、勝手に fetch やブランチの切り替えをしない。\n\n選んだ参照名をシェル変数 `STORY_BASE` に設定し、分岐点から現在の HEAD までを調べる。\n\n```bash\ngit rev-parse \"$STORY_BASE\"\ngit merge-base --all \"$STORY_BASE\" HEAD\ngit diff --name-status \"$STORY_BASE\"...HEAD\ngit diff \"$STORY_BASE\"...HEAD\ngit diff --cached\ngit diff\ngit ls-files --others --exclude-standard\n```\n\n共通祖先がない場合や複数ある場合は、比較範囲を確定するまでストーリーを断定しない。\nステージ済み・未ステージの変更と、関連する未追跡のソースや要件も読む。\n生成物、秘密情報、無関係な未追跡ファイルは読み込まない。\nHEAD の差分と未コミット変更は、別々に記録する。\n\n変更された要件定義、設計書、issue に対応する文書、実装、既存テストを照合する。\n差分から参照される既存の画面、権限、入力制約、状態遷移も必要な範囲で読む。\n文書がなくても、実装とテストから利用者に見える変化を抽出する。\nその場合は「コードから推定」と記す。\n要件と実装が食い違う箇所は、期待結果と現在の挙動を分けて「要確認」にする。\n\nこの段階は、比較先とその SHA、分岐点と HEAD の SHA、未コミット変更の有無、対象となる利用者の操作を説明できれば完了する。\n関連する差分がない場合は、その事実を報告して終了する。\n\n## 2. 人間が試せるストーリーを組む\n\nストーリーごとに `S1`、`S2` のような識別子を付け、次を整理する。\n\n| 項目 | 内容 |\n| --- | --- |\n| 目的 | 誰が、何をしたいか。その結果、何ができるか。 |\n| 根拠 | 対応する要件、変更ファイル、既存テスト。推定なら明示する。 |\n| 開始状態 | 権限、ログイン状態、対象データ、直前の操作。 |\n| 操作 | 開く URL、押すボタン、入力する値を順番に書く。 |\n| 期待結果 | 表示、件数、保存結果など、読み手が確認できる変化。 |\n| 使用データ | ダミーデータのキーと開始状態。 |\n| 依存とやり直し | 先に必要な手順、操作後に変わる状態、戻し方。 |\n\n正常系に加え、変更に関係する入力エラー、権限不足、空の状態、境界値、失敗後の再操作を扱う。\n無関係な組み合わせでストーリーを増やさない。\nすべての利用者に見える変更をいずれかのストーリーに対応させる。\n内部処理だけの差分は、画面確認の対象外にした理由を記録する。\n\n各手順は「操作する」「表示を見る」「何をもって合格とするか」が分かる文章にする。\n画面に表示される名前を使い、関数名や SQL を理解しなくても進められるようにする。\nバッチや API しかない変更では、実行コマンド、入力、期待する出力や管理画面の変化を示す。\n画面のない処理に架空の UI を作らない。\n\n## 3. ダミーデータと片付け方法を先に作る\n\nまず既存の起動手順、factory、fixture、seed、テスト用アカウントを調べる。\nストーリーに必要な最小限のデータを、既存の仕組みで作る。\n状態が変わるストーリーには別々のデータを用意するか、実行順と初期化方法を明記する。\n\n書き込み前に、アプリの実行環境と実際の DB・API 接続先を確認する。\nローカルの使い捨て環境か、この確認専用の開発・テスト環境を使う。\n共有環境への書き込みが必要で、既存の依頼から許可を確認できない場合は、スクリプトと対象を準備した後、実行前に確認する。\n本番環境には確認用データを書き込まない。\n通知、メール、決済、外部ジョブはテスト用の仕組みに切り替え、実利用者への副作用を防ぐ。\n変更された機能の処理は実装を通し、外部への副作用だけを置き換える。\n外部 API を stub した部分は、確認した範囲として HTML に明示する。\n\n作成スクリプトと manifest は次を満たす。\n\n- 実行ごとの `run_id` を使い、ストーリーのデータキーと作成済みの ID を対応させる。\n- manifest に対象環境、DB などの接続先の識別情報、作成した親子データ、再実行方法を記録する。認証情報は保存しない。\n- 同じ run の再実行では、所有を確認できたデータだけを初期状態に戻す。既存データとの衝突時は停止する。\n- DB を使う場合はトランザクション内で manifest を保存し、保存失敗時は作成をロールバックする。ファイルや外部のテスト用リソースは作成直後に記録し、途中失敗時の回収方法も用意する。\n- 借用した既存アカウントや参照データは作成物と区別し、変更・削除しない。\n\n片付けは、準備したデータだけを対象にする。\n削除前に対象と件数を表示する dry-run を用意する。\n実行時も環境と manifest の一致を確認し、記録された ID と所有情報を照合する。\nmanifest がない、環境が違う、所有を確認できない場合は削除を停止する。\n名前の前方一致だけによる一括削除、全件削除、DB の初期化を片付けに使わない。\n\n画面操作で値や状態が変わっても、作成時の ID を使って片付けられるようにする。\n操作で追加される履歴、関連レコード、ファイルも追跡し、外部キーとコールバックに合う順序で片付ける。\n今回作成したデータは削除する。プロジェクトの規約上、物理削除できない作成物は、非公開化などの処置と残るデータを明記する。\n繰り返し実行しても、片付け済みの対象を理由に他のデータへ範囲を広げない。\n\nHTML に、作業ディレクトリ、作成・初期化・dry-run・削除の正確なコマンドを載せる。\nデータ一覧には、データキー、表示名、開始状態、開く URL、対応ストーリーを載せる。\n\n## 4. 実際に操作してキャプチャを撮る\n\n既存の検証手順に沿ってアプリを起動し、対象 worktree のコードが動いていることを確認する。\nこの段階で行うデータの作成と片付けは、HTML に載せるコマンドをそのまま fish で実行する（`fish -c '\u003Cコマンド>'`）。\nデータ作成を同じ run で二度行い、件数が増えず、ストーリーの開始状態に戻ることを確かめる。\nブラウザ操作には、利用可能な `agent-browser`、Playwright などを使い、そのツールの手順に従う。\nブラウザ操作が必要なら、説明だけで終えず、各ストーリーを実際に流す。\n\n開始画面、主要な操作後、変更に関係するエラー表示を撮影する。\nスクロール、待機、通知の表示時間を調整し、入力値と結果を読み取れる画像にする。\n各画像に、ストーリー・手順番号、確認してほしい箇所、撮影時の状態を対応させる。\n機密情報が写り込む場合はテスト用の値に置き換えて撮り直すか、画像をマスクし、その処置を記す。\n\nキャプチャは対象アプリの実画面から取得する。\n参考資料の画像の流用や、画像生成による成功画面の代用をしない。\n画面のない処理では、実行ログと観測した結果を証拠にする。\n起動、認証、必要な接続先の不足で確認できない項目には「未実施」と理由を記す。\n未撮影の画像枠や、未実施の操作を成功したように書かない。\n\n片付けは独立した使い捨てのデータで、dry-run、削除、もう一度削除の順に実行する。\ndry-run と実際の対象が一致し、二度目は片付け済みとなり、対象外のデータが残ることを確認する。\n対象外のデータがない環境では、別 run のテスト用データを用意して削除範囲を確かめ、そのデータも検証後に片付ける。\n借用したデータがあれば、残っていることも確認する。\n最後に人間が試すデータを開始状態へ戻し、最新の ID と URL を manifest と HTML に反映する。\n人間の確認前に、そのデータを片付けない。\n\n## 5. HTML を生成する\n\nHTML は、準備から操作、やり直し、片付けまでを上から順に読める構成にする。\n次の情報を含める。\n\n1. 確認する機能と、操作すると何ができるか。\n2. 現在のブランチ、比較先とその SHA、分岐点と HEAD の SHA、作成日時、未コミット変更、確認環境。\n3. 起動・ログインの前提と、ダミーデータの作成方法・一覧。\n4. 各ストーリーの開始状態、番号付きの操作、期待結果、対応キャプチャ、合否の記入欄。\n5. ストーリー間の依存、やり直す方法、削除の dry-run と実行方法、残るデータ。\n6. エージェントが実施した確認と結果、未実施・要確認の項目、根拠ファイル。\n\n期待結果と実際に観測した結果を分ける。\n人間の合否記入欄は空欄で渡し、エージェントの確認結果を代わりに記入しない。\n要件が明示された結果と、コードから推定した結果も区別する。\n\nCSS と画像は HTML に埋め込み、単体で開けるようにする。\n画像ファイルも `screenshots\u002F` に残し、撮影元を確認できるようにする。\n外部 CDN、フォント、アプリへの接続がなくても本文と画像を読めるようにする。\n見出しと目次で移動でき、画像には説明文と代替テキストを付ける。\n横幅に応じて画像を縮め、文字と背景のコントラストを確保し、印刷時も手順と画像を読めるようにする。\nコード、入力値、動的な表示名は HTML エスケープする。\nHTML に載せるコマンドは、人間が fish shell で実行する前提で書き、コードブロックの言語を `fish` にする。\n実運用の認証情報や個人情報を HTML に含めない。\n\n構成を確認したい場合は [参考 HTML](sanko\u002Fcheck-story-issue45412-2026-10-09.html) と [その元文書](sanko\u002Fcheck-story-issue45412-2026-10-09.adoc) を読む。\n参考 HTML には画像の base64 があるので、構造を調べるときは画像データを出力しない。\n参考資料のアプリ名、URL、認証情報、DB 名、固定 ID、データを残す片付け方式は、今回の対象に引き継がない。\n\n## 6. 成果物を検証して渡す\n\n確認中に対象コードが変わっていないか、HEAD と関連する未コミット変更を再確認する。\n変わっていた場合は、影響するストーリーを確認し直し、キャプチャと比較情報を更新する。\n生成した HTML をブラウザで開き、画像、目次、コマンド、ストーリーの順序を確認する。\nHTML だけを別の場所にコピーして開き、本文と画像が欠けないことも確認する。\n相対リンクで渡すスクリプトは、必要な成果物一式と一緒に渡す方法を載せる。\n単体 HTML に載せるコマンドにも、スクリプトの所在と実行する作業ディレクトリを明記する。\nHTML に載せたコマンドをすべて `fish --no-execute -c '\u003Cコマンド>'` に通し、構文エラーがないことを確認する。\n\n完了には、次が揃っていることを確認する。\n\n- 利用者に見える変更がストーリーに対応し、実際の表示で合否を判断できる。\n- 必要な実画面キャプチャが本文に対応し、人間が使うデータが開始状態にある。\n- 作成と片付けのスクリプトが HTML のコマンドのまま fish で実行でき、削除範囲と残るデータが分かる。\n- manifest、画面のリンク、実際のデータが一致している。\n- HTML を単体で開いて読める。\n\n満たせない項目があれば、HTML 冒頭に「草案」と不足内容を示し、完了したと報告しない。\n最終回答には HTML とスクリプトのパス、対象ブランチと比較先、実施結果、人間が最初に行う操作、未実施の理由を簡潔に書く。\n","# User story review\n\n変更された機能を、人間が自分で操作して確かめられる日本語の HTML にする。\n読み手はコードを読まない利用者や動作確認の担当者である。\n操作する画面、使うデータ、期待する表示、確認後の片付けまでを一続きにする。\n\n## 入力と成果物\n\n通常は `$user-story-review` と引数なしで呼び出す。\n作業中のリポジトリと現在のブランチを対象にする。\nユーザーが比較先や確認範囲を指定した場合は、その指定を優先する。\n\n既存の確認資料の保存場所があれば、その規約に合わせる。\nなければリポジトリ直下の `check\u002Fuser-story-review-\u003Cbranch>-\u003CYYYY-MM-DD-HHMMSS>\u002F` に次を作る。\n`branch` はパス区切りや特殊文字を除いた名前にし、既存の成果物を上書きしない。\n\n- `check-story.html`。確認手順、画像、データの準備と削除方法を含む。\n- `screenshots\u002F`。実画面の画像を手順番号と内容が分かる名前で保存する。\n- データ作成と削除のスクリプト。同じスクリプトの明示的なモードで兼ねてもよい。\n- `data-manifest.json`。作成したデータの識別子、対象環境、ストーリーとの対応を記録する。\n\nスクリプトは対象プロジェクトの言語と実行方法に合わせる。\n確認資料の作成を理由に、アプリケーションの実装変更、依存追加、コミット、push、PR 作成を行わない。\n\n## 1. 比較範囲と要件を確定する\n\nリポジトリのルートで次を確認する。\n\n```bash\ngit rev-parse --show-toplevel\ngit status --short --branch\ngit branch --show-current\ngit rev-parse HEAD\ngit symbolic-ref --quiet --short refs\u002Fremotes\u002Forigin\u002FHEAD\ngit for-each-ref --format='%(refname:short)' refs\u002Fheads refs\u002Fremotes\n```\n\n比較先は、ユーザーの指定、リポジトリが定める統合先、`origin\u002FHEAD` の順に探す。\nそれでも決まらなければ、存在する `origin\u002Fmain`、`main`、`origin\u002Fmaster`、`master`、`origin\u002Fdevelop`、`develop` から祖先関係と開発規約を確認して選ぶ。\n候補が一つに絞れない場合だけ、比較先をユーザーに確認する。\nリモート参照はローカルにある時点の情報として扱い、勝手に fetch やブランチの切り替えをしない。\n\n選んだ参照名をシェル変数 `STORY_BASE` に設定し、分岐点から現在の HEAD までを調べる。\n\n```bash\ngit rev-parse \"$STORY_BASE\"\ngit merge-base --all \"$STORY_BASE\" HEAD\ngit diff --name-status \"$STORY_BASE\"...HEAD\ngit diff \"$STORY_BASE\"...HEAD\ngit diff --cached\ngit diff\ngit ls-files --others --exclude-standard\n```\n\n共通祖先がない場合や複数ある場合は、比較範囲を確定するまでストーリーを断定しない。\nステージ済み・未ステージの変更と、関連する未追跡のソースや要件も読む。\n生成物、秘密情報、無関係な未追跡ファイルは読み込まない。\nHEAD の差分と未コミット変更は、別々に記録する。\n\n変更された要件定義、設計書、issue に対応する文書、実装、既存テストを照合する。\n差分から参照される既存の画面、権限、入力制約、状態遷移も必要な範囲で読む。\n文書がなくても、実装とテストから利用者に見える変化を抽出する。\nその場合は「コードから推定」と記す。\n要件と実装が食い違う箇所は、期待結果と現在の挙動を分けて「要確認」にする。\n\nこの段階は、比較先とその SHA、分岐点と HEAD の SHA、未コミット変更の有無、対象となる利用者の操作を説明できれば完了する。\n関連する差分がない場合は、その事実を報告して終了する。\n\n## 2. 人間が試せるストーリーを組む\n\nストーリーごとに `S1`、`S2` のような識別子を付け、次を整理する。\n\n| 項目 | 内容 |\n| --- | --- |\n| 目的 | 誰が、何をしたいか。その結果、何ができるか。 |\n| 根拠 | 対応する要件、変更ファイル、既存テスト。推定なら明示する。 |\n| 開始状態 | 権限、ログイン状態、対象データ、直前の操作。 |\n| 操作 | 開く URL、押すボタン、入力する値を順番に書く。 |\n| 期待結果 | 表示、件数、保存結果など、読み手が確認できる変化。 |\n| 使用データ | ダミーデータのキーと開始状態。 |\n| 依存とやり直し | 先に必要な手順、操作後に変わる状態、戻し方。 |\n\n正常系に加え、変更に関係する入力エラー、権限不足、空の状態、境界値、失敗後の再操作を扱う。\n無関係な組み合わせでストーリーを増やさない。\nすべての利用者に見える変更をいずれかのストーリーに対応させる。\n内部処理だけの差分は、画面確認の対象外にした理由を記録する。\n\n各手順は「操作する」「表示を見る」「何をもって合格とするか」が分かる文章にする。\n画面に表示される名前を使い、関数名や SQL を理解しなくても進められるようにする。\nバッチや API しかない変更では、実行コマンド、入力、期待する出力や管理画面の変化を示す。\n画面のない処理に架空の UI を作らない。\n\n## 3. ダミーデータと片付け方法を先に作る\n\nまず既存の起動手順、factory、fixture、seed、テスト用アカウントを調べる。\nストーリーに必要な最小限のデータを、既存の仕組みで作る。\n状態が変わるストーリーには別々のデータを用意するか、実行順と初期化方法を明記する。\n\n書き込み前に、アプリの実行環境と実際の DB・API 接続先を確認する。\nローカルの使い捨て環境か、この確認専用の開発・テスト環境を使う。\n共有環境への書き込みが必要で、既存の依頼から許可を確認できない場合は、スクリプトと対象を準備した後、実行前に確認する。\n本番環境には確認用データを書き込まない。\n通知、メール、決済、外部ジョブはテスト用の仕組みに切り替え、実利用者への副作用を防ぐ。\n変更された機能の処理は実装を通し、外部への副作用だけを置き換える。\n外部 API を stub した部分は、確認した範囲として HTML に明示する。\n\n作成スクリプトと manifest は次を満たす。\n\n- 実行ごとの `run_id` を使い、ストーリーのデータキーと作成済みの ID を対応させる。\n- manifest に対象環境、DB などの接続先の識別情報、作成した親子データ、再実行方法を記録する。認証情報は保存しない。\n- 同じ run の再実行では、所有を確認できたデータだけを初期状態に戻す。既存データとの衝突時は停止する。\n- DB を使う場合はトランザクション内で manifest を保存し、保存失敗時は作成をロールバックする。ファイルや外部のテスト用リソースは作成直後に記録し、途中失敗時の回収方法も用意する。\n- 借用した既存アカウントや参照データは作成物と区別し、変更・削除しない。\n\n片付けは、準備したデータだけを対象にする。\n削除前に対象と件数を表示する dry-run を用意する。\n実行時も環境と manifest の一致を確認し、記録された ID と所有情報を照合する。\nmanifest がない、環境が違う、所有を確認できない場合は削除を停止する。\n名前の前方一致だけによる一括削除、全件削除、DB の初期化を片付けに使わない。\n\n画面操作で値や状態が変わっても、作成時の ID を使って片付けられるようにする。\n操作で追加される履歴、関連レコード、ファイルも追跡し、外部キーとコールバックに合う順序で片付ける。\n今回作成したデータは削除する。プロジェクトの規約上、物理削除できない作成物は、非公開化などの処置と残るデータを明記する。\n繰り返し実行しても、片付け済みの対象を理由に他のデータへ範囲を広げない。\n\nHTML に、作業ディレクトリ、作成・初期化・dry-run・削除の正確なコマンドを載せる。\nデータ一覧には、データキー、表示名、開始状態、開く URL、対応ストーリーを載せる。\n\n## 4. 実際に操作してキャプチャを撮る\n\n既存の検証手順に沿ってアプリを起動し、対象 worktree のコードが動いていることを確認する。\nこの段階で行うデータの作成と片付けは、HTML に載せるコマンドをそのまま fish で実行する（`fish -c '\u003Cコマンド>'`）。\nデータ作成を同じ run で二度行い、件数が増えず、ストーリーの開始状態に戻ることを確かめる。\nブラウザ操作には、利用可能な `agent-browser`、Playwright などを使い、そのツールの手順に従う。\nブラウザ操作が必要なら、説明だけで終えず、各ストーリーを実際に流す。\n\n開始画面、主要な操作後、変更に関係するエラー表示を撮影する。\nスクロール、待機、通知の表示時間を調整し、入力値と結果を読み取れる画像にする。\n各画像に、ストーリー・手順番号、確認してほしい箇所、撮影時の状態を対応させる。\n機密情報が写り込む場合はテスト用の値に置き換えて撮り直すか、画像をマスクし、その処置を記す。\n\nキャプチャは対象アプリの実画面から取得する。\n参考資料の画像の流用や、画像生成による成功画面の代用をしない。\n画面のない処理では、実行ログと観測した結果を証拠にする。\n起動、認証、必要な接続先の不足で確認できない項目には「未実施」と理由を記す。\n未撮影の画像枠や、未実施の操作を成功したように書かない。\n\n片付けは独立した使い捨てのデータで、dry-run、削除、もう一度削除の順に実行する。\ndry-run と実際の対象が一致し、二度目は片付け済みとなり、対象外のデータが残ることを確認する。\n対象外のデータがない環境では、別 run のテスト用データを用意して削除範囲を確かめ、そのデータも検証後に片付ける。\n借用したデータがあれば、残っていることも確認する。\n最後に人間が試すデータを開始状態へ戻し、最新の ID と URL を manifest と HTML に反映する。\n人間の確認前に、そのデータを片付けない。\n\n## 5. HTML を生成する\n\nHTML は、準備から操作、やり直し、片付けまでを上から順に読める構成にする。\n次の情報を含める。\n\n1. 確認する機能と、操作すると何ができるか。\n2. 現在のブランチ、比較先とその SHA、分岐点と HEAD の SHA、作成日時、未コミット変更、確認環境。\n3. 起動・ログインの前提と、ダミーデータの作成方法・一覧。\n4. 各ストーリーの開始状態、番号付きの操作、期待結果、対応キャプチャ、合否の記入欄。\n5. ストーリー間の依存、やり直す方法、削除の dry-run と実行方法、残るデータ。\n6. エージェントが実施した確認と結果、未実施・要確認の項目、根拠ファイル。\n\n期待結果と実際に観測した結果を分ける。\n人間の合否記入欄は空欄で渡し、エージェントの確認結果を代わりに記入しない。\n要件が明示された結果と、コードから推定した結果も区別する。\n\nCSS と画像は HTML に埋め込み、単体で開けるようにする。\n画像ファイルも `screenshots\u002F` に残し、撮影元を確認できるようにする。\n外部 CDN、フォント、アプリへの接続がなくても本文と画像を読めるようにする。\n見出しと目次で移動でき、画像には説明文と代替テキストを付ける。\n横幅に応じて画像を縮め、文字と背景のコントラストを確保し、印刷時も手順と画像を読めるようにする。\nコード、入力値、動的な表示名は HTML エスケープする。\nHTML に載せるコマンドは、人間が fish shell で実行する前提で書き、コードブロックの言語を `fish` にする。\n実運用の認証情報や個人情報を HTML に含めない。\n\n構成を確認したい場合は [参考 HTML](sanko\u002Fcheck-story-issue45412-2026-10-09.html) と [その元文書](sanko\u002Fcheck-story-issue45412-2026-10-09.adoc) を読む。\n参考 HTML には画像の base64 があるので、構造を調べるときは画像データを出力しない。\n参考資料のアプリ名、URL、認証情報、DB 名、固定 ID、データを残す片付け方式は、今回の対象に引き継がない。\n\n## 6. 成果物を検証して渡す\n\n確認中に対象コードが変わっていないか、HEAD と関連する未コミット変更を再確認する。\n変わっていた場合は、影響するストーリーを確認し直し、キャプチャと比較情報を更新する。\n生成した HTML をブラウザで開き、画像、目次、コマンド、ストーリーの順序を確認する。\nHTML だけを別の場所にコピーして開き、本文と画像が欠けないことも確認する。\n相対リンクで渡すスクリプトは、必要な成果物一式と一緒に渡す方法を載せる。\n単体 HTML に載せるコマンドにも、スクリプトの所在と実行する作業ディレクトリを明記する。\nHTML に載せたコマンドをすべて `fish --no-execute -c '\u003Cコマンド>'` に通し、構文エラーがないことを確認する。\n\n完了には、次が揃っていることを確認する。\n\n- 利用者に見える変更がストーリーに対応し、実際の表示で合否を判断できる。\n- 必要な実画面キャプチャが本文に対応し、人間が使うデータが開始状態にある。\n- 作成と片付けのスクリプトが HTML のコマンドのまま fish で実行でき、削除範囲と残るデータが分かる。\n- manifest、画面のリンク、実際のデータが一致している。\n- HTML を単体で開いて読める。\n\n満たせない項目があれば、HTML 冒頭に「草案」と不足内容を示し、完了したと報告しない。\n最終回答には HTML とスクリプトのパス、対象ブランチと比較先、実施結果、人間が最初に行う操作、未実施の理由を簡潔に書く。\n",{"name":5,"description":7},"main","167c6691adf7e788205650c1a62c10567e69a75f","skills\u002Fcode-review\u002Fuser-story-review","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills","https:\u002F\u002Fgithub.com\u002Fseiei-sogen","https:\u002F\u002Fseiei-sogen.github.io","Software Developer\u002FEngineer.","2026-11-12 12:51:47",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add seiei-sogen\u002Fagent-skills --skill user-story-review",{"tool":38,"command":39},"bunx","bunx skills add seiei-sogen\u002Fagent-skills --skill user-story-review",{"tool":41,"command":42},"pnpm","pnpm dlx skills add seiei-sogen\u002Fagent-skills --skill user-story-review","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002FSKILL.md",true,[46,52,56,62,66,70,74,78,82,86,90,94,98,102,106,110,114,118,122],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"sanko\u002Fcheck-story-issue45412-2026-10-09.adoc","REFERENCE","参考文档",12642,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fcheck-story-issue45412-2026-10-09.adoc",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"sanko\u002Fcheck-story-issue45412-2026-10-09.html",2072319,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fcheck-story-issue45412-2026-10-09.html",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"sanko\u002Fscreenshots\u002F01-index.png","ASSET","资产文件",146405,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F01-index.png",{"path":63,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":64,"sourceHtmlUrl":65},"sanko\u002Fscreenshots\u002F02-k7-failed.png",115128,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F02-k7-failed.png",{"path":67,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":68,"sourceHtmlUrl":69},"sanko\u002Fscreenshots\u002F03-k1-multiple-matches.png",220813,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F03-k1-multiple-matches.png",{"path":71,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":72,"sourceHtmlUrl":73},"sanko\u002Fscreenshots\u002F04-k1-not-fetched.png",154121,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F04-k1-not-fetched.png",{"path":75,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":76,"sourceHtmlUrl":77},"sanko\u002Fscreenshots\u002F05-index-after-k1-relink.png",135302,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F05-index-after-k1-relink.png",{"path":79,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":80,"sourceHtmlUrl":81},"sanko\u002Fscreenshots\u002F06-k1-after-relink.png",145552,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F06-k1-after-relink.png",{"path":83,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":84,"sourceHtmlUrl":85},"sanko\u002Fscreenshots\u002F07-k5-referenced.png",131290,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F07-k5-referenced.png",{"path":87,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":88,"sourceHtmlUrl":89},"sanko\u002Fscreenshots\u002F08-index-after-k4-dismiss.png",125733,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F08-index-after-k4-dismiss.png",{"path":91,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":92,"sourceHtmlUrl":93},"sanko\u002Fscreenshots\u002F09-k4-after-dismiss.png",112029,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F09-k4-after-dismiss.png",{"path":95,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":96,"sourceHtmlUrl":97},"sanko\u002Fscreenshots\u002F10-k2-input-invalid-host.png",118739,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F10-k2-input-invalid-host.png",{"path":99,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":100,"sourceHtmlUrl":101},"sanko\u002Fscreenshots\u002F11-k2-input-fetch-failed.png",117090,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F11-k2-input-fetch-failed.png",{"path":103,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":104,"sourceHtmlUrl":105},"sanko\u002Fscreenshots\u002F12-index-after-k2-input-relink.png",114093,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F12-index-after-k2-input-relink.png",{"path":107,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":108,"sourceHtmlUrl":109},"sanko\u002Fscreenshots\u002F13-k2-after-input-relink.png",113127,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F13-k2-after-input-relink.png",{"path":111,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":112,"sourceHtmlUrl":113},"sanko\u002Fscreenshots\u002F14-k2-restaurant-google-map-link.png",109988,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F14-k2-restaurant-google-map-link.png",{"path":115,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":116,"sourceHtmlUrl":117},"sanko\u002Fscreenshots\u002F15-k7-after-batch-run.png",115429,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F15-k7-after-batch-run.png",{"path":119,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":120,"sourceHtmlUrl":121},"sanko\u002Fscreenshots\u002F16-index-after-batch-run.png",112568,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fscreenshots\u002F16-index-after-batch-run.png",{"path":123,"resourceType":124,"resourceTypeDesc":125,"sizeBytes":126,"sourceHtmlUrl":127},"sanko\u002Fseed-check-data.rb","SCRIPT","脚本",8135,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcode-review\u002Fuser-story-review\u002Fsanko\u002Fseed-check-data.rb",[129,136,143,150,157,164],{"skillNo":130,"name":131,"nameZh":6,"description":132,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":19},"01M77JQCQ91W9AK2G7HCAT8TEW","why","「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ（ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス）を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":140,"categories":141,"keywords":142,"publishedAt":19},"01M77JQATY44K4PJ5X1ZK7DGAH","what-did-i-get-done","ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fwhat-did-i-get-done\u002FSKILL.md",[],[],{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":149,"publishedAt":19},"01M77JQ8KDCH24TVAF36J7DKXS","unslop","あらゆる文章から AI の痕跡を削る。常に適用しなければならない。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":156,"publishedAt":19},"01M77JQ79R7RB2GNA5EMK7J7T9","typescript-best-practices","TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Ftypescript-best-practices\u002FSKILL.md",[],[],{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":161,"categories":162,"keywords":163,"publishedAt":19},"01M77JQ5CF7TS7Y91V0TXFJC2P","thermo-nuclear-code-quality-review","抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fthermo-nuclear-code-quality-review\u002FSKILL.md",[],[],{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":170,"publishedAt":19},"01M77JQ1XESSFX1D7TBNQE3CCE","technical-writing","階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。\u002Ftechnical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Ftechnical-writing\u002FSKILL.md",[],[]]