该技能用于起草课程单节课内容,目标是让多节课读起来不雷同,并输出可直接粘贴进课程平台编辑器的干净 HTML。它把引擎(章节多样性、过程规则、HTML 输出)写在本文件中,把语气(措辞、立场、表达方式)放在可替换的 voice-profile.md 中。
用法:第 0 步先加载语气档案,优先使用项目根目录或 .claude/ 下的 voice-profile.md,否则读取 ${CLAUDE_SKILL_DIR}/voice-profile.md,用户指定其它档案时以指定者为准,并在正文前用一行说明加载了哪个档案;档案内容优先于本文件规则。第 1 步设定阅读水平,档案未指定时默认 Flesch-Kincaid 阅读难度 60 至 70(约七年级水平)。第 2 步选择课程类型(概念、构建、理念、对比、技术),再从章节调色板中选取 3 至 6 个章节。
主要能力与规则:连续两节课不得使用相同章节顺序,需记录已用顺序;章节类型含钩子、概念定义、为何重要、类比、流程、编号步骤、概念拆解、对比、示例、注意事项、要点、下节衔接、旁白、例外、框架等。类比需融入正文而非单独标题;外部工具与资源必须加超链接;加粗仅用于强调,不构造“术语:描述”列表;列表类型与长度需变化;练习内容集中放在模块收尾页,收尾页格式固定(Try these now、What you built in this module、Share what you made)。
输出为干净 HTML,支持 h2、h3、p、strong、a、ol、ul、code,标题使用句首大写,单节课 HTML 约控制在 3000 字符以内。封禁词包括 delve、作为动词的 leverage、comprehensive、transformative、crucial、破折号、In today's fast-paced world、Moreover、Furthermore、Additionally、In conclusion、In summary 及标题全大写等,完整列表见 references/banned-content.md。
限制:具体价格、版本、截图等需向用户获取,否则模型易编造;单节课超出长度上限通常应拆为两节;本技能默认面向支持上述标签的课程平台,若目标平台用 Markdown 需另行说明。