| name | gad-slides-authoring |
| description | Use when preparing, rewriting, or maintaining Game-Audio-Design Slidev teaching decks, `slides/pages/*.md` files, `slides/drafts/*.md` outlines, or course slides for online `/slides/` pages. 中文触发：游戏音频备课幻灯、课程 Slidev 讲稿、slides/pages、slides/drafts。 |
GAD Slides Authoring
核心规则
使用三阶段工作流：A 大纲 -> B 逐页内容 -> C Slidev 实现。
在 B 阶段形成 confirmed page plan 之前，不要跳到 C。除非用户明确授权你起草缺失内容，否则不要凭想象补写 B 阶段内容。
用户可以从 A、B、C 任意阶段进入。继续之前，先检查上游产物是否存在且足够具体；如果缺失，就退回对应阶段补齐。
入口检查
-
识别目标 stem。
- 如果用户提供
slides/pages/<stem>.md，使用该 stem。
- 如果用户提供 draft 路径，用
draft-<stem>.md 推断 stem，并在本次会话中使用这个具体 draft。
- 如果用户只提供不带目录的
draft-<stem>.md，默认标准路径是 slides/drafts/draft-<stem>.md；如果该文件不存在，在进入 B 或 C 前先询问实际路径。
- 如果没有具体
stem 或文档，先请用户确定；不要自行命名。
- active draft 是用户提供的 draft 路径；如果用户未提供，则是
slides/drafts/draft-<stem>.md。
-
检查目标在仓库中的状态。
- 检查
slides/pages/<stem>.md。
- 检查
slides/public/<stem>/。
- 检查 active draft 路径。
- 如果文件或文件夹缺失，记录为“待创建”或“缺少资源文件夹”；缺失文件不阻止 A，但可能阻止 B 或 C。
-
确认当前阶段。
- A：用户想讨论专题、想法、结构或教学大纲。
- B：用户已有大纲，想确定每页 slide 的文字、媒体和布局。
- C：用户已有 confirmed page plan，想制作实际的 Slidev 页面。
进入 B 或 C 时，先读取 active draft，并向用户简短复述当前状态，再继续。
讨论方式
当决策不清楚时，使用 grill-me 方式：
Interview the user relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
Ask the questions one at a time.
If a question can be answered by exploring the codebase, explore the codebase instead.
默认按 GAD 网站读者和在线 Slidev deck 语境推进。不要开场询问目标受众、授课时长或难度等级；只有用户明确在做线下课、直播课、工作坊，或这些信息会直接改变 deck 结构时，才把它们作为决策问题。
在 A/B 讨论阶段，除非用户明确说暂停、先到这里或不要继续问，每次回答或更新 draft 后都要继续推进一个最小决策：提出一个具体问题，并给出推荐答案。用户说“可以，先这样”时，理解为确认当前建议并继续下一个最小决策。
Stage A - 大纲
目的：把一个专题或粗略想法整理成清晰的教学大纲。
进入条件：
- 已知目标
stem。
- 已检查
slides/pages/<stem>.md、slides/public/<stem>/ 和 active draft。
流程：
- 如果用户给了具体来源文档或现有 deck，先检查它；不要追问仓库中已经能回答的事实。
- 如果专题仍然模糊，使用一问一答的 grill-me 讨论。
- 明确主线、案例、粗略章节结构和限制条件。
- 不要默认规划整体或各章节分钟数；只有用户明确要求演讲排练、直播课、工作坊或课堂时长控制时，才讨论时间分配。
退出产物：
- 保存或更新 active draft。新建 draft 时，使用
slides/drafts/draft-<stem>.md。
- draft 必须包含目标 deck、仓库状态、专题主线、大纲、资源备注和开放问题。
- 使用 REFERENCE.md 中的模板。
除非用户明确把任务切换到 C，且 Stage B 已经完成，否则不要在 Stage A 创建或重写 slides/pages/<stem>.md。
Stage B - 逐页内容
目的：把大纲转化为已确认的逐页计划。
进入条件：
- active draft 存在。
- Stage A 大纲已经具体到可以拆分为 slides。
- 你已经读取 draft，并向用户确认过你的理解。
硬门槛：
- 除非用户明确授权你起草缺失内容，否则不要自行填充 slide 文案、论点、案例或媒体选择。
- 如果内容缺失，在 draft 中写 placeholder、问题或
TBD。
- “直接开始”“快一点”“按大纲做成 slides”这类请求，不足以授权你编写缺失论点、案例、媒体、引用或资源路径。
- “帮我补每页内容”只授权你起草可见文字；不确定的事实、案例和媒体仍要保留为 placeholder 或问题。如果授权范围不清楚，继续追问。
流程：
- 和用户一起确定每页 slide 的标题、目的、可见文字、媒体需求、layout intent 和 speaker note intent。
- 当某页内容依赖未解决的决策时，使用一问一答的 grill-me 讨论。
- 优先推进内容结构、案例、可见文字、媒体和 layout intent；不要把每页或每章时长当作默认讨论项。
- 更新同一个 active draft；不要只把页表散落在聊天记录里。
退出产物：
- active draft 包含足够进入实现的 page table。
- 缺失媒体或未决内容被明确标注。
- page table 只有在每页都具备 purpose、visible title、key text 或明确 placeholder、layout intent、media status，并且状态为
confirmed 或 placeholder 时，才算足够进入实现。标记为 needs-user 或 blocked 的页面必须先由用户解决；除非用户明确要求把它们作为 placeholder 实现。
除非用户明确把任务切换到 C，且 page table 已足够完整，否则不要在 Stage B 实现 Slidev 页面。
Stage C - Slidev 实现
目的：根据已确认的 page plan 实现 slides/pages/<stem>.md。
进入条件：
- active draft 存在。
- draft 包含 confirmed page table。
- 你已经读取 draft，并向用户确认过 page plan 和缺失资源。
- “Confirmed” 指用户在你复述 page plan 后批准，或 draft 本身已将相关 slides 标为
confirmed / placeholder，且没有未解决的 needs-user 或 blocked 项。
必读参考：
流程：
- 创建或更新
slides/pages/<stem>.md。
- 优先使用
slides/public/<stem>/ 中已有且合适的资产。
- 如果资产缺失或不合适，使用清晰的文字 placeholder，并保持 draft 中的资源清单准确。
- 不要编造资源文件名、项目截图、引用或媒体细节。
验证：
- 对 Slidev 做实质性编辑后，运行
npm run slidev:build。
- 如果任务还修改了站点代码、配置或构建脚本，按仓库要求运行更广的检查。
- 除非实际运行并看到成功结果，否则不要声称构建或检查已通过。
参考边界
SKILL.md 是工作流规则和阶段门槛的真源。
REFERENCE.md 只包含可复用模板和示例：
- draft 文件模板
- page table 字段
- placeholder 示例
- 资源状态示例
- 命令速查
