design-select
Use when creating a new screen or significantly changing a UI's look. Presents 2-3 design candidates as clickable HTML mockups in the user's browser (local preview server), lets the user pick one, then implements the winner per DESIGN_RULE.
- License 许可
- MIT
- 最近更新
- 2026-08-31
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- design-select
- description
- Use when creating a new screen or significantly changing a UI's look. Presents 2-3 design candidates as clickable HTML mockups in the user's browser (local preview server), lets the user pick one, then implements the winner per DESIGN_RULE.
02 资源文件 7
- 参考文档references/visual-companion.md12.8 KB
- 脚本scripts/frame-template.html7.9 KB
- 脚本scripts/helper.js5.5 KB
- 许可证scripts/LICENSE1.0 KB
- 脚本scripts/server.cjs25.3 KB
- 脚本scripts/start-server.sh6.7 KB
- 脚本scripts/stop-server.sh3.2 KB
03 SKILL.md 正文
design-select — デザイン候補を HTML で提示して選ばせる
UI の新規作成・大幅変更では、いきなり React を書かず、デザイン候補 2〜3 案を HTML モックとしてブラウザに出し、ユーザーにクリックで選ばせてから実装する。サーバは superpowers の visual companion を vendored(scripts/、MIT — scripts/LICENSE)。サーバ運用の詳細は references/visual-companion.md。
軽微な文言・スタイル修正には使わない(通常の DESIGN_RULE パス 1 テキスト提示で足りる)。
手順
-
候補を計画する(コード禁止) —
docs/frontend/DESIGN_RULE.mdパス 1(題材 → トークン計画 → シグネチャ要素 → 自己批評)を候補ごとに行い、2〜3 案作る。- 各案は方向性ごと変える(題材・レイアウト構造・タイポ軸で差別化)。色違いだけの 3 案は禁止。
- 全案が NEVER 表(3 大 AI デフォルト面相など)を通過していること。generic な案は候補に入れない。
-
サーバ起動(リポジトリルートを
--project-dirに。--openでブラウザが開く):bash .agents/skills/design-select/scripts/start-server.sh \ --project-dir "$(git rev-parse --show-toplevel)" --open--project-dirは絶対パス必須(相対パスだと起動に失敗する。git rev-parse --show-toplevelは絶対パスを返すのでそのまま使える)。返る JSON のurl(?key=付きの完全な URL)をユーザーに伝え、screen_dir/state_dirを控える。落ちていたら同じ--project-dirで再起動(同ポート再利用でタブは自動再接続)。 -
候補 HTML を
screen_dirに書く(例:design-candidates.html。ファイル名は再利用禁止、イテレーションは-v2):- 完全な HTML 文書(
<!DOCTYPE html>開始)として書く。フレームで包まれず、デザインがそのまま見える。helper(クリック記録)は自動注入される。 - 各候補は実物大の 1 画面モックとして縦に並べ、候補のルート要素に
data-choice="a|b|c"とonclick="toggleSelect(this)"を付ける。候補間に「案 A: <題材名> — クリックで選択」の帯を挟む。 - トークンは案ごとに
<style>内の CSS カスタムプロパティで定義(= その案のトークン計画の具現)。書体は Google Fonts の<link>で代用してよい(実装時は fontsource で自己ホスト)。 - コピーは実データ相当の文言(DESIGN_RULE §4)。Lorem ipsum・
{placeholder}禁止。
- 完全な HTML 文書(
-
ターンを終える — URL を再掲し、「ブラウザで見て、良い案をクリック → ターミナルで一言ください(修正指示でも OK)」と依頼して待つ。
-
選択を読む — 次ターンで
$STATE_DIR/events(JSONL、最後のchoiceが最終選択)とターミナル発言を突き合わせる。修正指示なら新ファイルで再提示。 -
選ばれたモックを台帳化 — 勝った案の HTML を
docs/frontend/mockups/<画面名>/にコピーしてコミット対象にし、却下された方向はdocs/frontend/mockups/README.mdに「禁止」として追記する(DESIGN_RULE §6 のモック台帳。.superpowers/brainstorm/は gitignore 済みなので、コピーしないと選択結果が残らない)。 -
実装 — 選ばれた案のトークン計画を
packages/ui/src/theme.cssに反映し、DESIGN_RULE パス 2 で React 実装。モックの inline CSS をコピペしない(トークンクラス経由に翻訳する)。 -
後始末 —
bash .agents/skills/design-select/scripts/stop-server.sh $SESSION_DIR。