# 章节内容生成器 **版本：** 0.05 ## 概述该技能为各个教科书章节生成详细的教育内容，将章节大纲（标题、摘要、概念列表）转化为具有适当阅读水平、丰富视觉元素和互动组件的综合学习材料。该技能设计为在“book-chapter-generator”技能创建章节结构后运行。 **版本 0.05 功能：** * **顺序执行** \- 一次生成一章内容以避免过多的令牌使用。用户可以使用“使用并行执行”阶段来覆盖此设置，但该技能会警告他们将使用 38% 的额外令牌 ## 何时使用此技能在以下情况下使用此技能： * `book-chapter-generator` 技能创建了带有index.md 文件的章节目录 * 章节index.md包含：标题、摘要和涵盖的概念列表 * 需要生成详细章节内容 * 内容应适应特定的阅读水平（初中、高中、大学、研究生） * 需要丰富的非文本元素（图表、MicroSims、信息图表）在以下情况下请勿使用此技能： * 章节结构尚未创建（首先使用 `book-chapter-generator`） * 内容已存在，只需编辑（直接使用编辑工具） * 生成其他类型的内容（提示、术语表等） * 用户的代币几乎用完（超过 95% 在 5 小时内使用） ## 执行模式 ### 顺序模式（所有用例的默认模式） * 由于并行模式的开销很大，一次总是只做一章 * 等待一章完全完成并记录会话，然后再开始下一章 * 清楚地向用户指示每章何时完成 ### 并行模式（仅根据要求）仅当用户明确请求并行执行时才应使用并行模式。警告用户并行执行将产生大量的代币惩罚。 ### 单章模式用于： * 大纲修改后更新一章 * 批量生成前测试内容格式 ## 工作流程 ### 第 1 阶段：设置（顺序）此阶段在任何内容生成之前运行一次，读取所有代理所需的共享上下文。 #### 步骤 1.1：捕获日志记录的开始时间日期 "+%Y-%m-%d %H:%M:%S" >>logs/ch-{NN}-content- Generation.md 其中 {NN} 是用零填充的两位数章节号。记录会话报告的开始时间。 #### 步骤1.2：指示技能运行通知用户：“章节内容生成器技能 v0.05 在 [并行/顺序] 模式下运行。” #### 步骤 1.3：读取共享上下文为所有代理读取并缓存这些文件： 1. **课程描述** (`docs/course-description.md`) * 提取目标受众和阅读水平 * 注意项目 CLAUDE.md 中的课程目标和语气指南 * 识别 CLAUDE.md 项目中的任何吉祥物或叙事元素（例如微积分中的 Delta） 2. **学习图**（`docs/learning-graph/learning-graph.csv`或类似文件） * 加载具有依赖关系的概念列表 * 了解教学顺序的概念关系 3. **术语表** (`docs/glossary.md`) * 加载术语定义以获得一致的术语（如果存在） * 在大多数情况下，术语表是在内容生成后创建的 * 注意哪些概念有术语表条目 4. **项目 CLAUDE.md** （如果存在） * 加载项目特定指南 * 注意任何吉祥物规格、色调要求或特殊格式 5. **章节列表**（扫描`docs/chapters/`目录） * 枚举所有章节目录 * 确定哪些章节需要内容生成（有大纲但没有内容） #### 步骤 1.4：确定阅读水平从课程描述中提取年级阅读水平： **阅读水平指标：** *“小学”、“小学”、“1-6年级”、“小学” → 小学 *“初中”、“初中”、“7-9年级”、“中学” → 初中 *“高中”、“高中”、“10-12年级”、“高中” → 高中 *“学院”、“本科”、“学士”→学院 *“研究生”、“硕士”、“硕士”、“硕士”、“博士”、“博士” → 研究生 **阅读水平特征：** * **小学（1-6年级）：** 非常句子（10-14个单词）、常用词汇、具体例子、常见的视觉教具 * **初中（7-9年级）：** 简单句子（12-18个单词）、常用词汇、具体例子、常用视觉教具 * **高中（10-12年级）：** 混合句子复杂性（15-22个单词）、带定义的技术词汇、具体与抽象的平衡 * **学院：** 学术风格（18-25字）、技术术语、案例研究、研究背景 * **毕业生：** 复杂的散文（20-30+字）、完整的行话、理论深度、研究文献如果未指定，默认为 10 级（高中）。 #### 步骤 1.5：计划章节批次（并行模式）将章节分成批次进行并行处理： **批量大小指南：** * 4-8章：2名特工（每人2-4章） * 9-15章：3-4名特工（每人3-4章） * 16-24章：4-6名特工（每人4-5章） * 25 个以上章节：5-6 个特工（每个特工 5-6 个章节） **23 章示例：** Agent 1：第 1-4 章（基础） Agent 2：第 5-8 章（核心概念第 1 部分） Agent 3：第 9-12 章（核心概念第 2 部分） Agent 4：第 13-16 章（应用第 1 部分） Agent 5：第 17-20 章（应用第 2 部分） Agent 6：第 21-23 章（高级主题） ### 第 2 阶段：内容生成（并行或顺序） #### 并行执行使用任务工具同时生成多个任务代理。每个代理收到： 1. **共享上下文**（课程信息、阅读水平、术语、语气指南） 2. **指定章节**（具体章节目录） 3. **内容格式模板**（本技能的标准格式） 4. **输出指令**（将内容写入各章节的index.md） **代理提示模板：** 您正在为智能教科书生成教育内容。生成以下章节的详细章节内容。课程背景： - 课程：[课程名称] - 目标受众：[受众] - 阅读水平：【水平】-【特点】 - 语气：[课程描述或 CLAUDE.md 中的语气指南] 内容指南： - 不含非文本元素的纯文本不超过 4 段 - 使用不同的元素类型（列表、表格、图表、MicroSims） - 按教学顺序呈现概念（从简单到复杂） - 在适当的情况下包括 LaTeX 方程（反斜杠分隔符：`` 用于内联，`\[ \]` 用于显示）非文本元素： - Markdown 列表和表格：直接嵌入（前面有空行） - 图表、MicroSims、信息图表：使用带有 #### 图表的

