証明せよ (Prove It)
変更を、ユーザーが実際に使用する方法で証明せよ。証明なしに「動作します」と主張してはならない。
このスキルは「完了」時に自動でロードされない。ユーザーが依頼しなければならない。他のスキルをロードしない。
使用するタイミング
以下の場合にロードする:
- ユーザーが
/prove-itを実行した時 - 「証明して」、「変更点を証明して」、「ブラウザで見せて」、または同様の意図を発言した時(最初のメッセージも含む)
ユーザーが依頼していなければスキップする。タイプのみ、コメント、ロックファイル、動作を伴わないドキュメントはスキップする。
厳格なゲート
- ユーザーが依頼したこと。 証明を依頼していなければ、このスキルは実行されない。
- 「動作します」「完了しました」「修正されました」と言ってはならない。 このスキルが実際に証明した場合を除く。スキップは「証明されていない」を意味する。
- 1つの画面のスクリーンショットは証明ではない。 クリック、入力、送信、ナビゲートせよ。
- 新しいパッケージ、依存関係、サンプルアプリ、ブラウザランナーを追加してはならない。 ユーザーがその選択肢を選び、同意した場合を除く。
- このスキルが起動したサーバーは、スキル終了前に停止せよ。
dev/previewを実行したままにしてはならない。
UI vs サーバー
- UI(ページ、コンポーネント、ルート、フォーム、可視状態): ブラウザで証明せよ。
- サーバー / API / 画面のないライブラリ: 証明方法を質問せよ。黙って選択してはならない。
- 両方: ブラウザでUIを証明し、かつサーバー側の証明方法を質問せよ。
手順
手順 1: 分類
- 証明対象を列挙する: UI、サーバー/API、またはその両方。
- UI → 手順 2。
- サーバー/API → 手順 3。
- 両方 → 手順 2、その後APIについては手順 3。
手順 2: ブラウザ (UI)
- アプリが起動していない場合、既存のコマンドのみを開始する(
dev、preview、リポジトリのドキュメントに記載された起動コマンド)。存在しない場合は、UIは証明できないと伝える。スキップするか、ユーザーがアプリを起動することを提案する。 - ユーザーのように使用する:
- クリック、タイプ、送信、ナビゲートする
- この状態を共有するすべてのルート/ページ
- この変更に関連する空のUIとエラーUI
- レイアウトやCSSが変更された場合、デスクトップと狭いビューポートの両方
- ハッピーパスだけでなく、破損を探す。
- チャットで、何を実行し、何を見たかを伝える。手順なしで「問題なさそうです」と言ってはならない。
- このスキルがプロセスを開始した場合、手順1のプロセスを停止する。
- 手順 4。
手順 3: 質問 (サーバー / API)
- 停止する。2~3の選択肢を表示する。最初に妥当な最初の選択肢を置く。常にスキップを含める。
- 既存のサンプル/プレイグラウンド/デモ
- 新しいAPIを使用するサンプルアプリ(場所と新しいパッケージ/依存関係の確認がある場合のみ)
- 実行中のサーバーに対するcurlまたは小さなスクリプト
- スキップ
- 待つ。ユーザーが選択するまで、ビルドや実行を行わない。
- スキップの場合: 証明されていないと伝える。「動作します」と言ってはならない。停止する(手順4は不要)。
- 既存のプレイグラウンドの場合: それを実行し、UIがあればブラウザで証明する。スクリプトの場合はコマンド出力を表示する。
- サンプルアプリの場合: 場所を質問する。既存のサンプルを優先する。ユーザーが同意しない限り、パッケージや依存関係を追加してはならない。その後実行し、証明する。
- curl/スクリプトの場合: 実行する。終了コードと、主張を証明する出力の部分を引用する。
- 手順 4。
手順 4: オプションのレポート
- 実際の証明後、スクリーンショットレポートを書くか質問する。デフォルトはいいえ。
- 「いいえ」の場合: 停止する。チャットに既に証拠がある。
- 「はい」の場合:
.agent/scratch/prove-it.mdに書き込む(上書き)。.agent/scratch/が存在しない場合は.gitignoreに追加する(他のスクラッチファイルと同様)。クリックした内容とスクリーンショットを含める。ファイルを開く。コミットしてはならない。 - 証明をスキップした場合 → レポートは不要。
手順 5: 停止
証明またはスキップの後、停止する。このスキルから無関係な作業を開始してはならない。
決定木
- ユーザーが証明を依頼していない → このスキルは適用されない。
- UI → 手順 2 → 4 → 5。
- サーバー/API → 手順 3 → 4 → 5(スキップは手順3で終了)。
- 両方 → 手順2、次に手順3、その後手順4 → 5。
- 開始コマンドがなく、アプリが起動していない → UIは証明できないと伝える。スキップするか、ユーザーが起動する。
- ユーザーがスキップと言った → 証明されていない。成功の主張はしない。
レッドフラグ
| シグナル | 意味 | 代わりに行うこと |
|---|---|---|
| テストが通ったから完了と言う | このスキルが依頼されていない、または証明がスキップされた | 手順2または3の後にのみ証明済みと主張する。 |
| 1つのスクリーンショット、クリックなし | ユーザーパスではない | 手順2のステップ2。 |
ユーザーが選択する前に examples/foo をビルドする | 依頼されていないアプリ | 手順3。待つ。 |
| Playwright / 新しいサーバーを追加する | 新しい依存関係 | 既存の開始コマンドのみ。 |
pnpm dev を実行したままにする | ウォッチャーが残っている | 厳格なゲート5。 |
| 「スキップしますが、動作します」 | スキップを主張に変える | 証明されていないと伝える。 |
docs/ 内のレポートファイル | 製品ドキュメント | .agent/scratch/prove-it.md。 |
| ユーザーが「いいえ」と言ったのにレポートを開く | 依頼されていないファイル | 手順4のデフォルトは「いいえ」。 |
| 新しい公開APIに対してページのみを証明する | サーバー側が黙ってスキップされた | APIについては手順3。 |
エラーハンドリング
- ブラウザツールがない: UIはここでは証明できないと伝える。スキップするか、URLを待っている間にユーザーがクリックすることを提案する。スクリーンショットを偽造してはならない。
- 起動コマンドが失敗する: エラーを引用する。UIが動作すると言ってはならない。修正を提案するかスキップを提案し、その後再度証明する。
- 証明が失敗する(クリックが間違った動作をする、curlが200以外を返す): 証明されていないと伝える。何が失敗したかを明示する。「完了」とは言わない。
- ユーザーがサンプルアプリを選んだ後、新しいパッケージの追加を拒否する: curl、既存のサンプル、またはスキップを使用する。パッケージを強制的に追加してはならない。
- スクラッチへの書き込みに失敗する: 証拠はチャットに残す。レポートファイルが書き込まれなかったと伝える。
他には何も見ないこと。チャットがデフォルトの証拠である。Markdownファイルはオプションである。