分步教程单页生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_909957f0/tutorial-website-builder。
技能介绍
要解决什么问题
很多操作类教程最后会变成「长文 + 一堆截图」,读者很难对齐当前步骤、该做什么和怎样算做完。若还要统一视觉风格,从参考图手写 CSS 又费时,且容易堆出「卡片套卡片」的嵌套布局,反而干扰阅读。
本技能面向两类连贯工作流:把参考图的视觉语言沉淀成可复用的风格提示词,再据此生成单文件、分页的 HTML 教程页——首屏直接进入教程内容,而不是营销落地页。
技能如何工作
工作流 A:从图片提取风格
- 按
references/style-extraction-schema.md分析布局、字体、配色、组件、间距与响应式倾向,填成可复用的风格系统(不是复述图片)。 - 以视觉语言命名(小写连字符英文文件名),保存到
references/styles/*.md。 - 含受保护 Logo、角色或版权素材时,只抽取通用视觉系统,不要求复刻专有元素。
工作流 B:生成教程 HTML
- 在
references/default-ui-system.md与references/styles/中选风格;未指定时会简短询问(含默认项)。 - 结合
references/production-guide.md与用户提供的步骤文案、images/、videos/、外链,按真实执行顺序分页:每页聚焦一个动作,写清目标、操作与可观察的成功条件;媒体放在说明之后作校验。 - 输出单 HTML:顶部唯一导航(当前页 + 上/下页)、
data-step与totalSteps、全局连续图号(图 1、图 2…)、可点击放大图片、移动端单列。
三条底层规则始终优先于具体风格:禁止卡片嵌套卡片;装饰图形必须有明确用途否则省略;教程可读性优先(步骤、动作、原因、校验媒体、成功标准必须易找)。
适用边界与注意点
- 提取风格时,除非用户同时要求,不会自动生成教程 HTML。
- 生成前可简短确认是否覆盖风格默认值;用户未改则按选定风格继续,避免反复追问。
- 素材路径默认指向
images/、videos/;本地打开 HTML 即可用,交付前会做导航禁用、图号、链接target="_blank"与移动端横向滚动等质量检查。
使用场景
- 产品或运维要把「点哪里、看到什么」写成可离线打开的分页教程,并配上 `images/` 里的逐步截图。
- 设计给了参考界面图,需要先沉淀成可复用的风格提示词,再批量生成同一视觉体系的教程 HTML。
- 把现有长文档拆成按执行顺序的一页一动作,每页写清成功条件,视频放在说明后作操作校验。
- 开源项目或内部工具需要教程站首屏即进入步骤,而不是营销首页式的单页落地。
适合人员
- 负责编写软件操作手册的技术写作者,希望输出单文件 HTML 且步骤与图号全局连续
- 内部培训同事要把录屏与截图整理成学员可跟做的分页教程,并统一参考图的版式风格
- 前端或设计支持同学接到「按这张参考图做教程页」的需求,需要先抽风格再生成可本地打开的页面
- 维护知识库的运营,要把外链、官方文档与逐步截图嵌进正文,且移动端阅读不丢导航与步骤顺序