slides-grab 计划技能
在生成任何幻灯片之前，用结构化大纲和风格选型把演示文稿的规划阶段做扎实，直到用户明确批准。
该技能作用域严格限制在大纲规划阶段，明确禁止生成幻灯片 HTML，强制要求风格选择与用户显式批准、DESIGN.md 原文件保持不动、引用仅限打包 CLI 与捆绑 references，数据流透明、无敏感数据处理或越权操作，测试中还可见将导入的 DESIGN.md 视为不可信数据的边界处理。扣分点：归属依赖未验证的发布者，回滚与隔离机制未在技能层面显式声明，故未给满分。
SKILL.md 与三个 reference 文档之间指令自洽（阶段边界、审批循环、输出格式在各文档中一致），工作流有明确的必选项与优先级，异常路径有'原始 DESIGN.md 不动'等约束。扣分点：静态审查无法执行关键路径，规划技能本身无直接测试覆盖，对无效输入的失败反馈质量未知，故按锚点封顶 10 以下不给更高分。
触发条件清晰（用户从零开始新演示文稿时使用），输入、输出、非适用范围（不写 HTML、不做设计）与四种风格路径的边界都明确声明。扣分点：未声明中文语言支持；安装依赖 GitHub raw URL 与 npm/Playwright 下载，对中国大陆网络可达性存在风险且未提供镜像或离线说明。
文档分层良好（SKILL.md 精简主流程 + 三个专题 reference），MIT 许可明确，输出契约与命名稳定，已知限制（实验性导出等）在 README 中有披露。扣分点：技能本身无版本号或变更日志，维护责任与更新路径仅在仓库层面隐含，存在对未发布 CLI 行为的隐含假设。
核心任务（产出可批准的 slide-outline.md）流程完整、可直接执行，模板/图像原生模式的密度要求超出一般规划技能的细致程度，边际价值明确。扣分点：静态审查下无代表性实际输出被验证可用，最终质量依赖下游 design 阶段，按锚点封顶 7 以下。
仓库包含真实测试套件与 CI（npm publish、Pages 工作流），design-md-parser 等 tests 与该技能引用的 CLI 命令部分对应，提供一定佐证。扣分点：没有针对规划技能关键路径的测试，无第三方独立执行证据，仅静态阅读，封顶 5 以下。
- 静态审查结论，未实际执行任何命令；规划阶段无独立测试证据。
- 安装依赖 GitHub raw URL 与 npm/Playwright 下载，在中国大陆网络环境下可能不可达，请准备镜像或手动安装。
- 技能本身无版本号/变更日志，后续更新可能改变输出契约，使用前请核对修订。
- 该技能仅为规划阶段，最终幻灯片质量取决于未评估的 design/编辑阶段。
- 发布者身份未经验证，归属与维护责任以仓库现状为准。
这个 Skill 能做什么，适合哪些场景？
slides-grab-plan 是 slides-grab 工作流的第一阶段（Stage 1）规划技能，可在 Claude Code 和 Codex 中使用。它在任何幻灯片 HTML 生成之前，引导 agent 分析主题、受众和语气，从四条路径中选定设计风格，然后编写并迭代 slide-outline.md 直到用户明确批准。它支持导入企业模板包、捆绑的 95 种设计风格、DESIGN.md 转换以及自由定制方向四种方式，并为图表页和图像原生模式提供专门的大纲密度要求。该技能本身不生成幻灯片，只输出一份含元信息（风格、模式）的已批准大纲，供后续设计阶段使用。
读取用户的主题、意图、受众、语气约束和可选调研材料；按优先级执行四条风格选型路径：运行 slides-grab import-template 导入企业模板（生成 template-pack.）、用 list-styles / preview-styles 从 95 种捆绑风格中筛选 2–3 个候选、检查本地 DESIGN.md（可用 import-design 从 URL 拉取）并在需要时按 web→slide 映射表转换为 DESIGN.slides.md、或提出书面定制方向；产出带 meta 段（style: 与 mode: 字段）的 slide-outline.md；为图表页标注图表类型、数据来源和对比轴；图像原生模式下要求把模板页渲染为 PNG、逐页匹配布局类型与信息密度，并标注 template-page 编号；每个版本都向用户展示摘要并等待批准。
- 用户在 Claude Code 或 Codex 中说'帮我从零做一份关于 X 的演示文稿'时，作为规划阶段执行
- 团队需要沿用公司现有 PPT 模板，先导入 template-pack 再确定大纲结构与信息密度
- 作者有来自 voltagent/awesome-design-md 等来源的网页风格 DESIGN.md，需要把它转成适用于单帧幻灯片的设计语言
- 量化报告需要图表作为证据，先在大纲中锁定图表类型、数据来源和核心对比，避免装饰性假图表
- 视觉匹配优先的场合（如按既有企业模板逐页复刻），走 image-native 模式并按模板页密度写满大纲
- 需要在进入设计阶段前，与 agent 多轮迭代叙事结构和页面顺序直到达成一致
这个 Skill 有哪些优点和局限？
- 把风格决策前置为强制性步骤，避免在设计阶段反复返工
- 四种风格路径覆盖企业模板、内置风格库、网页设计文档和自由定制
- 图表页和 image-native 模式有明确的大纲密度与数据要求，防止空洞占位内容
- 与 slides-grab CLI（validate、design-gate、pdf 等下游命令）形成闭环工作流
- MIT 许可，README 提供韩文/英文文档和在线示例画廊
- 只是多技能集合中的第一阶段，单独使用无法产出幻灯片，必须依赖后续阶段和打包 CLI
- 要求 Node.js >= 20 和 Playwright chromium，环境门槛较高
- 导出（pdf、convert、figma）被 design-gate 阻止，需先获得 proceed 回执
- PPTX 与 Figma 导出在 README 中明确标注为实验性/不稳定
- codex-imagen 图像生成依赖不受支持的 Codex 私有后端，可能随时失效且需要具备图像生成权限的账号
- 大纲质量高度依赖用户的风格反馈，批准循环可能多轮耗时
如何安装这个 Skill？
安装整个 slides-grab 集合（含本技能）：npm install slides-grab && npx playwright install chromium，然后运行 npx slides-grab install-skills --target all --scope user，将技能装入 Codex 和 Claude Code 位置；或克隆仓库 git clone https://github.com/NomaDamas/slides-grab.git && cd slides-grab && npm ci && npx playwright install chromium。也可用 npx skills add ./node_modules/slides-grab -g -a codex -a claude-code --yes --copy --full-depth 安装技能。技能文件位于仓库 skills/slides-grab-plan/SKILL.md。README 未说明单独安装这一个技能的方法。
如何使用这个 Skill？
在 Claude Code 中粘贴：Read https://raw.githubusercontent.com/NomaDamas/slides-grab/main/docs/installation/claude.md and follow every step.（Codex 用对应的 docs/installation/codex.md）。触发方式：让 agent 开始一个新演示文稿，它会先做风格选型（import-template / list-styles + 用户确认 / DESIGN.md 转换 / 自由定制），再写出 slide-outline.md。硬性规则：风格未经批准前不得写大纲；本阶段不得生成 slide-*.html；每次修订后展示摘要并等待明确批准。产物大纲需含 style: 与 mode:（html 或 image-native）元信息。
这个 Skill 与同类方案有什么区别？
README 将 slides-grab 定位为'Claude Design 的开源替代品'（harness + 编辑器 + linter 的组合），即与 Anthropic 的 Claude Design 能力对标；同时致谢部分说明项目基于 Builder Josh 的 ppt_team_agent 构建。