teach-course-builder 用于把来源文档转化为结构化学习路径，而非简单复制内容。它分析文档结构，推断单元与课时，识别受众层级，并通过 Teach authoring API 创建带能力的课程。
环境要求：Deno；authoring API 运行在 http://localhost:4100。可设置 export TEACH_API_URL="http://localhost:4100/api"；启动命令：cd /path/to/teach 与 pnpm dev:authoring-api。
工作流程分为五个阶段：分析、规划、可选研究、构建、复核。分析阶段运行 deno run --allow-read --allow-env scripts/analyze-sources.ts /path/to/sources，输出建议课程标题、单元、课时、受众层级与能力。规划阶段由用户审阅并调整结构。研究阶段仅在内容需扩展时使用。构建阶段依次创建课程、单元、课时和能力，例如：deno run --allow-net --allow-env scripts/create-course.ts --title "Working with AI" --description "A practical guide"，以及 add-unit.ts、add-lesson.ts、add-competency.ts；受众层级包括 general、practitioner、specialist。复核阶段在 http://localhost:4101/courses/ 的 UI 中检查内容与能力。
可用脚本包括 analyze-sources.ts、create-course.ts、add-unit.ts、add-lesson.ts、add-competency.ts、list-courses.ts，均以 Deno 运行，支持部分 --json 输出。课程数据通过 API 持久化在 apps/authoring-api/data/authoring.db。可选研究集成需 TAVILY_API_KEY。
限制与注意：不得绕过 authoring API，不得在用户审阅结构前创建课程，不得逐字复制内容而不分析结构，也不得省略能力定义。连接被拒通常表示 API 未运行；课程未找到可用 list-courses.ts 校验 ID；空课程计划可能因为目录中只有被跳过的 README。最终组织由用户决定。