mx-syllabus — 课纲工厂

> 不是从零生成。是用你的课程基因，为新主题搭骨架。

触发条件

当用户输入以下内容时激活此 skill：
- 「做课纲」「生成课纲」「写个课纲」「课程大纲」
- 「帮我设计一门课」「这个主题能做成课吗」
- 「培训方案」「企业内训方案」

核心理念

课纲不是写出来的，是"匹配+填充"出来的。

已有 10+ 门成熟课纲，涵盖了 1天版/2天版/半天分享 三种典型结构。每门课都共享相同的基因：
- 破·立·练·收 隐式框架
- 痛点→框架→案例→工具 节奏
- 4维课程收获 + 6模块结构

本 skill 的核心任务：
1. 理解新课程的主题/受众/时长
2. 从模板库匹配最接近的结构
3. 用新主题填充模板骨架
4. 输出可直接发给客户的课纲

工作流（4步）

第一步：需求澄清

询问/提取以下关键参数：

如果用户无法一次性提供全部参数，逐个追问，不猜测。

参数校验规则

生成课纲前，必须通过以下校验。任一校验不通过，直接向用户指出具体问题，不进入模板匹配：

第二步：模板匹配

根据时长自动选择模板骨架：

匹配逻辑：
- 如果是「管理/战略/经营」主题 → 优先匹配「大课课纲_重构版_2.0」风格（指标驱动、支柱框架）
- 如果是「工具/技能/AI实操」主题 → 优先匹配短课纲风格（场景驱动、实操为主）
- 如果受众是高管/CEO → 加入「决策视角」「ROI思维」「组织层面」的表述
- 如果受众是执行层 → 加入「即学即用」「模板工具」「操作清单」

第三步：内容生成

按模板骨架填充内容，遵循以下规则：

标题公式：
《核心主题》—— 一句话价值承诺

正确示例：
- 《AI辅助供应链管理》—— 用数据替代经验，让库存预测准确率提升40%
- 《AI办公效能提升》—— 掌握AI工具，十倍提升办公效率

课程背景（3段式）：
1. 痛点描述（「大多数XX困在……的窘境中」）
2. 课程解法（「本课程以XX为核心方法论……」）
3. 教学承诺（「课程通过XX教学，帮助学员在X天内……」）

课程收获（4个维度）：
1. 【建立XX思维/认知】
2. 【掌握XX方法/技能】
3. 【学会XX工具/实操】
4. 【带走XX模板/方案】

模块结构（破·立·练·收 隐式渗透）：
- 模块一 = 破（认知重塑、痛点共鸣）
- 模块二~五 = 立+练（方法+实操，交替进行）
- 模块六 = 收（综合实战+成果展示）
- 每模块 3 个子项，形成「讲→练→出」小闭环

禁止事项：
- 正文中禁止出现「破」「立」「练」「收」四个字作为显式标签
- 禁止使用「不是……而是……」句式
- 禁止空洞的「赋能」「升级」「转型」堆砌
- 每句话都要能对应一个具体的教学动作

第四步：质量审查

生成后逐项检查：

• [ ] 破·立·练·收 是否在内容中隐式存在？
• [ ] 模块一是否建立了足够的痛点共鸣？
• [ ] 实操环节占比 ≥ 50%？
• [ ] 每个模块是否有明确的学员输出物？
• [ ] 「其他」段落是否包含：面向对象 / 课程时长 / 授课方式？
• [ ] 课程收获是否具体可验证（不是「提升认知」这种空话）？
• [ ] 是否使用了「不是……而是……」句式？（必须为零）
• [ ] 标题是否包含「——」副标题？

模板文件

输出格式

课纲生成分两个阶段：内容输出 → 格式转换。

阶段一：Markdown 草稿

先将课纲按模板规范生成完整的 Markdown 内容，在对话中展示给用户审阅。

阶段二：Word 文档（.docx）生成

用户确认内容无误后，按以下步骤生成 Word 文档：

1. 保存草稿：将审阅通过的 Markdown 内容保存为临时文件，文件名格式 课纲_{课程主题}_{日期}.md
2. 调用 docx skill：使用 docx skill 读取 Markdown 文件，按以下排版规范转换为 .docx：
   - 大标题（课程名称）：黑体/加粗/居中/小二号
   - 一级标题（课程背景、课程收获等）：黑体/加粗/三号，段前 12pt
   - 二级标题（模块一~六等）：黑体/加粗/四号
   - 正文：宋体/小四/1.5 倍行距
   - 课程收获的四个维度：项目符号列表（黑色实心圆点）
   - 模块内容：编号列表（1. 2. 3.），模块标题加粗
   - 表格（如有）：宋体/五号/单倍行距，表头加粗居中
3. 确认输出：生成 .docx 后告知用户文件路径，同时展示完整课纲摘要供快速审阅

Word 生成异常处理：
- 若 docx skill 不可用 → 直接输出 Markdown 草稿，并提示用户：「Word文档生成需要 docx skill，当前不可用。上方是完整的 Markdown 格式课纲，你可以直接复制到 Word 中，手动设置标题样式即可。」
- 若转换过程报错 → 重试 1 次；仍失败则输出 Markdown 并说明原因
- 若生成的 .docx 排版异常 → 提示用户可以手动调整，并列出需要检查的样式项

迭代机制

每次使用后，如果用户对课纲做了修改：
1. 记录修改点（用户改了哪里、为什么改）
2. 判断是否需要更新模板（改动≥3次同类修改 → 更新模板）
3. 将典型课纲存入 examples/ 目录作为新参考样本

边缘场景处理（Edge Case Handling）

> 通用兜底原则：识别 → 降级 → 透明 → 确认
> 1. 识别偏离正常流程的信号
> 2. 找到最近的可用方案降级执行
> 3. 向用户透明说明发生了什么、为什么降级
> 4. 让用户确认是否接受降级方案，或选择暂停

第一步（需求澄清）边缘场景

第二步（模板匹配）边缘场景

第三步（内容生成）边缘场景

第四步（质量审查）边缘场景

跨阶段边缘场景

错误恢复机制

参考文档

• 常见问题（FAQ）: 遇到报错或不确定怎么用？先看 FAQ.md
• 完整课纲示例: 想看成品效果？参考 examples/short-course-example.md（1天版）和 examples/long-course-example.md（2天版）
• 模板详情: templates/ 目录下含短课纲/大课纲/分享大纲三种模板及其填充指南
• 课程基因库: docs/course-dna.md 含 10+ 已有课纲的结构特征分析

已识别模式（来自10+课纲分析）

短课纲基因特征

标题 = 「课纲：{主题}」\n—— {一句话价值}
背景 = {行业痛点} → {课程解法} → {教学承诺}
收获 = 思维 + 方法 + 工具 + 模板（4维固定）
大纲 = 6模块 × 3子项
结尾 = 受众/时长/方式 三要素

大课纲基因特征（以《量化经营·精准决策》为母版）

内核定位 → 学员画像 → 核心框架图 → 分层结构（天→模块→时间×要点）
→ 每模块：教学目标+教学内容+输出物+教学设计要点
→ 差异化总结（对比表）
→ 待确认清单

跨课程通用节奏

痛 → 认 → 框 → 练 → 产
（开场刺痛 → 认知重塑 → 框架讲透 → 动手实操 → 产出带走）