Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(modes): complete mode disambiguation into one Close-calls table; settle the catalog

hugohe3081c52668a75
diff --git a/docs/roadmap.md b/docs/roadmap.md
index 0afb6d00..079e8345 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -57,7 +57,8 @@ The past two months' structural capability growth. Single flags / incremental po
Directions actively underway or up next, with no committed timeline.
-- **Validate and calibrate the new mode / visual-style system on real decks** — the 5 modes + 18 visual-styles + the `custom` escape hatch are all still design-stage, unproven at this scale on real decks. The next step is not more presets but running real decks across the new modes / styles / custom and tightening from real signal: where the Strategist mis-selects a mode or style, where the Executor doesn't honor a style's discipline, whether a `custom` lock reads clearly at confirmation. Then adjust the auto-selection tables and the per-mode / per-style wording accordingly. Mode boundary-gray-zone polish folds into this — calibrate from real use, not speculation; no further presets planned
+- **Validate and calibrate the new mode / visual-style system on real decks** — the 5 modes + 18 visual-styles + the `custom` escape hatch are all still design-stage, unproven at this scale on real decks. The next step is not more presets but running real decks across the new modes / styles / custom and tightening from real signal: where the Strategist mis-selects a mode or style, where the Executor doesn't honor a style's discipline, whether a `custom` lock reads clearly at confirmation. Then adjust the auto-selection tables and the per-file wording accordingly
+- **mode catalog — settled** — the structure (5 + custom) is locked and the close-call tie-breakers are consolidated into one table covering the four genuinely-adjacent pairs (`pyramid↔briefing`, `narrative↔pyramid`, `narrative↔showcase`, `instructional↔briefing`); the rest are far enough apart to need none. All that remains is wording refinement to the mode files as real decks exercise them — which rides on the validation pass above, not a separate workstream
---
diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.md
index 13563d28..d6fd11bf 100644
--- a/docs/zh/roadmap.md
+++ b/docs/zh/roadmap.md
@@ -57,7 +57,8 @@
明确在做或下一步要做的方向,不承诺时间窗口。
-- **用真实 deck 验证并校准 mode / visual-style 新体系** — 5 个 mode + 18 个 visual-style + `custom` 逃生舱目前都还是设计态,没在真实 deck 上按这个规模跑过验证。下一步不是再加预设,而是跑几份覆盖新 mode / visual-style / custom 的真实 deck,从真实信号反过来收紧:Strategist 在哪选错了 mode 或 style、Executor 有没有落实某个 style 的纪律、custom 锁定在确认环节读起来清不清楚;据此调整 auto-selection 表与各 mode / style 文件的措辞。mode 边界灰区的打磨并入此项——靠真实用例校准,而非空想扩档,不再新增预设
+- **用真实 deck 验证并校准 mode / visual-style 新体系** — 5 个 mode + 18 个 visual-style + `custom` 逃生舱目前都还是设计态,没在真实 deck 上按这个规模跑过验证。下一步不是再加预设,而是跑几份覆盖新 mode / visual-style / custom 的真实 deck,从真实信号反过来收紧:Strategist 在哪选错了 mode 或 style、Executor 有没有落实某个 style 的纪律、custom 锁定在确认环节读起来清不清楚;据此调整 auto-selection 表与各文件措辞
+- **mode catalog 已收口** — 结构(5 个 + custom)定型,近邻消歧判据补齐成一张 Close-calls 表(`pyramid↔briefing`、`narrative↔pyramid`、`narrative↔showcase`、`instructional↔briefing` 四对真正会混的对,其余 far-apart 不需要)。residual 只剩各 mode 文件随真实 deck 落实情况的措辞精修,并入上面的验证 pass,不再单独占工
---
diff --git a/skills/ppt-master/references/modes/_index.md b/skills/ppt-master/references/modes/_index.md
index 6ecd6035..59e40f87 100644
--- a/skills/ppt-master/references/modes/_index.md
+++ b/skills/ppt-master/references/modes/_index.md
@@ -35,9 +35,16 @@ Each mode has its own file with: narrative skeleton, page-structure tendencies,
| Status update / reference / catalog / FAQ / meeting pack / 周报 / 参考 | `briefing` | `pyramid` |
> No single signal dominates — read the deck's actual purpose from `c. Key Information`. When two modes fit, follow the **primary** intent of the body pages, not the cover. A data review legitimately runs almost entirely `pyramid`; do not force variety.
->
-> **`briefing` vs `pyramid`** — the close call. Both suit reports and data. Choose `pyramid` when the deck must *land a recommendation* (conclusion-first, assertion titles, every number compared); choose `briefing` when it must *inform completely without arguing* (topic titles, even weight, full reference set). If you'd have to invent a thesis to fit `pyramid`, it's `briefing`.
->
+
+**Close calls** — the genuinely adjacent pairs; every other pair is far enough apart that the auto-selection signal decides.
+
+| Torn between | …the first when | …the second when |
+|---|---|---|
+| `pyramid` / `briefing` | it must land a recommendation — conclusion-first, every number compared | it must inform completely without arguing — topic titles, even weight |
+| `narrative` / `pyramid` | the point lands through a story arc, tension → resolution | the point lands as a conclusion stated up front, then supported |
+| `narrative` / `showcase` | an argument travels through the story | presence leads — minimal copy, one big visual per page |
+| `instructional` / `briefing` | the goal is to build understanding step by step | the goal is to lay out a complete reference to scan |
+
> "Keynote-style" is a *mode* request, not a visual style — it means showcase pacing (one big idea per page, full-bleed hero, reveal rhythm), skinned by whatever visual style fits the brand (`swiss-minimal` clean, `dark-tech` dramatic, `glassmorphism` premium). Don't reach for a "keynote" visual style — there isn't one, by design.
---