块：标题要处理的章节： [列出带有完整路径的特定章节目录] 每章： 1.阅读章节index.md文件以获取标题、摘要和所涵盖的概念 2.生成综合内容（3000-5000字） 3. 每章包含 4-6 个非文本元素 4. 验证“涵盖的概念”列表中的所有概念均已得到解决 5.将内容写入docs/chapters/[chapter-dir]/index.md 元数据格式（添加到每个文件的顶部）： --- 标题：[章节标题] 描述：[简短描述] generated_by：克劳德技能章节内容生成器日期：[YYYY-MM-DD HH:MM:SS] 版本：0.04 --- 完成后报告： - 章节名称 - 字数统计 - 非文本元素（列表、表格、警告、图表、MicroSims） - 涵盖的概念（X 或 Y） #### 顺序执行对于顺序模式或少于 4 个章节，请按照以下每章步骤一次处理每一章。 ### 第 2 阶段步骤（每章 - 由代理或顺序模式使用） #### 步骤 2.1：验证章节文件是否存在验证章节文件是否存在并且具有所需的元素。 **预期输入格式：** * 章节名称：“01-intro-to-itil-and-config-mgmt”或“第 1 章” * 完整路径：“/docs/chapters/01-intro-to-itil-and-config-mgmt/index.md” * 相对路径：“chapters/01-intro-to-itil-and-config-mgmt/index.md” **章节目录结构：** /docs/chapters/NN-小写-名称/index.md 其中： * `NN` = 带前导零的两位数章节号（例如，“01”、“07”、“12”） * `lowercase-name` = URL 友好的小写名称，带破折号，无空格 **启动并行代理：** 仅当用户请求并行执行时才会执行此操作。使用任务工具在一条消息中进行多次调用来并行运行代理： [代理 1 的呼叫任务工具：第 1-4 章] [代理 2 的呼叫任务工具：第 5-8 章] [Agent 3 的呼叫任务工具：第 9-12 章] [Agent 4 的呼叫任务工具：第 13-16 章] [特工 5 的呼叫任务工具：第 17-20 章] [Agent 6 的呼叫任务工具：第 21-23 章] **重要：** 所有任务工具调用必须位于单个消息中才能并行执行。如果以单独的消息发送，它们将按顺序运行。 #### 步骤 2.2：验证章节大纲打开章节文件并检查所需的元素。 **所需要素：** 1.标题1中的**标题**（#标题） 2. 2 级标题中的**摘要**（## 摘要） 3. **涵盖的概念**位于第 2 级标题（## 涵盖的概念）中，并带有编号列表 **行动：** 1.解析章节index.md文件 2. 摘录： * 章节标题 * 摘要文字 * 涵盖的概念列表（编号列表） 3. 如果缺少任何元素，请跳过章节或要求用户提供内容 4. 存储概念列表以供步骤2.5中验证 #### 步骤 2.3：添加元数据将元数据添加到索引文件的顶部： --- 标题：章节标题描述：标题的简短描述 generated_by：克劳德技能章节内容生成器日期： YYYY-MM-DD HH-MM-SS 版本：0.04 --- ####步骤2.4：生成详细的章节内容根据章节大纲、概念列表和阅读水平生成全面的教育内容。 **内容生成原则：** 1. **阅读水平适配：** * 应用适当的句子复杂性、词汇和解释风格 * 具体指南请参阅 `references/reading-levels.md` 2. **概念排序：** * 先介绍简单概念，最后介绍复杂概念 * 遵循自然的教学进展 * 不一定遵循“涵盖的概念”列表中的顺序 * 以先前解释的概念为基础 3. **非文本元素：** * 目标：不超过 3 段不含非文本元素的纯文本。 * 使用不同的元素类型（不要重复相同的类型）。 * 特别关注交互元素（信息图表、MicroSims）。 * 适当时，使用反斜杠分隔符在 LaTeX 中渲染方程： * 内联数学：`$equation $` 用于句子内的方程 * 显示数学：“\[方程\]”用于在自己的行上显示独立方程 * 不要使用美元符号分隔符（`$` 或 `$$`） * 请参阅参考资料中的 math-equations.md 文件，了解方程的正确格式。 **非文本元素类型：** 直接嵌入 markdown 中的元素（无 `

