Skip to content

OpenSenseNova/SenseNova-Skills / skills/sn-ppt-standard

sn-ppt-standard

Flagged

仅在 `sn-ppt-entry` 与 `sn-ppt-story` 已准备绝对 `DECK_DIR` 和 `outline.md` 后使用;生成每页独立 HTML(1600×900)、渲染 PNG、逐页讲稿、`present.html`,并按 `static_postprocess` 选择生成由 Standard 自有 exporter 转换的 PPTX。**`present.html` 始终是必交付产物,缺失即技术故障,不得交付;`static_postprocess` 含 `pptx` 时 PPTX 同为必交付产物(缺一即技术故障),且只能由 Standard 自有 exporter 生成;仅当用户明确要求只要 HTML(`static_postprocess` 为 `[]`)时,PPTX 才可不交付。**

FileKindSize
SKILL.mdskill md45.2 KB
agents/openai.yamlconfig350 B
assets/licenses/OFL-1.1.txtmarkdown3.9 KB
references/base-template.cssother34.5 KB
references/box-agent-tool-contract.mdmarkdown5.7 KB
references/design-rules.mdmarkdown62.8 KB
references/design-styles.mdmarkdown26.2 KB
references/editing-contract.mdmarkdown4.9 KB
references/fonts.mdmarkdown10.3 KB
references/layout-patterns.mdmarkdown17.3 KB
references/planning-contract.mdmarkdown27.0 KB
references/quality-checklist.mdmarkdown30.2 KB
scripts/deck.pyscript58.6 KB
scripts/export_pptx/html_to_pptx.mjsscript6.3 KB
scripts/export_pptx/lib/browser_picker.mjsscript5.5 KB
scripts/export_pptx/lib/cli_guards.mjsscript14.5 KB
scripts/export_pptx/lib/dom_extractor.mjsscript37.0 KB
scripts/export_pptx/lib/echarts_discovery.mjsscript1.2 KB
scripts/export_pptx/lib/echarts_to_pptx.mjsscript30.0 KB
scripts/export_pptx/lib/image_downloader.mjsscript4.1 KB
scripts/export_pptx/lib/postprocess_pptx.mjsscript6.9 KB
scripts/export_pptx/lib/pptx_builder.mjsscript84.9 KB
scripts/export_pptx/lib/style_parser.mjsscript18.8 KB
scripts/export_pptx/package-lock.jsonmanifest9.1 KB
scripts/export_pptx/package.jsonmanifest268 B
scripts/export_pptx/screenshot.mjsscript2.7 KB
scripts/export_pptx/test/fixtures/dom-layout-regression.htmlother758 B
scripts/export_pptx/test/fixtures/echarts-fallback.htmlother1.2 KB
scripts/export_pptx/test/test_color_srgb_regression.mjsscript881 B
scripts/export_pptx/test/test_dom_layout_regression.mjsscript1.5 KB
scripts/export_pptx/test/test_echarts_discovery.mjsscript1.4 KB
scripts/export_pptx/test/test_echarts_fallback.mjsscript2.0 KB
scripts/export_pptx/test/test_echarts_to_pptx_regression.mjsscript2.3 KB
scripts/export_pptx/test/test_radial_overlay_regression.mjsscript1.0 KB
scripts/export_pptx/test/test_text_box_padding_regression.mjsscript675 B
scripts/font_bundle.pyscript38.9 KB
scripts/image_cutout.pyscript14.2 KB
scripts/install.shscript12.8 KB
scripts/render.pyscript94.8 KB
scripts/serper_images.pyscript4.2 KB
scripts/stage_materials.pyscript37.6 KB
subagents/image.mdmarkdown14.3 KB
subagents/review.mdmarkdown26.0 KB
subagents/slide.mdmarkdown23.9 KB

references/editing-contract.md

View on GitHub
# 现有 PPT 编辑合同

本文件只在用户要求修改、续编、重排或统一现有 deck 时读取。目标是先限定影响范围,再选择 Review 快修或 Orchestrator 多 Agent 改造。

## 阅读顺序

1. §1 只读盘点;
2. §2 判定简单或复杂;
3. 只进入命中的 §3 或 §4;
4. §5 统一验收。

## 1. 只读盘点

先检查:

- 用户原始修改要求;
- `plan/design-brief.md`、`plan/deck.md` 和相关 `plan/slide_NN.md`;
- `base.css`;
- `slides/`、`renders/`、`assets/`;
- `speech.md`、`present.html`;
- 最新 overview / contact sheet。

输出一份影响清单:

