Communitygithub.com

デモレビューフロー

UIの見た目や操作、配置、インタラクションなどを変更する場合に使用します。テストやコードレビューでは発見できない、ユーザーだけが気づく問題を扱います。

デモレビューフロー とは?

このスキルは、UIに関するあらゆる変更(レイアウト、コントロールの配置、インタラクション、キーボードショートカット、スタイリング、アニメーションなど、小さな調整や期限が迫った修正も含む)を安全かつ効率的に進めるためのデモレビューフローを提供します。テストやコードレビューはメカニズムの正しさを証明しますが、メニューの位置が間違っている、閉じる動作がチラつく、アイコンが2pxずれているといったことはユーザーだけが判断できます。そこで、本番コードを書く前に、ユーザーが各機能を操作可能なデモで承認するまで絶対にコードを書かないという原則に基づきます。各機能は6つのステータス(レビュー中、承認、移植中、出荷済み、検証済みなど)で管理され、専用のレビューボード(Artifactページ+共有データベース)で追跡されます。このスキルはClaude Code, Cursor, CodexなどのAIエージェントと連携し、UI作業のセッション再開時やレビュー依頼時に自動的に適用できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whats2000/demo-review-skills/tree/HEAD/skills/demo-review-flow

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

デモレビューフロー は何をしますか?

テストとコードレビューはメカニズムの正当性を証明します。しかし、メニューの位置が間違っている、クローズが一瞬点滅する、アイコンが2px低い——これらはユーザーにしかわかりません。したがって、見た目や操作の変更は、製品コードを書く前に、機能ごとにユーザーが承認する動作するデモとして設計し、実際のアプリでユーザーが受け入れたときにのみクローズします。レビューボード(共有データベースを持つArtifactページ)は、すべての機能を6つのステータスで追跡します。

プロジェクト設定: .claude/demo-board.md(ボードURL、エリアごとの参照アプリ、確認する幅、ライブアプリ+それが実際のデータを保持するかどうか、ワークスペースコピーのポート、ゲートコマンド、仕様ファイル)。ない場合→先にボードを作成:references/board-setup.md。

どのパスか

  • 何かの見た目、配置、操作方法を変更する → このフロー。規模や期限による例外はありません。
  • 仕様または承認済みデモで既に定義されている動作を復元する(クラッシュ、誤ったデータ、オーバーフロー、リグレッション) → デモなしでTDDで直接修正。ユーザーにどのパスと判断したかを伝えてください。
  • 出荷済みのボード項目に関して報告されたバグ → portingに戻り、修正し、ライブで確認、shipped。見た目を変える修正 → 新しいデモラウンド。

フロー

  1. 最初に参照。 エリアごとに、ユーザーが既に知っているアプリを確認します(設定にリストされています)。コントロールの位置、各キー、モーション(終了を含む)を記録します。理由を明示した場合のみ逸脱を許可します。シミュレートされたユーザーの調査でオプション間の選択を行いますが、参照を置き換えることはありません。
  2. 実際のUIを測定。 変更が影響する出荷済み画面を、ユーザーの指定幅で読み取り専用でスクリーンショットし、ガター、サイズ、配置を測定します。そのレイアウト上で設計します。
  3. デモを作成 実際に動作するfeat()エントリとして:クリック、キー、モーション(終了を含む)、ライト+ダーク、狭い幅。→ references/add-feature.md
  4. 記録: changes行とfeatures/<id> → review。
  5. 引き継いで停止。 リンク+確認すべき点。この項目の製品コードはapprovedになるまで書きません。「異論がなければ進めて構いません」は承認ではありません。期限までに承認が得られない場合、既に出荷できるものをユーザーに提供します——先に作ってはいけません。
  6. 決定を拾う すべてのUIセッションの開始時と、ユーザーがレビューしたと言ったとき:featuresを読む。approved → 7へ。changes → noteがリクエスト → 3へ。ユーザーが承認したと言うがDBが一致しない場合 → クリックが保存されていない:その旨を伝え、設定してあげます。
  7. すぐに移植 — ユーザーは計画をレビューしません。彼らの基準はステップ9です。portingに設定。references/port-brief.mdに従って簡潔に。ファイルエリアごとに1つの移植エージェント。マイグレーションはワークスペースコピーで実行。明示的な承認とバックアップがある場合のみライブデータで実行。
  8. ライブでの証拠がある場合のみ出荷(測定値、フレームごとのモーション、両テーマ、ユーザーの幅):shipped + changes行 + 確認すべき点。
  9. 検証はユーザーの判断 — ユーザーのAcceptクリック、またはチャットでこの項目が受け入れられたと言った場合(その場合あなたが設定します)。曖昧な「良さそう」 → どの項目か尋ねてください。自分の判断で行わないでください。

ステータス、設定者、DBスキーマ、書き込み → references/lifecycle.md。ブレインストーミング、計画作成、サブエージェント駆動開発、検証、ブランチの仕上げとの連携 → references/superpowers-integration.md。

ライブチェックの安全性

実際のデータを持つライブアプリ上で:読み取り専用で閲覧、正確なラベルのみクリック、削除/削除/編集は決して行わない — データを変更するチェックはすべてワークスペースコピーで実行します。

理屈

考え現実
「小さい/元に戻すのは簡単」規模はテスト基準ではありません。見た目か操作かが基準です。小さなUI変更こそ配置ミスが発生します。
「明日が期限だ」デモラウンドは数分。間違った配置を出荷してデモで修正する方がコストがかかります。順序を守り、タイムラインを明示してください。
「スクリーンショットを見せて、異論がなければ進める」沈黙は承認ではなく、完成したビルドのスクリーンショットは操作可能なデモではありません。
「正しい場所は第一原理から明らかだ」参照アプリを指名してください。「ユーザーが見る場所」こそ、見つけられないスイッチが出荷された理由です。
「テスト、レビュー、ビルドが通ったから完了だ」それはporting完了です。shippedにはライブでの証拠が必要です。verifiedにはユーザーの承認が必要です。
「『まあいい感じ』は受け入れられた意味」受け入れは項目ごとです。どの項目か尋ねてください。
「どうせ承認されるから、期限に備えて先に作っておこう」未承認のコードは無駄です。今日出荷できるものを示し、承認された瞬間に移植してください。
「もっと明確なステータスを自分で作ろう」6つのステータスのみ。ページとユーザーはこれらを読んでいます。
「移植とデモを一緒にやって時間を節約しよう」approvedの項目だけが製品コードを取得します。

レッドフラグ — 停止

  • デモがデザインを示す前に製品コンポーネントを開く。
  • 名前付きの参照アプリがない、または実際のUIの測定がないデザイン。
  • ライブ証拠なしのshipped。その項目に関するユーザーの言葉なしのverified。
  • 実際のデータを保持するアプリで「削除」「削除」「保存」をクリックする。
  • 同じファイルに対して2つの移植エージェントが作業している。ライブデータでマイグレーションを実行する。

関連スキル