Agent Skills
返回列表
杂志式长文 HTML

杂志式长文 HTML

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d6cd2792/ed-rich-ai2html。

技能介绍

问题在哪

办公室里常见场景:一份两千字的 .md 或模型输出的长答,大家很难在碎片时间里真正读完。把 Markdown 机械转成「满屏卡片和盒子」的仪表盘式 HTML,往往更吵、更难读。这个技能的目标是把长文变成单文件、可离线打开的杂志式阅读页——有摘要、有稳定的阅读栏宽,必要时用一张图说清结构,而不是堆组件。

技能如何工作

它只产出一种固定版式(暖象牙底、近黑正文、单一陶土色强调、衬线标题 + 无衬线正文、阅读栏约 680px),样式来自 references/house-style.md,并对照 references/example.html 对齐 Anthropic 式输出。

运行前先区分模式:

  • 模式 A:用户给出 .md 路径、@ 引用或粘贴的 Markdown → 同目录、同 basename 输出 .html
  • 模式 B:用户是提问 → 直接生成 HTML,写入当前目录的 answer-{slug}.html

写 HTML 前会先通读全文再定结构,而不是逐条映射 Markdown 元素:

  1. 用一句话结论填顶部的 .tldr
  2. 拆成 3~7 个 <section>,章节够多时可加粘性目录
  3. 对流程、架构、量级对比等更适合空间表达的内容,考虑内联 SVG、时间线或 .stats 条
  4. 其余尽量用普通段落;表格、卡片、.note 只在内容确实需要时使用

页面要求自包含:样式内联、不引外链字体/脚本/图;交互优先用原生 <details>,避免无意义的嵌套盒子。

适用边界

  • 不适合需要每篇文档换一套视觉品牌或多 accent 色的场景;一致性是设计前提。
  • 结构组件有克制上限(例如 .note 建议一页最多一两处),滥用卡片/表格会把 prose 读感弄糟。
  • 生成后应自检:目录锚点与 id 一致、lang 与界面文案语言匹配(如 zh-CN 用「目录/概览」),标题衬线字重、单一强调色是否达标。

使用场景

  • 内部分享会前,把两千字以上的技术方案 `.md` 转成同目录同名 `.html`,方便同事用浏览器一次读完
  • 模型输出的大段 Markdown 复盘稿,需要顶栏 `.tldr`、分节目录和一张架构 SVG 再发给业务方
  • 产品/运营提问后,希望答案直接落盘为 `answer-{slug}.html`,而不是再手工套网页模板
  • Wiki 或 Confluence 导出的长文,要统一成暖色杂志栏宽、无外链依赖的离线 HTML 附件

适合人员

  • 经常把内部规范、复盘写成 Markdown、又要给非工程同事发「能直接打开的一页 HTML」的技术写作者
  • 需要把冗长 AI 答复整理成带摘要与少量结构组件(时间线/统计条),而不是满屏卡片的文档维护者
  • 按 `references/house-style.md` 批量产出风格一致的 HTML,且不接受每篇文档换一套 UI 的知识库管理员
  • 在邮件或 IM 里分发长文说明、希望阅读栏约 680px、自包含无 CDN 的项目负责人