ce-polish

Polish（润色）

将可用功能呈现在用户面前，并将他们的实时观察转化为对运行中页面的针对性 UX 修复。收集这些观察有两种方式：传统模式，由用户输入可以改进之处；以及实时模式，用户在页面上边说边画，语音访谈器将语音转换为条目，你则在检查点逐项处理。

**完成标准：**用户结束润色循环；每项所请求的修复都已反映到实时功能中，或已报告为受阻；范围内的更改已保存到本地提交中。实时会话结束时，还要列出未应用条目的剩余清单，以及会话日志的路径。如果报告了服务器或检出阻碍，并提供了恢复所需的证据，也视为运行结束。

**边界：**由用户决定检查和更改的内容；不要自行编造检查清单，也不要扩展到一般 QA。绝不能在仓库的默认分支上操作。此工作流可以编辑并在本地提交所请求的润色内容；在实时模式下，也可以提交已披露的 riffrec 设置更改，但绝不推送更改或创建 PR。

运行

1. **询问使用实时模式还是传统模式。**必须在启动任何服务器之前询问一次。提问时一并说明：实时模式需要环境中配置 OpenAI 密钥；会在页面中运行一个能听见用户说话的语音访谈器；访谈器会获知用户点击和绘制的位置，并会在用户指向某处或提出要求时查看其屏幕；会将会话流式传输到此技能运行的本地端点；如果应用中尚未集成 riffrec，则会将 riffrec 依赖项和一个 provider 挂载添加为当前分支上的设置提交，该提交会在会话结束后保留。传统模式按原样继续执行步骤 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，以及任何剩余阻碍。