SuperAPI AI 工具集

markdown-html-orchestrator

前端与建站

查看项目

更新于 10-16 04:59

技能介绍

用途:把项目中较长的 Markdown(规格、方案、评审、讲解等)转换为单文件、浏览器原生、可分享且带轻交互的 HTML,以恢复长文的分层与信息密度。

主要能力:编排器在 forked 上下文中确定性地分类输入 Markdown,并路由到三类转换子技能——md-document(长文文档)、md-review(含 diff 的代码评审)、md-slides(幻灯片);同时调用 design-system(首次需 onboarding,生成品牌字体与配色等共享 token)。路由依据“两信号阈值”:文件名提示 2 分、每条内容信号 1 分,胜出者 ≥3 且(次选为 0 或胜出者 ≥2×次选)时静默路由,否则提一个带推荐答案的澄清问题。输出为自包含 HTML,支持 sticky 目录、折叠、搜索、代码复制、滚动定位、两栏 diff、方向键导航与打印等(随类型不同)。

使用方式:先运行一次 onboarding,再执行分类与路由管道。必要命令示例: python3 markdown-html/skills/design-system/scripts/onboard.py python3 markdown-html/skills/markdown-html-orchestrator/scripts/doctype_classifier.py --input <path>.md --output json | python3 markdown-html/skills/markdown-html-orchestrator/scripts/route_explainer.py python3 markdown-html/skills/markdown-html-orchestrator/scripts/output_path_resolver.py --input <path>.md --doctype <document|review|slides> 输出路径冲突默认追加 -2/-3 后缀,--on-collision timestamp 可改为时间戳;渲染由各子技能的脚本完成,不要手动生成 HTML。

适用场景:将长规格、RFC、报告、PR 说明、代码评审、演示稿转为单文件 HTML。

限制:输入低于 100 行会被拒绝;design-system 未 onboarding、保存位置不可写时拒绝;仅支持单文件输出,无多文件站点、构建步骤或实时监听;外部依赖限于 Google Fonts CSS 与 Prism.js CDN;不生成落地页、静态站点或 PDF(幻灯片依靠浏览器打印);不默认覆盖已有文件。