tutorial-guide

教程指南生成技能

为用户生成风格统一、内容完整、专业精美的新手教程指南，输出为 .docx Word 文档。

触发条件

用户提供：

• 主题名称（必填）：如"微信小程序开发"、"Superpowers 完全新手教程"
• 参考链接（可选）：官方文档、视频、文章等
• 二维码图片（已内置）：公众号/视频号二维码存于 assets/ 目录，无需用户提供

---

输出规范

• 格式：.docx Word 文档 + .md Markdown 文档（同时生成）
• 文件名：[主题名]-完全新手指南.docx / [主题名]-完全新手指南.md
• 保存路径：默认写入当前工作目录所属的 kj-llm-wiki 仓库下的 raw/papers/
  • 例如当前工作目录是 /Users/didi/ai_space/kj-llm-wiki，输出到 /Users/didi/ai_space/kj-llm-wiki/raw/papers/
  • 例如当前工作目录是 /Users/chengkangjian/Library/Mobile Documents/iCloud~md~obsidian/Documents/kj-llm-wiki，输出到该目录下的 raw/papers/
  • 如需临时指定输出目录，可在运行脚本时设置环境变量 TUTORIAL_GUIDE_OUTPUT_DIR
• 使用 docx npm 包生成，脚本保存到 skills/tutorial-guide/scripts/gen_[主题名].js
• 脚本中同时生成 .docx 和 .md 两个文件到同一目录

---

文档结构（顺序固定）

1. 封面页

• 主标题：[主题名称] 完全新手指南（居中，36pt，粗体，深蓝色 #1a73e8）
• 副标题：从零开始，手把手带你入门（居中，18pt，灰色 #5f6368）
• 作者：作者：[公众号名]（居中，14pt）
• 日期：当前日期（居中，12pt，灰色）
• 封面后插入分页符

2. 目录页

• 标题"目录"（居中，Heading1 样式，深蓝色）
• 手动构建目录条目（禁止使用 TableOfContents 组件——该组件需在 Word 中手动更新域才能显示，直接打开时目录为空）
• 目录条目格式：前言、第一章 XXX、第二章 XXX … 每行一个条目，使用普通段落（Normal 样式），字体 13pt，左对齐，行间距适中
• 目录后插入分页符

手动目录段落示例：

// 目录条目示例（根据实际章节列表逐条生成）
new Paragraph({
  children: [
    new TextRun({ text: "前言", size: 26, font: "Arial" }),
    new TextRun({ text: "\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t3", size: 26, font: "Arial", color: "888888" })
  ],
  spacing: { before: 80, after: 80 }
}),
new Paragraph({
  children: [
    new TextRun({ text: "第一章  概念介绍与核心原理", size: 26, font: "Arial" })
  ],
  spacing: { before: 80, after: 80 }
}),
// ... 以下按实际章节逐条手动列出

⚠️ 注意：页码可写固定占位（如省略或标注"—"），但章节名称必须与正文标题完全一致，目录条目必须完整列出所有章节和小节标题。

3. 前言

• Heading1："前言"
• 正文介绍：这个工具/技术是什么、能解决什么问题、适合哪些读者

4. 正文章节（5-15 章，根据主题内容量合理设计）

章节数量规则：

• 简单工具/入门主题：5-8 章
• 中等复杂度开发框架：8-12 章
• 综合性平台/语言：10-15 章

每章必须包含：

• Heading1：第X章 [章节名]
• Heading2：各小节（每章至少 2-3 个小节）
• 锚点开场：用具体场景/问题/反常识提问引入，禁止"本章介绍……"
• 正文段落：说人话、短句优先，步骤具体可操作，不水字数
• 可验证的易错点：至少 1 个有来源或可复现的常见错误，写出触发条件、具体报错或误区表现
• 有序/无序列表（使用 numbering config，禁止手动插入 bullet 符号）
• 代码块（Courier New 等宽字体 + 浅灰背景段落，代码必须可直接运行）
• 提示框（带边框底色段落，前缀：💡小贴士 / ⚠️注意 / ✅最佳实践）