` 块）： 1. **Markdown 列表**（项目符号或编号）- 始终在列表前放置空行 2. **Markdown 表格** \- 始终在表格前放置空行需要图表标题和 `

` 规范块的元素： 3. **图表/绘图** \- 系统架构、关系、数据流 4. **交互式信息图表** \- 可点击的概念图、渐进式披露、悬停，工具提示中出现的定义与术语表一致 5. **MicroSims** \- 带交互式控件的 p5.js 模拟 6. **图表** \- 带有定量数据的条形图、折线图、饼图 7. **时间线** \- 历史进程、连续事件 8. **地图** \- 带移动箭头的地理分布 9. **工作流程图** \- 带有悬停文本的业务流程 10. **图数据模型** \- 使用 vis-network 的实体关系 11. **因果循环图** \-用于系统思考和解释因果关系对于每个 `

` 块元素，使用以下结构： #### 图：[简短描述性标题] <详细信息markdown =“1”>

[简短描述性标题]

类型：[元素类型] **sim-id:** [kebab-case-directory-name]
**库：** [p5.js | vis-网络| Chart.js |美人鱼 |阴谋 |传单|可见时间线]
**状态：** 指定 [详细规范遵循参考文献/content-element-types.md 中的指南] 实施：[技术/方法] 这三个结构化字段支持通过批处理实用程序进行机器可读的提取： * **sim-id** — kebab-case 目录名称（例如，`angle-type-explorer`），由 `extract-sim-specs.py` 使用 * **Library** — 用于通过 `generate-sim-scaffold.py` 选择 CDN 的 JavaScript 库 * **状态** — 初始生命周期状态（对于新规范始终为“指定”）不要缩进 `

