Implementation
コーディングエージェント向け修正指示に変換する
レビュー結果はそのままでは実装タスクになりません。何を直すか、なぜ直すか、どう確認するかを揃えると、Codex、Claude Code、Antigravity、Cursorなどに渡しやすくなります。
ui.design: handoffui.design: tasks-json
まず確認する症状
- 所見はあるが、開発者がどこから直すべきか分からない。
- 修正後の確認条件がなく、直ったか判断できない。
なぜ問題か
- 自動開発では、曖昧な指摘よりも受け入れ条件つきの小さな作業単位が重要です。
- ツール名に依存しないMarkdown/JSONにすると、顧客の開発環境を選びません。
診断で見る指標
目的の明確さ
対象UI/URL
修正方針
acceptance criteria
再スキャンで見る項目
修正方法
最小修正
所見をタスクへ分解する
1タスク1目的にし、該当URL、症状、期待結果を入れます。
推奨修正
受け入れ条件を必ず付ける
目視、キーボード、スマホ、自動検査、再スキャンの確認条件を明記します。
さらに改善
zipで渡せる構成にする
report.md、tasks.json、findings.json、acceptance_criteria.md、修正指示をまとめます。
受け入れ条件
- 01PCとスマホの両方で目視確認し、主なCTAまたは操作対象が迷わず見つかる。
- 02キーボード操作、読み上げ補助、または自動検査で再発しやすい項目を確認する。
- 03修正後にui.designで再スキャンし、同じ所見が残る場合は原因を分解する。
コーディングエージェント向け修正指示
目的: 診断所見をコーディングエージェント向けの小さな修正タスクへ変換してください。各タスクに対象URL、問題、修正方針、受け入れ条件、再スキャン確認項目を含めてください。
参考資料
よくある失敗
- 特定ツール名だけを前提にしたプロンプトにする。
- 見た目だけを整え、見出し、リンク、フォームラベルなどの意味構造を直さない。
- 1つの指摘だけを直し、同じ原因から出た別画面の再発を確認しない。