القائمة
Visual Ralph 编排：用 $ralph 加上内置的 visual verdict 与像素 diff 证据，从生成参考、静态参考或在线 URL 目标出发实现前端 UI，直到实现匹配，并沉淀出可复用的设计系统。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
oh-my-kimi 的目录入口，包含面向 Kimi CLI 的 agent、skill、hook 与 MCP 套件，衍生自 oh-my-* 谱系。
面向密钥、注入、authz/authn、不安全 IO、依赖与数据外泄风险的安全评审
证据驱动的追踪通道，在 Kimi 的 Agent 工具中编排互相竞争的 tracer 假设
LLM Wiki —— 跨会话持续累积的 markdown 知识库（Karpathy 模型）
面向作家的 agentic 记忆系统 —— 跟踪人物、关系、场景与主题
跑只读的深度仓库分析，返回一份带置信度排序的综合结论，附具体文件引用、清晰区分证据与推断。当用户说 'analyze'、'investigate'、'why does'、'what's causing'，或在提任何改动方案之前需要跨文件的有据解释时使用。
| name | visual-ralph |
| description | Visual Ralph 编排：用 $ralph 加上内置的 visual verdict 与像素 diff 证据，从生成参考、静态参考或在线 URL 目标出发实现前端 UI，直到实现匹配，并沉淀出可复用的设计系统。 |
当用户希望 Codex 通过 Visual Ralph 循环来构建或重做前端 UI 时使用本 skill：已批准的生成参考、静态参考，或来自在线 URL 的基线作为目标，Ralph 负责实现，Visual Verdict 用可测量的判定驱动迭代，而不是仅靠主观描述。
从生成参考、静态参考或在线 URL 出发，构建可测量的前端交付循环：
用户描述 / 在线 URL -> 已批准的视觉参考 -> $ralph 实现 -> Visual Ralph verdict + 像素 diff -> 可复用的设计系统。
对于在线 URL 克隆请求，Visual Ralph 接管已迁移的 $web-clone 用例。不要把新的 URL 驱动的网站克隆工作路由到 $web-clone；把 URL、视口、保真度要求与交互说明都保留在 Visual Ralph 循环里。
这是一个编排 skill。它组合已有的 skills，自身不应当引入运行时命令、依赖或应用级假设。
$frontend-ui-ux 或 designer 通道。$ralph 并附 Visual Ralph verdict 指引。在做任何技术栈相关选择之前，先检查本地证据：
不要在没有仓库证据支持的情况下硬编码 React、Vue、Tailwind、Playwright 或任何其他技术栈。
对于在线 URL 请求，在 Visual Ralph 工件里捕获或记录 URL 派生的参考，并把视口、内容状态、交互约束保留下来。不要调用 $web-clone；该独立 skill 已硬弃用。
在线 URL 参考工件必须包含：
对于生成式的 UI 概念，用 $imagegen 从用户的 UI 描述产出参考。
Prompt 要求：
ui-mockup，除非另一种 imagegen 分类明显更合适，在 oh-my-kimi CLI / runtime 下运行、且生成参考是某个活跃的 Ralph 风格循环的一部分时，在调用内置图像工具之前先排入一个 continuation checkpoint：
kimi-omk imagegen continuation <session-id> --artifact <slug-or-filename> --generated-dir "$CODEX_HOME/generated_images/<session>" --work-dir ".omk/artifacts/visual-ralph/<slug>"
这个 helper 会记录 .omk/state/sessions/<session>/imagegen-pending.json，并复用已有的 Stop-hook 后续队列。它的存在是因为内置图像生成可能必须立刻结束 assistant 的本轮回合；下一次 Stop checkpoint 应当恢复工件回收，把生成的图像拷贝进工作区，并跑必要的视觉 QA / verdict 门，而不是依赖手动 $ralph 再次提示。
对于绑定到项目的实现，把已批准的参考拷贝到工作区，例如 .omk/artifacts/visual-ralph/<slug>/reference.png。永远不要让实现参考只留在 $CODEX_HOME/generated_images/... 里。
在参考生成或 URL 派生参考捕获完成后停下，并请用户批准一张参考图 / 状态，或请求定向的重新生成 / 捕获调整。
批准之前：
$ralph，批准之后，被确认的图像或 URL 派生基线成为视觉真理来源。任何重大设计转向、替换参考或改变设计方向都需要用户显式请求。
$ralph 实现调用 $ralph 时附上：
批准后 Ralph 可以自主迭代。它应当编辑代码、跑应用、截图，并持续改进直到匹配已批准的参考，或出现真正的阻塞。
每一次视觉迭代：
vision agent 做图像理解。score < 90，把 differences[] 与 suggestions[] 转成下一次编辑计划。必需的 verdict 形状：score、verdict、category_match、differences[]、suggestions[]、reasoning。
当不匹配的诊断很难时，生成像素 diff 或 pixelmatch overlay 来定位热点。像素 diff 不替代 Visual Ralph verdict；它只帮你把视觉热点翻译成具体编辑。
把最终 diff 证据与参考 / 截图工件一并记录，让结果可被审计。
如果视觉匹配没有被编码成仓库原生的可复用工件，实现就不算完成。视项目情况，这可能意味着 CSS 变量、theme token、Tailwind 配置、组件 variant、Storybook story、设计文档，或已有的等价物。
至少捕获相关的：
优先复用已有的 token / 组件模式。如果仓库已经有可扩展的设计系统层，不要再引入一个新的。
下面全部为真之前不要宣告完成：
>= 90。$ralph "Implement the approved frontend reference.
Reference: <workspace-reference-image-or-url-derived-artifact>
Source URL (if URL-derived): <url and permission/scope note>
Viewport/content state: <viewport, route/state, seed/login assumptions>
Interaction parity notes: <visible controls and known exclusions>
Route/surface: <route or component>
Screenshot command: <command and viewport>
Use the Visual Ralph verdict step before every next edit; pass threshold score >= 90.
Use pixel diff only as secondary debug evidence.
Extract reusable design tokens/components for colors, spacing, typography, radii, shadows, and key variants.
Run build/lint/test before completion.
Do not make major design pivots unless explicitly requested."
Task: {{ARGUMENTS}}