` 块中的任何文本。不要在 `

` 块内的换行符上放置任何前导空格或制表符。确保将带有前缀“#### 图：”的 4 级标题放在详细信息之前。这是必需的！ **规格要求：** * 足够详细，其他技能或开发人员无需额外上下文即可实施 * 包括所有视觉元素、数据、标签、颜色、交互 * 指定画布尺寸、布局、默认参数 * 指定视觉元素必须具有响应式设计，必须响应窗口调整大小事件 * 对于 MicroSims：描述学习目标、控制、视觉元素、行为 * 请参阅 `references/content-element-types.md` 了解每种元素类型的完整规范指南 **内容结构：** 1. 从连接章节摘要的介绍性段落开始 2. 按教学顺序呈现概念（从简单到复杂） 3. 自然地融入非文本元素 4.经常使用markdown列表和表格（前面有空行） 5. 包含复杂视觉/交互元素的 `

` 块 6. 在每个“详细信息”块“#### 图：[图名称]”之前放置一个 4 级 Markdown 标题 7. 以总结或要点部分结尾 **互动元素强调：** * 优先考虑能够实现以下功能的 MicroSims 和信息图表： * 学生互动跟踪 * 进度衡量 * 个性化内容推荐 * 每个互动元素应有明确的 **学习目标：** * 当您描述学习目标时，请参考 2001 Bloom 分类法的一部分： * **记住：** 回忆事实、术语、基本概念和答案，但不一定理解其含义。 * **理解：** 解释想法或概念，通过总结或重新表述信息来展示理解力。 * **应用：** 使用所获得的知识来解决新的或不熟悉的情况下的问题。 * **分析：** 将信息分解为多个部分，以了解其结构和关系，并进行比较。 * **评估：** 根据设定的准则或标准对信息做出判断，需要批判性思维和论证。 * **创造：** 通过组合元素形成新颖的整体或解决方案来制作新的或原创的作品。 #### 步骤 2.5：验证完整性生成章节内容后，验证是否已涵盖所有概念。 **验证过程：** 1.查看生成的内容 2. 检查“涵盖的概念”列表中的每个概念是否出现在内容中 3. 创建一个清单，显示涵盖了哪些概念 4. 如果缺少任何概念： * 添加涵盖这些概念的内容 * 将它们自然地整合到现有结构中 5. 使用完整的生成内容更新章节index.md文件 6. **绝对确定**内容已写入章节index.md 文件。进行字数统计，以确保 **所有** 内容都存在并且 TODO 已被删除。 **行动：** * 将“TODO：生成章节内容”占位符替换为生成的内容 * 保留现有的标题、摘要、概念列表和先决条件部分 * 在先决条件部分后添加新的详细内容 ### 第 3 阶段：聚合（顺序执行，并行代理完成后）所有并行代理完成后，汇总结果。 #### 步骤 3.1：收集代理结果等待所有任务代理完成。从每个收集： * 创建/更新的章节文件列表 * 每章统计（字数、非文本元素、涵盖的概念） * 遇到的任何错误或问题 #### 步骤 3.2：生成摘要报告创建所有内容生成的摘要： # 章节内容生成报告生成时间：YYYY-MM-DD 执行模式：并行（6个代理）挂钟时间：X 分钟 Y 秒 ## 总体统计 - **总章节：** 23 - **总字数：** ~100,000 - **每章平均字数：** ~4,350 - **非文本元素总数：** ~115 ## 执行总结（并行模式） |代理|章节|话|元素|时间 | |--------|----------|--------|---------|------| |代理1 | 1-4 | 1-4 17,200 | 17,200 20 | 3m 15 秒 | |代理2 | 5-8 | 18,100 | 18,100 22 | 22 3m 42 秒 | |特工3 | 9-12 | 17,800 | 17,800 19 | 19 3 分 28 秒 | |特工 4 | 13-16 | 18,500 | 21 | 21 3m 51 秒 | |特工 5 | 17-20 | 17-20 17,900 | 17,900 18 | 18 3 分 33 秒 | |代理 6 | 21-23 | 21-23 13,200 | 13,200 15 | 15 2米45秒| ## 每章摘要 |章|话|列表 |桌子|图表|微模拟|概念 | |--------|--------|--------|--------|---------|------------|------------| | 1. 基础 | 4,200 | 6 | 3 | 2 | 1 | 15/15 ✓ | | 2. 限制 | 4,500 | 5 | 2 | 3 | 2 | 14/14 ✓ | | ... | ... | ... | ... | ... | ... | ... | #### 步骤 3.3：捕获结束时间并写入会话日志捕获结束时间：日期“+%Y-%m-%d %H:%M:%S” 将会话信息导出到“logs/chapter-content-generator-YYYY-MM-DD.md”： # 章节内容生成器会话日志 **技能版本：** 0.04 **日期：** YYYY-MM-DD **执行模式：** 并行（6个代理） ## 时间安排 |公制|价值| |--------|--------| |开始时间 | YYYY-MM-DD HH:MM:SS | |结束时间 | YYYY-MM-DD HH:MM:SS | |已用时间| X 分钟 Y 秒 | ## 代币使用 |相|预计代币 | |--------|------------------| |设置（共享上下文）| 〜20,000 | |特工 1（第 1-4 章）| 〜80,000 | |特工 2（第 5-8 章）| 〜80,000 | | ... | ... | |聚合| 〜5,000 | | **总计** | 〜500,000 | ## 结果 - 总章节：N - 总字数：~X - 所有章节均已成功编写：是/否 ## 文件创建/更新 [列出所有章节index.md文件] #### 步骤 3.4：通知用户通知用户： “章节内容生成器 v0.04 完成！ * **模式：** 并行（6 个代理） * **经过的时间：** X 分钟 Y 秒 * **已处理章节：** 23 * **总字数：** ~100,000 * **非文本元素：** ~115 所有章节内容均已写入各自的index.md 文件中。会话记录到“logs/chapter-content-generator-YYYY-MM-DD.md”” ## 资源此技能包括提供内容生成详细指南的参考文件： ### 参考文献/content-element-types.md 所有非文本元素类型的综合规范（上面的 3-11）。包括： * 何时使用每种元素类型 * 规格所需信息 * 实施方法 * `

