course-notes-html-reportlisted

# 课程要点还原报告：多源材料 → 可二次输出的 HTML 用于「我刚参加了一场培训，空间里有全部材料，帮我输出完整课程要点」这类需求。 **核心价值不在样式，而在三件事**：**可核查的事实分层 + 可复用的资产清单 + 一眼看到全局的知识地图**。 多数人把课程整理做成「要点摘抄」——那没有二次输出的价值。 > **本技能专注「内容还原的方法论 + 样式/交互/照片的硬规范」。** > HTML 构建与渲染验证的通用工程细节（分片拼接、内联 Chart.js、探针写法） > 另见配套技能 **`html-data-report`**，本技能不重复。 > > 技能包结构：`references/`（七份规范，按需读）+ `scripts/`（19 个可跑脚本）+ `assets/`（样式骨架与侧栏模板）。 --- ## 0. 先对齐，再动手（**唯一硬门禁，不要跳**） 这类任务信息量大、返工代价高。**必须先读完材料 → 出方案 → 等确认**。 用 AskUserQuestion 一次问清四件事（给推荐项，不要开放式提问）： | 必问项 | 典型选项 | 不问的后果 | |---|---|---| | **覆盖范围** | 全部场次 / 只做有录音的场次 | 白写一半，或漏写用户最想要的 | | **详略程度** | 速览版 / 详尽版（二次输出素材库） | 写得过简被退，或过度冗长 | | **「我的总结」视角** | 第一人称（结合用户身份/公司）/ 中性 / 不写 | 总结写成正确的废话 | | **课件照片处理** | **双轨制**（照片 > 30 张）/ 只矢量重建（< 10 张）/ 不处理 | 选错要返工重做全部插图 | **范围判定要先做材料盘点**：空间里常有「课表预告了但材料没到」的场次。 **没有录音/纪要/课件 = 不做推测性还原**，在附录里明确写出边界与原因。 --- ## 1. 十阶段流程 ``` S0 材料盘点 ──▶ S1 方案规划 ⭐门禁 ──▶ S2 素材深读与照片归位 ──▶ S3 标注体系与章节架构锁定 │ ┌──────────────────────────────────────────────────────��───────────┘ ▼ S4 骨架+样式系统 ──▶ S5 分节撰写 ──▶ S6 构建 ──▶ S7 五层验证 ──▶ S8 交付/派生/发布 ──▶ S9 沉淀 ``` | 阶段 | 动作 | 产出 | 通过闸门 | |---|---|---|---| | **S0** | 清点材料（四类源 + 张数/页数/字数） | 材料清单 | 四类源都有去向，缺失项已记录 | | **S1** ⭐ | 出方案，问 4 个决策 | `方案规划_<MMDD>.md` | **用户明确确认后才能开工** | | **S2** | 转写 grep 精读 + 照片索引拼图 | 文本提取物 / 照片编号↔内容映射 | 每张照片都知道「讲的是哪一页」 | | **S3** | 锁定标注体系与章节架构 | 章节表 + 四档样式 | 四档视觉样式互不混淆 | | **S4** | 写 CSS 设计令牌 + 分片骨架 | `head.html` + `build_report.py` | 断点与打印规则齐全 | |