Ardot html prototype converter

Skill balabalabalading/ardot-html-prototype-converter

Codex Skill for converting Axure/HTML prototypes into editable Ardot files / 将 Axure/HTML 原型转换为可编辑 Ardot 文件的 Codex Skill

Install

npx -y skills add balabalabalading/ardot-html-prototype-converter

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

将 Axure 或 HTML 原型导出物转换为可编辑的 Ardot 原型文件，并审查或修复已有 Ardot 页面。适用于 PC 与移动端 HTML/Axure 转 Ardot、弹窗与多状态取证、长页重建、本地组件复用、manifest 交接及结构/语义/视觉验证。

SKILL.md

3.4 KB, as published. Nobody here has run it

Ardot HTML 原型转换器

将浏览器中的真实业务状态重建为可维护、可编辑的 Ardot 页面。源证据优先于 Skill 默认值；项目约定优先于通用约定。

按需读取

转换前读取 references/workflow.md。
创建或修复页面时读取 references/page-specs/common.md，再只读取对应平台规范：
- PC：按主体读取 references/page-specs/pc-list-page.md、references/page-specs/pc-form-page.md、references/page-specs/pc-detail-page.md 或 references/page-specs/pc-report-page.md；存在真实弹窗时追加 references/page-specs/pc-dialog.md。
- 移动端：读取 references/page-specs/mobile.md。
审查或交接时读取 references/execution-checklist.md；出现异常时再读取 references/failure-modes.md。

硬约束

创建 Ardot 节点前，必须通过 HTTP 服务用 Playwright 或等价浏览器流程渲染原型，并保存本批实际业务状态的 element JSON 与截图。
规则优先级为：源状态证据 → 项目命名、设计和交接约定 → 本 Skill 的回退默认值。不得用通用默认值补造源稿不存在的区块、控件或状态。
页面使用 auto layout、命名容器和当前文件的本地组件；只建立本批需要的“业务角色 → component ID”最小映射，不跨文件硬编码 ID，也不用 Rectangle/Text 模拟交互控件。
PC 与移动端分别遵循对应根结构。已有根节点本地 AnnotationLayer 实例原样保留，并从结构和业务语义校验中排除。
列数、字段分组、顺序、样例值和信息层级以源证据为准。无法可靠实现时标记 needs_rebuild 或 blocked，不得压缩、隐藏或伪造内容后标记完成。
completed 必须同时通过结构、语义和视觉验证；capture_layout 只证明现有节点的几何状态。视觉通过以内容完整、层级和主要布局一致、无裁切重叠、文字可读为准，除非项目明确要求像素级还原。
每个系统使用独立 manifest。页面完成后更新对应记录；人工交接文档按批次更新，不在每个状态重复抄写 manifest。
控制上下文：优先读取 compact manifest、状态摘要、最小组件映射和单页证据；不常规输出 document.js、全量 HTML、完整组件库或整页实例子树。
通用 Skill 仓库只保存参数化规则、脚本和占位模板；项目业务数据、真实 ID 与证据保存在外部 --project-root 或被忽略的 .local/。

执行策略

先按结构签名选择代表样板；只有根结构、区块组合或交互模型真正变化时才增加新样板。
已知存在跨页节点失效、或项目明确要求时使用严格单页事务；其他环境可用小批次，但不得先创建大量空 page 后集中补建和取证。
每个状态保留源证据与 Ardot 证据。批量视觉检查使用 scripts/build_visual_review_sheet.js，同一图片只查看一次，异常项再展开原图。
修改保持最小、可解释、可回滚；重建页通过三层验证后，才删除本轮明确创建的废弃页。