` 块格式的示例规范 * 在每个“details”元素之前放置一个 4 级图表标题 #### 图：[图名称] 生成内容时加载此参考，以确保图表、MicroSims、信息图表、图表、时间线、地图、工作流程和图形模型的正确规范。 ### 参考文献/阅读水平.md 使内容适应不同阅读水平的详细指南。包括： * 句子结构和长度指南 * 词汇选择 * 解释风格 * 示例复杂性 * 假设的背景知识 * 每个级别的示例文本在确定如何以适当的阅读级别编写内容时，请加载此参考。 ## 最佳实践 1. **始终阅读引用：** 在生成内容之前加载 `references/content-element-types.md` 和 `references/reading-levels.md` 2. **维护空行：** 始终在 Markdown 列表和表格之前放置空行（MkDocs 要求） 3. **教学顺序：** 不要受到概念列表顺序的限制 - 以最有效的顺序教授概念 4. **视觉多样性：**混合不同类型的非文本元素，而不是重复使用相同类型 5. **强调互动：** 优先考虑能够跟踪学生参与度的 MicroSims 和信息图表 6. **详细规范：** 使 `

` 块足够全面，无需额外上下文即可实现 7. **概念整合：** 将概念自然地编织在一起，而不是将它们视为孤立的主题 8. **适当的深度：** 解释深度与阅读水平相匹配（初中多一些脚手架，研究生多一些理论） 9. **验证：** 始终检查“涵盖的概念”列表中的所有概念是否出现在生成的内容中 10. **一致的风格：** 在整章中保持一致的语气、术语和视觉风格 11. **并行执行：** 当处理4个以上章节时，始终使用并行模式以提高效率 12. **真实时间戳：** 始终使用实际系统时间戳，切勿合成数据 ## 要避免的常见陷阱 **内容质量：** * ❌ 超过 3 个段落且不含非文本元素 * ❌重复使用相同的元素类型 * ❌ “涵盖的概念”列表中缺少概念 * ❌ 内容对于阅读水平来说太高级或太简单 **格式：** * ❌ 列表或表格前缺少空行 * ❌ 缩进 `