```text
requested_changes:
affected_facts:
affected_narrative:
affected_pages:
affected_global_style:
new_evidence_needed:
new_assets_needed:
speech_impact:
render_scope:
protected_pages_and_assets:
```

盘点阶段只读,不修改文件。

## 2. 路径判定

### Review 快修

同时满足以下条件才使用:

- 核心论点、页序、页面职责和跨页叙事不变;
- 事实已有可靠依据,不需要新 Research/Material;
- 不需要新图片或新视觉资产;
- 不改变 Style Lock、全局字体系统或多个版式原型;
- 修改可在少量明确页面内安全完成。

典型任务:错字、局部文案替换、单页排版、图片裁切、字号/对比、局部数据修正、讲稿同步、少量页面视觉统一。

### Orchestrator 改造

命中任一条件即使用:

- 增删页、换顺序、重做章节或改变核心论点;
- 修改影响多个页面职责或跨页衔接;
- 需要新事实、新附件解析、新图片或重新生成资产;
- 改变 Style Lock、调色板、字体、页面骨架或全局 token;
- 需要把旧页面改成新的页面类型或重新分配内容;
- 无法可靠判断哪些既有成果仍有效。

页数不是唯一阈值:一页的叙事级改动也属于复杂编辑,多页的同一机械替换仍可能是简单编辑。

## 3. Review 快修合同

goal 必须包含:

```text
mode: simple_edit
Raw user request: <原文>
Target pages: <页码>
Required changes: <逐项>
Must preserve: <事实、页面职责、Style Lock、未受影响页面>
Render scope: <页码>
```

Review 按以下顺序执行:

1. 看 overview 和目标页最新 PNG;
2. 一次列完问题/修改账本;
3. 备份目标页,集中修改 HTML 和受影响计划;
4. 若改屏显字符或字体 token,运行 `deck.py prepare . --expected <总页数>` 同步讲稿并准备字体;
5. 用 `render.py --batch . --pages ...` 一次重渲;全局 token 变化说明误判为简单编辑,应停止并返回 blocked;
6. 运行 `deck.py contact . --focus ...` 并看 focus 联系表;
7. 同步讲稿并重建播放器。

Review 不扩写事实、不创建新素材、不重排全册叙事、不修改未列入影响范围的页面。

## 4. Orchestrator 改造合同

1. 把影响清单转成任务图;独立任务并行,存在前置依赖的任务分波执行。
2. 只委派页面实现实际需要的角色:
   - 事实缺口、新附件解析、页序变化、核心结论变化 → 停止编辑并返回 Entry/Story,由上游更新 `info_pack.json`、Research 产物和当前 `outline.md`;
   - 已冻结 `outline.md` 范围内的新位图或替换位图 → 受影响的 Image 素材组;
   - 已冻结 `outline.md` 范围内的页面实现或版式重做 → 受影响的 Slide 页组。
   - 页面重做 → 受影响页各一个 Slide。
3. 开始下游生产前重新读取当前 `outline.md`、`info_pack.json` 和上游已交接的 Research 产物,只更新受影响的 Style Lock、deck/slide plan 与页面实现;不得在 Standard 内重新汇总事实、解析附件或改写叙事。必要的上游产物缺失时返回 Entry/Story。
4. 复用未失效的 HTML、素材、讲稿和渲染图;禁止“为了省判断”从头覆盖全册。
5. 局部变化只重渲变化页;若改变 bookends/dividers 或内容组的跨页关系,重做受影响的完整页组;base.css、字体或全局骨架变化才全册 batch。
6. 最后由唯一 Review 看全册一致性、集中修复并收口讲稿。

## 5. 编辑验收

- 用户要求逐项对应到实际修改;
- 影响清单之外的文件没有无理由变化;
- 所有变化页都已重渲并看最终像素;
- 全局变化后的全册页面均新于 base.css;
- `speech.md`、字体 bundle 和 `present.html` 与最终页面一致;当 `choices.static_postprocess` 包含 `pptx` 时,PPTX 必须存在、可以打开且页数与最终 HTML 一致;只有用户明确要求“只要 HTML”或“不要 PPTX”时才跳过该检查;
- `task_pack.state.artifacts` 只登记真实存在的最终产物;若仅 PPTX 导出失败,则保留 HTML、PNG、讲稿和播放器,将 `state.status` 写为 `partial`,把原始失败原因写入 `state.last_error`,不得伪造 PPTX 路径;恢复时只重跑 exporter。
- blocked 项如实保留,不用额外 Review 掩盖。
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall