SuperAPI AI 工具集

course-generator

写作与研究

查看项目

更新于 10-15 20:10

技能介绍

用途:把现有文本(转录稿、逐字稿、讲稿、文献)整理成读者无需接触原始转录稿即可理解和使用的 Markdown 课程,保留重要观点、案例、操作过程、失败修正与判断方法,同时去除口语、会务信息和转录噪声。默认只生成课程,不自动归档、移动原文件或改造成其他内容产品。

主要能力与交付:确认来源文件或目录(优先 .md、.txt)和课程输出目录后,默认交付 00 <课程名称> - 总览.md、按阅读顺序编号的课程章节、source-index.json、course-manifest.json。原始材料保持只读,临时计划、批次文件、脚本和缓存放在课程目录之外。默认最多 8 章,用户明确要求超过 8 章时才读取 advanced-overrides.md。

使用方式:生成任务开始后先完整读取 generation-workflow.md,再依次运行 index_sources.py 建立来源索引;用 ledger_tool.py init 初始化 manifest 并冻结章、节计划;分批建立素材账本并运行预检;选择代表图并生成章节标题脚手架;读取 overview_prompt.md 和 chapter_prompt.md,先写总览,再逐章生成,每章通过 check-chapter 后才进入下一章;运行 final 阶段和 verify.sh,最后完成人工语义复核。

核心要求:数字、动作、结果、建议和专有名称须可回溯来源;每个有效来源块进入素材账本或有受控跳过理由;每个二级标题绑定素材且证据不得跨节借用;来源存在修订时以控制文档为准,旧口径只进入审计记录。

完成标准与限制:总览、全部声明章节和两份强制 JSON 均存在;素材账本覆盖全部有效来源块;check-chapter 通过且 verify.sh 退出码为 0;独立审阅者按 quality-evaluation.md 完成语义验收。脚本通过不等于语义质量通过。脚本不联网、不安装依赖、不修改原始材料。系统依赖 python3 >= 3.10,无需第三方 Python 包。配额、网络或平台异常时保留现场并报告,不重跑,不把半成品记为成功。未脱敏转录稿按最小必要原则处理。