course-generator · v2.9.3 · 2026-08-27 · sha256 f1ffa6217938f7e8
course-generator v2.9.3A
Immutable. This exact content never changes and is served at /api/v1/blob/f1ffa6217938f7e8.
--- name: course-generator homepage: https://github.com/cat-xierluo/legal-skills author: 杨卫薪律师（微信ywxlaw） version: "2.9.3" license: MIT description: 从转录稿或文献生成可独立阅读、可溯源验收的结构化课程，也可在用户明确要求时归档既有课程或从已验证素材提取培训方案。本技能应在用户要“把长转录稿整理成课程”“生成总览和章节”“归档课程”“按受众定制课程方案”时使用。不要用于：仅做 ASR 纠错（用 transcription-corrector）、复盘讲课表现（用 lecture-review）、把多篇文章扩写成书（用 article2book）。 --- # Course Generator v2.9.3 ## 选择模式 生成模式是主入口；归档和提取是显式后续动作，不因生成完成自动触发。 | 模式 | 何时进入 | 必需输入 | 主输出 | |---|---|---|---| | 生成 | 将转录稿、逐字稿或文献整理成课程 | 输入文件/目录、期望输出位置 | `00 + 章节 + course-manifest.json` | | 归档 | 用户明确要求复制/移动到知识库 | 已生成课程、归档根目录、日期/课名 | 已验证的归档副本 | | 提取 | 根据受众、时长和主题组合培训方案 | 需求描述、课程索引、既有课程素材 | 定制课程方案 | 若意图仍不明确，先根据输入判断；会改变文件位置、覆盖策略或课程边界时再追问。原始材料默认只读，生成模式不修改源文件。 ## 共用边界 - **忠实可溯源**：数字、动作、后果、建议和专有名称可回到 `SRC-xxx` 定位；无法定位的内容不写成事实。 - **封闭来源展开**：只把原文已经提供的事实、案例要素、步骤和判断写厚；不借常识补全缩写、参数、产品能力、标准流程、行业案例、商业模式或未来路线。来源只给出设想、举例或保留意见时，正文保留同等语气，不升级为确定方案。 - **高价值素材不得净丢失**：每个确定性 `content block` 都必须进入素材或使用受控理由跳过；但来源块只是盘点单位，不是写作颗粒度。案例、操作、踩坑、取舍和判断技巧应按读者可复用的信息单元拆分并充分展开，再从真实正文取证。“去来源痕迹”只改叙述框架，不连带删素材。 - **读者成品与审计分离**：章节不显示原文区间、素材编号或生成来源；这些信息写入 `course-manifest.json` 和可选审计文件。 - **专名与图片保真**：英文产品名、Skill、命令、文件名保留原写法；正文图片使用 manifest 中的原始 Markdown。 - **客观项脚本验收，语义项人工复核**：验证器检查真实产物，不采信大纲或执行者自报；素材展开质量、跨章逻辑和事实忠实度仍由人工判断。 冲突时依次以忠实/可溯源、读者正文的素材守恒与展开、章节边界、书稿化表达、审计便利为准。不得为了更快填完 manifest 而压缩正文；篇幅只用于发现异常缩水，不作为硬性封顶或独立完成证据。 ## 配置 - **生成模式**不要求 `config/paths.yaml`。优先使用用户指定输出目录；未指定时，在输入目录旁创建新课程目录，并在写入前说明位置。 - **用户词典**可选：复制 [user_dictionary.example.yaml](config/user_dictionary.example.yaml) 为本地 `config/user_dictionary.yaml`。只校正上下文明确的近似误转写，低置信内容保留原文。 - **归档/提取模式**需要路径时，复制 [paths.example.yaml](config/paths.example.yaml) 为本地 `config/paths.yaml`。本地配置由 `.gitignore` 排除。 - 目标目录已存在且含文件时，不静默覆盖；使用用户指定的新目录/版本目录，或先取得覆盖授权。 ## 生成模式 流程：`确定性来源索引 → 逐块素材/图片登记 → 全局大纲 → 总览与章节 → 正文证据回填 → manifest 定稿 → 确定性验收 → 人工复核 → 可选归档` ### 1. 建立确定性来源索引 先运行索引器，不让模型自行决定“哪些段落存在”： ```bash python3 scripts/index_sources.py \ --input <单个来源文件或来源目录> \ --output <课程目录>/source-index.json ``` 索引器按稳定顺序分配 `SRC-xxx` / `BLK-xxxxx`，记录相对路径、来源 SHA-256、行号、块类型和预览。`content block` 是覆盖基线；标题、图片、说话人标签与独立时间戳保留为索引上下文，但不要求建立素材。转录平台附带的“关键词/议程摘要/重点内容/Q&A/PPT 章节标题”在同时存在原始“转录内容”时标为 `derived`：只用于定位，不得作为独立事实或新章节来源。 - 材料能够在保留生成空间的前提下完整进入上下文时，可以直接整体分析。 - 多文件、超长转录或完整读取会挤压生成/复核空间时，使用索引化两遍流程：先按 `BLK-xxxxx` 分批读取并提取素材账本，再基于账本合并全局结构；不要强行一次性塞入全部原文。 - 分块边界不得切断一个连续问答、案例或三步以上操作链；确需切分时保留重叠上下文，并让相邻块引用同一稳定 source ref。 ### 2. 建立素材账本与图片账本 逐块扫描全部 `content block`。每个 `BLK-xxxxx` 必须被一个或多个 `MAT-xxx` 覆盖；每个素材记录类型、摘要、source ref、`source_block_ids`、目标章节或受控 `skip_code`。`MAT-xxx` 的单位是一项可以单独讲清的观点、案例、操作阶段、踩坑、取舍或疑问，不是一个标题下的整节摘要。一个 include 素材最多合并 6 个相邻来源块；出现新的步骤、结果、数字、限制、工具、修正或问答转折时拆成新素材。include 素材在写正文前预先填写 2—5 个 `coverage_terms`，数量至少为 `ceil(source_block_ids 数量 / 2)`（最低 2、最高 5）。每个词必须原样存在于该素材绑定的原始来源块，优先选择步骤、结果、数字、限制或专名；不得发明“范式阶梯”等抽象词再写回摘要与正文，也不得全用 `AI` / `Agent` / `Skill` 类通用词。`source-index.json` 中每个 `kind=image` 的块都必须按原顺序进入 manifest 的 `images`，跨文件连续分配 `IMG-xxx`，原样记录图片 Markdown、source ref、正文动作和目标文档；同一行有多张 Markdown 图片时逐张登记，不得只登记准备插入正文的图片。 素材分类、词典校正、图片价值判断和章节边界细则见 [outline_prompt.md](references/outline_prompt.md)。机器字段必须同步进入 [course-manifest.md](references/course-manifest.md) 定义的 manifest；`98 图片资产表.md`、`99 课程大纲.md` 只作为可选的人类审计视图，不是验证器的数据源。 ### 3. 生成全局大纲 用完整来源索引、素材账本和必要原文片段生成大纲。按主题组织，不机械按文件切章；分流到其他章节的素材仍保留原 source ref 和目标章节。 默认组织为 3—8 章，8 章是验收上限而非建议值；只有用户明确要求更多章节时，才提高 `--max-chapters`。不按原稿标题逐节切章：开班/签到、领导致辞、设备与安装准备、讲者履历默认不得单独成章；其中可复用判断并入总览或核心章，纯会务/设备信息使用受控理由跳过。只有来源本身就是安装或环境配置教程时，准备工作才可成为主题章。结构性薄章优先合并，不从其他章节复制内容凑篇幅。 ### 4. 生成总览 读取 [overview_prompt.md](references/overview_prompt.md)，生成带真实名称的总览文件，例如 `00 法律人 Agent 与 Skill 办案实务 - 总览.md`。方括号示例仅用于说明字段，实际文件名禁止保留 `[课程名称]`、`[主题名称]`、`TBD`、`TODO` 等占位符。结构导览仅在材料确有流程、框架、能力模型或系统关系时加入。总览只插入 manifest 目标为 `OVERVIEW` 的图片。 ### 5. 逐章生成 读取 [chapter_prompt.md](references/chapter_prompt.md)。每章只加载该章的 `material_ids`、`image_ids`、相关 source refs 和必要邻接上下文；长材料模式下不要再次读入全部原文。 先把章节写成读者可独立使用的完整正文，再处理审计字段。每章完成后回扫对应 source refs：案例/操作/踩坑类不应只剩一句概述；正文中的数字、动作、结论和专名能定位；问答自然融入；不把讲者现场行为推广成材料没有的通用建议。不要把 `reader_evidence` 的最低长度当作正文目标，也不要围绕 coverage terms 拼一段“过门禁文字”后收笔。 然后为每个 include 素材回填 `reader_evidence.quotes`：复制目标章节中真实存在的 1—3 段连续摘录；各覆盖词可以分布在不同摘录中，合并后必须覆盖大纲阶段已预承诺的全部 `coverage_terms`。不要为了把所有词塞进单一连续字符串而拼造审计段落。合并证据长度随其覆盖的来源块数量增加；案例、操作、踩坑、取舍、疑问类必须承载一个完整展开片段，不能用标题或一句结论充数。不要在写完后为迎合现有正文改弱 `coverage_terms`。证据只用于定位正文，不替代正文质量判断，也不在读者正文显示素材编号。 ### 6. 保存规范产物 读者成品： - `00 法律人 Agent 与 Skill 办案实务 - 总览.md`（示例；使用本课程真实名称） - `01 从聊天到可执行任务.md`、`02 Skill 的复用边界.md`……（示例；使用真实主题） 实际文件名不得包含说明模板用的方括号，也不得包含 Windows 非法字符 `: * ? " < > |`。 审计产物： - `source-index.json`：强制，由索引器生成，不手写。 - `course-manifest.json`：强制，按 [course-manifest.md](references/course-manifest.md) 保存，并绑定 `source-index.json` SHA-256。 - `98 图片资产表.md`、`99 课程大纲.md`：可选；生成时在 manifest 的 `audit_files` 声明。 课程名称优先取自该项目的对外大纲或报价方案；没有正式课名时再基于素材拟名。生成目录日期不用冒充培训实际举办日期。 ### 7. 运行确定性验收 保存全部产物后运行： ```bash bash scripts/verify.sh <课程目录> --source-root <单个来源文件或来源根目录> ``` 退出码 `0` 才表示客观门禁通过；`1` 表示产物不符合契约，按失败项修改后重跑；`2` 表示目录、运行环境或验证器异常，同样不得交付。脚本最后一行输出机器可读 JSON，并绑定 manifest 与读者文件 SHA-256。 验证器检查：manifest 与来源索引哈希、原始来源 SHA-256、每个 `content block` 的 include/skip 去向、覆盖词是否真实存在于绑定来源块、来源外缩写释义、1—3 段正文证据、include 素材颗粒度、章节文字相对纳入来源的最低深度、默认八章上限、占位符、总览/章节完整性、素材双向映射、源图片全登记、图片精确集合/目标/顺序、图片密集来源的最低代表图与正文图片上限、明显讲者转播口吻、来源框架词和可见审计元数据。v2.9.3 使用 manifest schema `1.2` 与 source-index schema `1.1`；生成验收必须提供 `--source-root`，旧课程需要重建索引并升级 manifest 后再验收。 ### 8. 完成人工语义复核 脚本通过后仍检查： - **素材守恒**：抽查各章 `material_ids`、`source_block_ids`、预承诺 `coverage_terms`、正文证据和跳过项；高价值素材未发生无理由净丢失，也没有用一段泛化文字假覆盖多个具体素材。 - **忠实溯源**：抽查数字、动作链、建议、结果和专名；事实可回原文定位，推断有明显推论语气。 - **封闭来源高风险扫描**：逐项回查缩写释义、技术参数、命令/路径/字段、产品能力、流程承诺、行业案例、商业模式和时间预测；原文未明确给出的删除，不以“行业常识”补齐。 - **跨章一致性**：主题边界清楚、无大段重复、交叉引用章号正确。 - **图片语义价值**：图片位置确实支撑相邻论述，而非只满足数量。 向用户交付时分别报告“脚本验收结果”和“人工复核范围”，不得把客观 PASS 扩大为全量语义正确。 ## 归档模式 仅在用户明确要求归档时执行： 1. 读取课程 manifest；旧课程无 manifest 时按旧命名盘点，并标注为 legacy/未通过 v2.9.3 细粒度验证。 2. 从用户材料确认培训实际日期、正式课名、归档根目录和主办方写法；不要用生成日期替代培训日期。 3. 默认复制，不默认移动；只有用户明确说“移动”时才移走源文件。 4. 目标已存在时不覆盖，先使用新版本目录或请求用户决定。 5. 复制后对目标目录重跑验证；源/目标文件集合或哈希不一致时归档失败。 6. 知识库已有索引且本次归档范围包含索引维护时，再更新索引。 ## 提取模式 读取 [extract_prompt.md](references/extract_prompt.md)，按 `解析需求 → 匹配课程 → 定位已验证素材 → 提取重组 → 输出方案` 推进。 需求至少包含受众、基础水平、培训时长和重点方向。优先使用带 manifest 的课程，从 source refs 追踪素材；只有 raw 转录稿时先走生成模式。既有材料覆盖不了的主题必须标注“需补充素材”，不凭空补课。 ## 权限与隐私 - 只读取用户指定的材料范围，只向用户指定或已说明的本地输出目录写文件。 - 来源盘点会执行 `index_sources.py` 读取用户指定的 `.md` / `.txt` 并写入课程目录下的 `source-index.json`；验收会执行 `verify.sh` / `verify_course.py` 读取课程、来源索引和用户指定的原始来源根目录。脚本不联网、不安装依赖、不修改原始材料。自测脚本仅写入并自动清理系统临时目录。 - 本技能不需要网络、凭证或外部服务。 - 未脱敏转录稿、客户信息和课程材料按最小必要原则处理；公开示例、manifest 模板和变更记录不得写入真实客户信息或本机私有路径。 ## 依赖 ### 系统依赖 | 依赖 | 用途 | 安装方式 | |---|---|---| | `python3 >= 3.10` | 运行 manifest 领域验证器 | macOS: `brew install python`<br>Linux: `sudo apt-get install python3` | ### Python 包 无需第三方 Python 包，验证器仅使用标准库。 ## 参考与脚本 - [outline_prompt.md](references/outline_prompt.md)：素材/图片账本与全局大纲。 - [overview_prompt.md](references/overview_prompt.md)：总览生成。 - [chapter_prompt.md](references/chapter_prompt.md)：章节书稿化生成与人工自检。 - [extract_prompt.md](references/extract_prompt.md)：提取模式。 - [course-manifest.md](references/course-manifest.md)：产物契约和最小示例。 - [course-manifest.schema.json](config/course-manifest.schema.json)：JSON Schema。 - [source-index.schema.json](config/source-index.schema.json)：来源索引 Schema。 - [index_sources.py](scripts/index_sources.py)：确定性来源分块与哈希索引器。 - [index_sources_selftest.py](scripts/index_sources_selftest.py)：索引器回归套件。 - [verify.sh](scripts/verify.sh)：验收入口。 - [verify_course.py](scripts/verify_course.py)：标准库领域验证器。 - [verify_selftest.py](scripts/verify_selftest.py)：故障注入回归套件。