HTML Anything Renderer
将用户的内容先理解和结构化,再生成内容完整、视觉统一、可保存的单文件 HTML。原始输入始终是事实源;content-brief 只是生成辅助和审阅中间产物。
三种模式
direct-render
用户已经明确内容和输出形态时,内部生成 content-brief,直接生成 HTML,不额外打断。
synthesize-first
用户要求“先总结/先提炼/先梳理”,或材料较长、结构复杂、存在多种合理表达时:
- 读取原始内容;
- 生成内容提炼卡;
- 推荐最适合的 HTML 输出形态和设计包;
- 展示关键事实、保留项、不确定项和覆盖映射;
- 等用户确认或修改后,才生成 HTML。
详细字段见 references/content-brief-schema.md。
conservative-render
用户要求“不改原意”“只排版”“只替换数据”时,不主动摘要或重排语义;已有 HTML 时使用最小差异编辑。
工作流程
- 识别输入格式:Markdown、文本、CSV/TSV、JSON、YAML、SQL、PDF 提取文本、图片说明或已有 HTML。
- 保留原始输入,不把摘要当作唯一事实源。
- 按章节、论点、步骤、数据组和列表项生成
content-brief。 - 根据用户目标、内容结构和期望风格选择输出形态与基础设计包。
- 将用户明确风格要求编译为适配规则;用户风格优先于模板默认风格。
- 生成完整的
<!DOCTYPE html>到</html>文档。 - 执行 HTML 质量检查和内容覆盖检查。
- 交付 HTML,并说明已检查项目、外部资源依赖、未验证的浏览器行为和平台边界。
如果用户只提出“做得漂亮”之类的审美目标,却没有提供需要呈现的内容,先说明需要内容或内容来源;不要用虚构案例填空。
事实边界:不虚构事实;信息不足时保留不确定状态,并明确说明不虚构、不代填。用户明确的风格要求优先于模板默认风格。
Reference routing
- 输入提炼或用户要求先梳理:读取
references/content-brief-schema.md; - 输出形态不明确:读取
references/output-modes.md和references/template-catalog.md; - 需要选择或改造模板:先读取
references/template-index.md(机器路由字段见references/template-index.json),默认只对status: active的模板按load_refs按需读取;用户明确指定时才加载experimental模板,并披露风险;再读取references/design-packs/<pack>.md和references/template-adaptation.md; - 生成或复核 HTML:读取
references/design-principles.md和references/html-quality-checklist.md; - 涉及复制、截图、部署或发布:读取
references/platform-boundaries.md; - 需要视觉参考时,可以查看
templates/<pack>/example.html,但把示例当作资产参考,不把示例中的事实当作用户事实。
内容和设计不变量
- 页面数量由用户内容的信息结构决定,不被示例中的固定页数限制。
- 不删除关键数字、限定词、例外条件、来源和用户明确要求。
- 不使用 lorem ipsum、虚构指标、虚构来源或“已经发布”的假回执。
- 用户明确提出的色彩、字体、密度、质感和品牌要求优先于模板默认值。
- 模板是设计系统和版式池,不是不可修改的 DOM;可以轻度换肤、中度换布局,必要时切换模板。
- 默认优先 CSS/SVG 内联;外部字体、CDN、图片和脚本必须披露。
- 中文优先字体、清晰层级、足够对比度、键盘焦点态和 reduced-motion。
模板选择与适配
模板资源按需读取,不要一次加载全部设计包。先读 references/template-catalog.md,再读取与当前输出形态匹配的设计包。
完整模板路由以 references/template-index.md 和 references/template-index.json 为准。索引中的 candidate 和 deferred 只用于审查与路线图,不能直接渲染;已经适配但带有来源或浏览器风险的 experimental 模板只能在用户明确指定时调用;active 模板才是默认调用路径。
适配优先级:
用户明确风格要求
> 内容完整性与事实准确
> 可读性与无障碍
> 基础设计包
> 默认审美偏好
如果用户风格与模板冲突:保留模板的可复用结构,改写颜色、字体、密度、圆角、动效和版式;如果冲突影响内容承载或可读性,说明冲突并提供替代设计包。
质量与外部动作边界
运行 scripts/validate_html.py 或等价检查时,只把静态检查报告为静态检查。微信、知乎、X、PNG 截图、Vercel 和其他平台动作需要对应宿主工具、凭据和明确授权;见 references/platform-boundaries.md。
不要把普通 React/Next.js 开发、安装其他 Skill、调用已安装专家或未经授权的部署当作本 Skill 的工作。
Compact release boundary
这是受限平台的 active-only 压缩发行版,仅包含 16 个稳定默认模板。完整版保留全部 81 个源项目模板、experimental 路由和逐模板审计证据;如用户明确需要实验模板,应切换到完整版,不要把本压缩包解释为完整模板库。