om-mockup-prototype

発見プロトタイプ

プロダクトブリーフから選択したフローを、人が操作できるニュートラルな画面に変換します。成果物は、シミュレーションデータ、コンテキスト記録、ブラウザーでのエビデンスを含む、自己完結したローカル HTML です。詳細なビジュアルデザインに進む前に、手順、ラベル、選択肢、復旧経路を検証します。デザインシステムの有無にかかわらず利用できます。

発見の引き継ぎでは、このステップは最初の om-synthetic-users パネルの後に続きます。その後、ユーザーは別のパネルとプロトタイプを確認してから、om-discover --refresh で所見を反映し、om-backlog に進む準備ができているかを確認できます。直接実行する場合は、パネルレポートなしでブリーフを使用できます。

ブリーフに記載されたビジネスルール、対象外事項、スコープ、担当者が決定する事項をそのまま維持してください。不足している事実や提案するフローの変更には、必ず「仮定」と明記してください。合成ユーザーの提案を、承認済みの要件として扱わないでください。プロトタイプやその承認は、ユーザー需要を証明するものでも、「Ready の定義」を満たすものでもありません。選択したプロトタイプのリビジョンには、新しいファイルのみを作成してください。アプリケーションコード、ブリーフ、`.uxproof/` は変更せず、以前のリビジョンと手作業による変更を保持してください。

引数

• {brief}（任意）：リポジトリからの相対パスで指定するプロダクトブリーフのパス。デフォルトは ${SPECS_DIR}/product-brief.md です。
• --flow <name-or-id>（任意）：シミュレーションするキーとなるフロー。現在の会話ですでに選択されているフローを使用します。選択されていない場合は、ブリーフからフローを提案し、確認してください。
• --panel-report <path>（任意）：最初の合成ユーザーパネルのレポートを、リポジトリからの相対パスで指定します。指定がない場合は、現在の発見の引き継ぎで返されたレポートを使用してください。どちらも利用できない場合は、レポートなしで進め、その旨を伝えてください。
• --slug <slug>（任意）：フローから提案する、小文字のケバブケース形式の出力名。設定についての質問はしません。
• --refresh <revision-dir>（任意）：このスキルの以前の出力を見直し、次の新しいリビジョンを書き出します。スラッグは維持し、以前のリビジョンへのリンクを追加してください。既存のファイルは置き換えないでください。

ワークフロー

必ず最初に確認してください： .ai/skills/om-mockup-prototype/SKILL.md がある場合は適用してください。ただし、安全ルールは常に優先されます。

0. コンテキストと安全ルールを読み込みます。 毎回 references/agentic-setup.md に従い、references/rules.md を読んでください。任意の設定と安全なローカルパスを解決し、リポジトリの指示と許可された上書きを適用して、利用可能な場合は設定されたブラウザ記述子を読み込みます。設定が見つからない場合、デリバリーのセットアップは開始しません。

1. フローを選び、その制約を維持します。 ブリーフの主要なフロー、プロダクト、スコープ、ビジネスルール、対象外事項、決定事項、ドメイン用語集、および関連する未解決の質問を確認してください。任意のパネルレポートは、合成された仮説として読みます。ソースパス、関連する安定したルール／決定 ID とそのステータス、未解決事項を記録してください。ブリーフまたは利用可能なフローがない場合は、不足している入力を正確に示して停止します。--refresh の場合は、新しいリビジョンの作成に着手する前に、以前のコンテキストと所有権の記録を確認してください（references/prototype-format.md）。

2. シミュレーションの範囲を確認します。 アクター、開始地点、成功時の結果、画面／状態の一覧、維持されるルール、およびインタラクションに必要となる前提を提示してください。コンテキストから得られない情報と、未解決のプロダクト上の選択についてのみ質問してください。その正確なスコープについて既存の明示的な許可がある場合は、それを適用します。ルールが矛盾する場合は、ブリーフで定められた変更手順を通じて人間に判断を求めてください。プロトタイプのコード内で解決してはいけません。確認によって承認されるのは、シミュレーションと明示された前提であり、その前提が真実であることではありません。