` 块内的内容 * ❌ 详细信息块之前缺少“#### 图：”标题 * ❌ 缺少结束`

`标签 **并行执行：** * ❌ 在单独的消息中发送任务调用（按顺序运行） * ❌ 聚合前不等待所有代理 * ❌ 忘记汇总所有代理的统计数据 * ❌ 使用合成时间戳代替真实时间戳 ## 输出文件摘要 **必填（每章）：** 1.章节内容：`docs/chapters/[章节名称]/index.md` **推荐（总体）：** 2\. `logs/chapter-content-generator-YYYY-MM-DD.md` \- 带计时的会话日志 **可选：** 3\.包含每章统计数据的摘要报告 ## 会话示例 ### 并行模式（默认） **用户：**“生成所有章节的内容” **克劳德（使用此技能）：** 1. 捕获开始时间 2. 通知：“章节内容生成器技能 v0.04 以并行模式运行。” 3. 阅读共享上下文（课程描述、学习图、术语表、CLAUDE.md） 4. 确定阅读水平（例如高中） 5.扫描章节目录，找到23个需要内容的章节 6. 计划批次：6 个特工，每个约 4 章 7. 在一条消息中生成 6 个任务代理（并行执行） 8.等待所有代理完成 9. 汇总所有代理的结果 10.捕获结束时间 11.写入会话日志 12. 报告：“章节内容生成器 v0.04 完成！模式：并行。时间：18m 32s。章节：23。字数：~100,000。” ### 顺序模式 **用户：**“仅生成第 3 章的内容” **克劳德（使用此技能）：** 1. 读取共享上下文 2. 验证第 3 章文件是否存在以及所需的元素 3. 确定阅读水平 4. 生成综合内容（~4,000字） 5. 包含 4-6 个非文本元素 6. 验证涵盖的所有概念 7.将内容写入章节index.md 8. 报告：“为第 3 章生成的内容。字数：4,200。元素：5。概念：15/15。” ## 报告示例 ✅ 章节内容生成成功！章节：01-itil-and-config-mgmt 介绍阅读水平：研究生内容长度：~3,500 字非文本元素： - 6 个降价列表 - 3 个降价表 - 2张图（CMDB架构、ITIL流程） - 1 个交互式时间线（ITIL 演变） - 1 个 MicroSim（配置漂移模拟器） - 1 个工作流程图（变更管理流程）交互元素：2（时间线、MicroSim）所需技能：2（用于 MicroSim 的 microsim-p5、用于时间线的信息图表生成器）涵盖所有 20 个概念：✓ !!!注意为了使警告发挥作用，您的 mkdocs.yml 必须启用警告和 pymdownx.details。

章节内容生成器

包含技能