flamemida 语言协议：以对话语言输出——用户显式指定（含平台
language设置）优先，其次跟随用户近期消息语言；均无法判定时默认英语。落盘产物以创建时对话语言为准，增量修改保持产物既有语言。本 skill 中的固定话术是语义模板，用对话语言表达其意，不逐字照搬。
外部搜索统一入口：需要联网检索（资料、库/框架文档、时效信息）时一律先用 anysearch skill（插件内嵌），不可用再降级 WebSearch/WebFetch；降级链与派发词要求见 requirement-analysis 的 references/exploration-patterns.md。
可视化预览（Visual Preview）
基于浏览器的视觉工具：在设计对话中向用户展示 mockup、图示与可点击的选项，选择结果回流到会话。这是一件工具而不是一种模式——启用后也只有真正视觉的问题才走浏览器。
提议规则（JIT，铁律）
不要在开场提议。 等到某个问题真的"用看的比用说的更清楚"——真实的 mockup/布局/图示对比问题，而不只是"话题涉及 UI"——首次出现时才提议，且提议必须独立成一条消息（只含提议，不夹带澄清问题、总结或其他内容）：
「接下来这部分我画给你看可能更直观——我可以在浏览器页面里做 mockup、图示和并排对比，边聊边更新。这个功能还比较新、也比较费 token，要用吗？同意的话我会为你打开页面。」
等待用户回复。接受则用 --open 启动服务器（浏览器自动打开首屏）；拒绝则继续纯文字，此后不再提议，除非用户主动提起。
逐题判断：浏览器还是终端
用户接受后，仍要对每个问题单独判断。判据：用户看到它会比读到它理解得更好吗？
- 用浏览器：内容本身是视觉的——mockup、线框图、布局对比、架构图、并排视觉方案、观感/间距/视觉层级问题
- 用终端：内容是文字的——需求问题、概念选择、取舍清单、A/B/C 文字选项、范围决策
涉及 UI 的话题 ≠ 视觉问题。"这个向导的『个性化』指什么？"是概念问题——用终端；"哪种向导布局更好？"是视觉问题——用浏览器。
启动会话
# 用户同意后再启动。--open 自动打开浏览器；--project-dir 使 mockup 持久化并支持同端口重启。
# 可选 --theme-css <file>：注入项目的 design tokens/CSS 变量，让 mockup 用项目自己的配色。
# ${CLAUDE_SKILL_DIR} 由平台替换为本 skill 目录；未替换时取 skill base directory。
bash "${CLAUDE_SKILL_DIR}/scripts/start-server.sh" --project-dir /path/to/project --open
当前处于特性上下文（本次会话正在做某特性的需求设计/计划）时必须额外传 --feature-dir .spec-dev/<当日特性目录>——产物落 <feature-dir>/visual/<session-id>/（端口/密钥记忆文件仍固定在 .spec-dev/visual/ 根，跨特性共享端口）；无特性上下文时不传，回退 <project>/.spec-dev/visual/。
返回 JSON 含 port、url、screen_dir、state_dir——保存后两者。会话文件落在 <feature-dir>/visual/（特性上下文）或 <project>/.spec-dev/visual/（回退）；两个 visual 根（.spec-dev/visual/ 与 <feature-dir>/visual/）的 .gitignore（内容 *）由脚本自建，无需修改仓库 .gitignore。不要忽略整个 .spec-dev/——spec/plan/roadmap 等产物需要提交入库，漂移守卫也依赖已提交的 spec。
URL 含会话密钥（?key=…）：始终把 url 字段的完整 URL 给用户，不得裁掉 query string——密钥同时守卫 HTTP 与 WebSocket 访问。
平台差异：
| 平台 | 启动方式 |
|---|---|
| Claude Code | 直接运行，脚本自行后台化；Windows 下自动转前台，需在 Bash 调用加 run_in_background: true，下一轮读 $STATE_DIR/server-info 取 URL |
| Codex | 脚本检测 CODEX_CI 自动转前台，正常运行即可、无需额外参数 |
| 其他 | 若环境回收后台进程，用 --foreground + 平台自身的后台执行机制 |
远程/容器环境浏览器连不上时：--host 0.0.0.0 --url-host localhost（此时启动 JSON 的 lan_urls 列出局域网地址，可给用户在手机上打开，看移动端 mockup 更真实）。
循环
- 确认服务器存活（
$STATE_DIR/server-info存在且server-stopped不存在；已停则用相同--project-dir重启，端口复用、已打开的标签页自动重连），然后写 HTML fragment 到screen_dir的新文件——语义化命名（layout.html）、永不复用文件名、用文件创建工具而非 cat/heredoc，服务器自动展示最新文件 - 告知用户并结束回合：重发 URL（每一步都发）、一句话概括屏上内容、请用户看完在终端回复（想选就点击选项）
- 下一回合：读
$STATE_DIR/events（JSON lines，浏览器交互记录）——终端文字是主反馈，events 提供结构化补充；type:"confirm"是用户的明确最终选择（含随附备注），click带selected区分选中/取消，annotate是用户点选的"要改的位置"；文件不存在说明用户没和浏览器交互 - 迭代或推进：反馈改当前屏就写新文件（
layout-v2.html）；当前问题验证完才进下一题 - 回到终端时卸载：下一步不需要浏览器时推一张等待屏（
waiting.html：「继续在终端讨论…」），避免用户盯着已解决的选择题 - 重复直至完成
fragment 写法、可用 CSS 类、events 格式、命名细则见 preview-guide.md。
清理
bash "${CLAUDE_SKILL_DIR}/scripts/stop-server.sh" "$SESSION_DIR"
项目内会话同规则：特性目录下的 visual/ 会话与 .spec-dev/visual/ 会话的 mockup 均保留供日后查看（stop-server.sh 的删除逻辑只认 /tmp 前缀，特性目录会话自然保留）；仅 /tmp 会话在停止时删除。服务器空闲 4 小时自动退出（--idle-timeout-minutes 可调）。
归档约定：被设计采纳的定稿 mockup 复制为特性目录 spec/assets/<名称>.html 入库——这是唯一入 git 的 visual 产物。
Red Flags
- 开场就提议可视化预览 → 必须 JIT，首个真视觉问题出现时才提
- 提议消息里夹带其他问题 → 提议独立成消息
- 用户接受后所有问题都走浏览器 → 逐题判断，文字问题留终端
- 复用 HTML 文件名 → 每屏新文件
- 用户拒绝后再次提议 → 不再提，除非用户主动提起