技能介绍

它解决什么问题

AI 直接生成的长文档，堆在聊天窗口里很快就会失去可读性。一份超过百行的 RFC、架构说明或代码评审，纯 Markdown 渲染时层级变平、密度下降，读者无法快速跳转、搜索，也很难分享出去。这个技能负责把这类长文档转成单文件 HTML：浏览器直接打开，带目录、搜索、代码复制等轻量交互，同时保留原文的结构。

核心能力与工作流程

分类与路由：输入 Markdown 后，先跑 doctype_classifier.py 做确定性分类，再由 route_explainer.py 决定交给哪个转换子技能。信号来自文件名和内容特征，例如出现 ## Table of Contents、Markdown 表格、> [!NOTE] 提示块会指向 md-document；包含 diff 块则指向 md-review；以 --- 分页或 H1 节奏明显的会指向 md-slides。
三条转换通道：md-document 输出带粘性目录、折叠块、搜索、代码复制和滚动高亮的文档页；md-review 输出双栏 diff 加严重程度批注；md-slides 输出支持方向键翻页、演讲者模式和打印为 PDF 的幻灯片。渲染全部由子技能脚本完成，编排器不手写 HTML。
预处理检查：低于 100 行时直接拒绝，并建议保留 Markdown；未初始化设计系统（~/.config/markdown-html/design-system.json 不存在）时拒绝运行；输出目录不可写时也会中止。
交付方式：转换完成后返回一段不超过 100 词的摘要，包含输入行数、输出路径、应用的设计风格和主要特性，随后向用户提出一个需要确认的问题，例如目标读者是在略读还是在做决策。

适用边界

输出是单个自包含 HTML 文件，依赖 Google Fonts CSS 和 Prism.js CDN，不包含多文件站点、构建步骤或本地服务。它不做落地页生成，不做交互式提示词调试，也不做 PDF 转换——幻灯片是通过浏览器打印生成 PDF 的。默认不会覆盖同名文件，冲突时会追加 -2、-3 后缀。不要在分类结果未确定前调用子技能，也不要把两个子技能串在一起连续执行。