ユーザーがページの UI スタイル(レイアウト、余白、色、コンポーネントの組み合わせなど視覚的な調整)の修正を要求した場合に使用します。構造化された協調フローで修正を完了し、各ステップで目標を一致させ、無駄な推測を排除します。
基本原則
- 推測しない、先走らない — 目標を合わせるまで、絶対にコードを変更しない
- スクリーンショットが第一言語 — ユーザーにスクリーンショットの提出を積極的に求め、問題箇所を特定する
- ASCII 図で方案を示す — レイアウト案は ASCII 図で描き、文字による説明では曖昧さを防ぐ
- 一度に一箇所だけ変更する — 複数箇所を一度に変更せず、段階的に目標に近づく
ワークフロー
ステップ 1:問題の特定
ユーザーがどこかを変更したいと言ったら、まず次の 2 つを行います:
- コードを読む — 関連ファイルを読み、現在の実装を理解する
- 現状を説明する — ASCII で現在のレイアウトを描き、ユーザーに確認する:「こう見えていますが、合っていますか?」
例:
┌─────────────────────────────────────────────┐
│ 📈 タイトル [🔄] │
│ サブタイトルの説明文 │
│ 🔍 [検索ボックス... ] │
├─────────────────────────────────────────────┤
禁止:このステップを飛ばしていきなり「どう変えたいですか?」と聞くこと。まずはユーザーに現在の状態を理解してもらう必要があります。
ステップ 2:方案を提示する
2〜3 の方案を提示します。各方案には以下を含めます:
- ASCII レイアウト図 — 修正後の見た目を描く
- 一言説明 — この方案の核心的な考え方
例:
方案 A:検索と更新を同じ行に配置
┌──────────────────────────────────────────┐
│ 🔍 [検索ボックス... ] [🔄] │
└──────────────────────────────────────────┘
方案 B:更新をタイトル行に移動
┌──────────────────────────────────────────┐
│ 📈 タイトル [🔄] │
│ 🔍 [検索ボックス... ] │
└──────────────────────────────────────────┘
禁止:
- 方案を 1 つだけ提示する(ユーザーに選択肢がない)
- 方案を 3 つ以上提示する(選択に迷う)
- 方案に ASCII 図がなく、文字だけ
ステップ 3:ユーザーの選択を待つ
ユーザーが方案を選んだ後に、コードを書き始めます。
禁止:ユーザーがまだ選んでいないのにコードを変更し始めること。
ステップ 4:コードを変更する
最小限の変更のみ行います。ユーザーが選んだ方案に関わる部分だけを変更します。
禁止:ついでに他の場所を修正する、コード構造を最適化する、コメントを追加する。
ステップ 5:微調整
変更後、ユーザーに結果を確認してもらいます。ユーザーから微調整の依頼があるかもしれません:
- 「枠線を追加して」
- 「色が濃すぎる」
- 「余白をもう少し広く」
微調整は具体的で小さな変更です。直接実行し、改めて方案選択のフローに入る必要はありません。
ユーザーのフィードバックが具体的でない場合(例:「何か違う」)、積極的に質問を重ねます:
- 「サイズの問題ですか?色の問題ですか?それとも配置の問題ですか?」
- 「隣のどの要素と調和していないと感じますか?」
コミュニケーション規範
ユーザーが提供すべき情報
| 情報 | 説明 |
|---|---|
| スクリーンショット | 修正したい領域をマークしたもの |
| 問題の説明 | 「この 2 つの要素のバランスが悪い」「余白が大きすぎる」など |
| 方案の選択 | 提示された方案から 1 つ選ぶ |
AI が行うべきこと
| フェーズ | 出力 |
|---|---|
| 問題特定 | ASCII 現状図 |
| 方案提示 | 2〜3 の ASCII 方案図 + 一言説明 |
| コード変更 | 最小限の変更、選ばれた方案のみ |
| 微調整 | 具体的な調整を直接実行 |
AI が絶対にすべきでないこと
- ユーザーが「レイアウトを変えて」と言っただけで、推測してコードを変更し始める
- 一度に大量のコードリファクタリングを提示する
- 微調整フェーズで複数の方案を提示してユーザーに選ばせる
- ユーザーが言及していない場所をついでに修正する