3. クリック可能なリビジョンを作成します。 references/prototype-format.md に従い、新しいリビジョン用ディレクトリを作成して、コンテキスト記録を記述し、静的な HTML、CSS、および簡潔なローカルイベントハンドラーを構築してください。中立的なワイヤーフレーム、アクセシブルなコントロール、シミュレーション用データを使用します。選択したユーザーフロー、関連するエッジ状態、戻るナビゲーション、リセットを実装し、対象外の遷移先は実態に即して表現してください。前提はコンテキストファイルに記録し、パネルの結論や想定される反応をシミュレーション画面に含めないでください。

4. 成果物を検証します。 references/quality-gate.md に従って、スコープ、オフラインでの動作、必須のインタラクションを確認し、ブラウザープロバイダーの名前付きオペレーションを使ってローカル HTML を操作してください。実際の証拠を取得してセッションを終了し、新しいリビジョン内で失敗したインタラクションを修正して、影響を受ける状態を再確認します。ブラウザーを開けない場合であっても、未解決の静的な不具合があれば Verification: incomplete とします。静的レビューに合格してもブラウザーにアクセスできない場合は、Verification: not-run と記録してください。ブラウザー上での操作を確認したと主張してはいけません。ブラウザーでの確認に失敗した場合や一部のみ確認できた場合も incomplete とします。

5. 結果を記録して報告します。 ファイル一覧、コンテキストのソース、以前のリビジョン、検証結果を含めて prototype.json を完成させてください。成果物、制限事項、正確な Output contract の行を添えて、references/report-templates.md に従って報告します。呼び出し元からディスカバリーの引き継ぎがある場合は、その引き継ぎ元に戻ります。このスキルでは、パネルの呼び出し、ブリーフの更新、バックログへの登録、実装の開始は行いません。直接のユーザーは、後で実行する特定の呼び出しを選択し、実行せずに Next: に記録できます。

出力契約

成果物を書き出した場合は、次の装飾のない行を末尾に記載してください。

Prototype: <repo-relative path to revision/index.html>
Prototype context: <repo-relative path to revision/README.md>
Verification: passed | incomplete | not-run
Next: none | om-<skill> <exact user-approved arguments>

利用側は ^Prototype: (\S+)$、^Prototype context: (\S+)$、 ^Verification: (passed|incomplete|not-run)$、および ^Next: (none|om-[a-z-]+.*)$ を解析します。最後の Next: 行は 1 行のみ出力してください。明示的に選択され、まだ実行されていないアクションを示します。それ以外の場合は Next: none を出力してください。ファイルを書き出していない場合は、成果物のパスを出力しないでください。辞退されたフォローアップや完了済みの操作は Next: ではなく本文に記載してください。

ルール

• 対話のみです。人による判断が欠けている場合は停止します。自律モードや、暗黙の業務方針の選択は認められません。
• 既存の UI 言語とブリーフの用語を使用します。中立的なスタイルであっても、アクセシビリティ、意味、役立つ復旧案内を損なってはなりません。
• .uxproof/ は読み取り専用のコンテキストです。このスキルでは、ブランド、ムードボード、トークン、デザイン契約、本番用コンポーネントを作成しません。また、事前にデザインシステムを抽出する必要もありません。
• 表示するレコードはすべて架空のシミュレーションデータです。個人のインタビュー内容、認証情報、本番レコードは決して再利用しないでください。
• コンテキストレコードの [SYNTHETIC] と [ASSUMPTION] のラベルを維持してください。確定した判断は、その出典と責任者を含めて保持してください。ブラウザーでの確認は、プロトタイプの動作のみを検証します。
• 古いリビジョンと手動で作成したファイルを保持してください。更新時には、前回の所有権レコードとそのパスを検証したうえで、新しいリビジョンを作成します。
• トラッカーの変更、公開、依存関係のインストール、アプリケーションの起動は行わないでください。利用できない補助スキルは呼び出さず、不足している機能を報告してください。
• 共通の執筆ルール、出力マーカー、エビデンスの区別が記載された references/rules.md を読んでください。これらは常に適用されます。