ce-polish

Polishing

実際に動く機能をユーザーに提示し、実行中のページで得たユーザーのリアルタイムな観察を、的を絞った UX 改善につなげます。観察を集める方法は 2 つあります。従来方式では、改善できる点をユーザーが入力します。ライブ方式では、ユーザーがページ上で話したり描き込んだりし、音声インタビュアーが発話を項目に分け、チェックポイントごとにそれらへ対応します。

**完了条件：**ユーザーが改善ループを終了し、依頼された修正がすべて実際に動く機能に反映されるか、対応できないものとして報告され、対象範囲内の変更がローカルコミットとして保存されていること。ライブセッションでは、適用しなかった項目の残件リストと、セッションログのパスも示して終了します。サーバーまたはチェックアウトが妨げとなる場合も、再開に必要な根拠を添えて報告した時点で実行を終了します。

**範囲：**何を確認し、変更するかはユーザーが決めます。自律的なチェックリストを作成したり、一般的な QA に範囲を広げたりしてはいけません。リポジトリのデフォルトブランチでは作業しないでください。このワークフローでは、依頼された改善の編集とローカルコミット、およびライブモードで開示した riffrec のセットアップコミットを行えますが、プッシュや PR の作成は行いません。

実行

1. **ライブ方式か従来方式かを尋ねます。**サーバーを起動する前に、一度だけ尋ねてください。質問には次の説明を含めます。ライブモードでは環境に OpenAI キーが必要です。また、ページ内でユーザーの声を聞き、ユーザーのクリックや描画の内容を把握し、ユーザーが何かを指したり確認を求めたりしたときに画面を確認する音声インタビュアーを実行します。セッションは、このスキルが起動するローカルエンドポイントにストリーミングされます。アプリに riffrec がまだ含まれていない場合は、riffrec の依存関係とプロバイダーマウントを現在のブランチにセットアップコミットとして追加し、セッション終了後もそのまま残します。従来方式では、手順 2～5 を変更せずに続行します。ライブ方式では references/live-start.md を読みます。このファイルでは、事前条件、インストール、エンドポイント、URL の引き渡しを管理し、references/run.md のワークスペースとサーバーのルールを適用したうえで、セッションとその終了処理のために references/live-loop.md に進みます。ライブセッションでは手順 2～5 は実行しません。
2. **ライブページを準備します。**依頼された ref を解決したり、何かを起動したりする前に references/run.md を読みます。このファイルでは、既存のワークツリーの安全性、開発サーバーの検出、同梱スクリプトの呼び出し、到達可能性、ブラウザーへの引き渡しを管理します。
3. **観察を待ちます。**サーバーがどこで動作しているかをユーザーに伝え、改善できる点を尋ねます。ユーザーが閲覧している間は、レビューを開始しないでください。
4. **反復します。**依頼された変更ごとに、必要な範囲だけを確認し、対象範囲内の箇所を編集して、ホットリロードでページを更新します。ユーザーから結果の確認を求められたら、アクティブなハーネスで利用できるブラウザー機能を使用します。ブラウザー機能がない場合は、画面に何が見えているかをユーザーに説明してもらいます。
5. **ローカルで終了します。**ユーザーが完了を伝えたら、改善内容について ce-commit を実行し、コミットと、引き続き起動しているサーバーの URL、および未解決の阻害要因を報告します。