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(executor): rewrite speaker notes for TTS narration
hugohe3b3d012c4fdb0
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex de3180eb..7df01c87 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -263,62 +263,36 @@ If `spec_lock.md` is absent, consult [`strategist.md`](strategist.md) §g — doAfter all SVG pages are finalized, enter Logic Construction Phase and write the full notes to `notes/total.md`. Batch-writing (not per-page) lets transitions plan coherently.-**Language rule (read first)**: all structural labels and stage direction markers MUST match the deck's content language. Never mix English labels with non-English body text. Pick the matching example block below; do not copy across languages.+**Pure spoken narration**: notes are read aloud verbatim by `notes_to_audio.py` (TTS). Write only what should be spoken. No visible markers, no labeled meta-lines, no enumerated key-point lists, no duration annotations — anything you write outside the heading will be vocalized.-**Per-page structure**: `# <number>_<page_title>` heading, pages separated by `---`. Each page contains:-- A 2–5 sentence script (conversational tone, highlights the page's core info).-- A `Key points` line listing 1–3 concrete points numbered ①②③ — fill in real content, do not leave the circled numbers as placeholders.-- A `Duration` line with a single concrete number (e.g. `2分钟` / `2 minutes`), not a range and not the literal `X`.-- Every page after the first opens with a `[Transition]` (or its localized form) standalone phrase that bridges from the previous page.+**Per-page structure**: `# <number>_<page_title>` heading (the `#` heading line is the only thing stripped before TTS), pages separated by `---`. Body is 2–5 natural sentences carrying the page's core message. Page-to-page transitions live inside the opening sentence as natural prose ("接下来……" / "Having framed X, let's turn to Y") — no bracketed `[过渡]` / `[Transition]` tags.-**Concrete examples — copy the one matching your deck language.**+**Concrete examples** — same shape applies to any language; just write naturally in that language.-中文 deck(标签必须本地化):+中文 deck:```# 02_市场格局-[过渡] 在明确了行业背景之后,我们来看具体的市场格局。-当前线上零售集中度持续上升,前三大平台合计份额已达 68%。腰部玩家正在被快速挤压,留给新进入者的窗口期不超过 18 个月。这意味着我们的策略必须聚焦,而不是铺开。--要点:① 集中度 68% 的事实 ② 18 个月窗口期 ③ 聚焦优于铺开-时长:2分钟+在明确了行业背景之后,我们来看具体的市场格局。当前线上零售集中度持续上升,前三大平台合计份额已经达到百分之六十八,腰部玩家正在被快速挤压,留给新进入者的窗口期不超过十八个月。这意味着我们的策略必须聚焦,而不是铺开。```-英文 deck(labels stay English):+英文 deck:```# 02_market_landscape-[Transition] Having framed the industry backdrop, let's look at the actual market landscape.-Online retail concentration keeps rising — the top three platforms now hold 68% combined share. Mid-tier players are being squeezed fast, and the window for new entrants is under 18 months. This means our strategy has to focus, not spread.--Key points: ① The 68% concentration fact ② The 18-month window ③ Focus beats breadth-Duration: 2 minutes+Having framed the industry backdrop, let's look at the actual market landscape. Online retail concentration keeps rising — the top three platforms now hold sixty-eight percent of combined share, mid-tier players are being squeezed fast, and the window for new entrants is under eighteen months. This means our strategy has to focus, not spread.```-> 日本語 / 한국어 / 其他语言:照搬上方结构,但所有标签换成对应语言的自然表达。**不要把英文标签留在非英文正文里。**--**Marker reference table** (for translation; not a format template):--| Marker | Purpose | 中文 | 日本語 | 한국어 |-|--------|---------|------|--------|--------|-| `[Transition]` | Standalone bridge phrase opening each page after the first | `[过渡]` | `[つなぎ]` | `[전환]` |-| `[Pause]` | Whitespace after key content, letting the audience absorb | `[停顿]` | `[間]` | `[멈춤]` |-| `[Interactive]` | Prompt audience interaction | `[互动]` | `[問いかけ]` | `[상호작용]` |-| `[Data]` | Call out a data point | `[数据]` | `[データ]` | `[데이터]` |-| `[Scan Room]` | Observe room/audience | `[观察]` | `[観察]` | `[관찰]` |-| `[Benchmark]` | Reference a benchmark | `[对标]` | `[ベンチマーク]` | `[벤치마크]` |-| `Key points:` | Numbered key points line | `要点:` | `要点:` | `핵심 포인트:` |-| `Duration:` | Concrete time spent on the page | `时长:` | `所要時間:` | `소요 시간:` |-| `Flex:` | Optional flex/adjust note | `弹性:` | `調整:` | `조정:` |+> 日本語 / 한국어 / 其他语言:照搬同样的结构,用对应语言自然书写即可。-> Each style may extend with additional markers — see `executor-{style}.md`. For languages not listed, translate each label to the natural term in that language.+**Number readability**: TTS reads digits and symbols literally. Prefer fully-spelled forms in the language being spoken when literal pronunciation would be awkward (e.g. Chinese "百分之六十八" reads better than "68%"; "1-2分钟" reads as "一减二分钟"). Plain integers and percentages in English are fine as-is.**Common mistakes to avoid**:-- Copying `① ② ③` verbatim without filling in real points.-- Writing `Duration: X minutes` or a range like `1-2 minutes` instead of one concrete number.-- Leaving `[Transition]` / `Key points:` / `Duration:` in English while the body is Chinese (or any other language mismatch).+- Leaving any bracketed stage marker (`[过渡]` / `[Transition]` / `[Pause]` / `[Data]` / `[Scan Room]` / `[Interactive]` / `[Benchmark]` etc.) in the text — they will be read aloud literally.+- Adding `要点:① …` / `Key points: (1) …` / `时长:2分钟` / `Duration: 2 minutes` / `Flex: …` lines — TTS will speak "要点 一 …".+- Mixing languages within one deck's notes.### Task 2. Split Into Per-Page Note Filesdiff --git a/skills/ppt-master/references/executor-consultant-top.md b/skills/ppt-master/references/executor-consultant-top.mdindex f7a37d74..7f1ac82a 100644--- a/skills/ppt-master/references/executor-consultant-top.md+++ b/skills/ppt-master/references/executor-consultant-top.md@@ -157,44 +157,21 @@ MBB-level color usage is extremely restrained — color serves information:Targeting **executives / decision-makers**. Pyramid structure — every sentence carries information. Composed, authoritative, and insightful tone.-### Stage Direction Markers--| Marker | Purpose | Example |-|--------|---------|---------|-| `[Pause]` | Silence after key insight, let executives absorb | "This means we are missing a billion-dollar market. [Pause]" |-| `[Scan Room]` | Observe decision-makers' reactions, decide whether to elaborate | "[Scan Room] If there are questions, I can elaborate." |-| `[Data]` | Conversational number delivery | "[Data] 63% → nearly two-thirds" |-| `[Benchmark]` | Emphasize comparison baseline | "[Benchmark] Compared to the industry average of 12%, our 23% is nearly double" |-| `[Transition]` | Bridge from previous page, at start of each page's text | "[Transition] Building on the strategic framework, let's drill into the implementation path." |-### Notes Writing Guidelines-- **Pyramid structure**: Conclusion → Arguments → Details-- **Data contextualization**: Every number has a comparison reference-- **Executive language**: "The strategic implication is...", "The core insight is..."-- **Flex mechanism**: Annotate "content that can be skipped if time is tight" for flexible duration-- **Key points structure**: `Key points: (1) Core insight (2) Data support (3) Strategic implication`+Notes are pure spoken narration (TTS). No bracketed markers, no `Key points:` / `Duration:` / `Flex:` lines — see [executor-base.md §8](executor-base.md#8-speaker-notes-generation-framework).++- **Pyramid structure**: Conclusion → Arguments → Details, written as flowing prose.+- **Data contextualization**: Every number is paired with a comparison reference in the same sentence ("twenty-three percent — nearly double the industry average of twelve").+- **Executive language**: "The strategic implication is…", "The core insight is…".+- **Natural transitions**: Open each page after the first with a sentence that bridges from the prior page.### Notes Example```markdown# 03_strategic_path-[Transition] Having clarified the problem and the opportunity, now comes the most critical part — our response path.--We recommend a three-phase strategy. [Pause]--Phase one: Focus. Over the next six months, concentrate resources on conquering the Eastern China market.-[Data] Eastern China contributes nearly two-thirds of industry growth, [Benchmark] yet our penetration rate is only half of Competitor A's. [Pause]--Phase two: Expand. Use Eastern China as a template, replicate to Southern and Northern China.-Phase three: Scale. Leverage a digital platform for nationwide coverage.--[Scan Room] The resource allocation for phase one is in the appendix — would you like me to walk through it now?--Key points: (1) Focus-Expand-Scale three-phase approach (2) Data-backed Eastern China priority (3) 18-month full deployment-Duration: 3 minutes-Flex: [If time is tight, skip phase two and three details and go straight to financial impact]+Having clarified the problem and the opportunity, we arrive at the most critical part — our response path. The recommendation is a three-phase strategy: focus, expand, and scale. In phase one, over the next six months, we concentrate resources on conquering Eastern China, which contributes nearly two-thirds of industry growth yet sees our penetration rate at only half of Competitor A's. Phase two replicates that template to Southern and Northern China, and phase three leverages a digital platform for nationwide coverage over an eighteen-month horizon.```---@@ -218,5 +195,5 @@ Flex: [If time is tight, skip phase two and three details and go straight to fin### Notes Level- [ ] **Pyramid structure**: Every page is conclusion-first-- [ ] **Stage markers complete**: [Pause] and [Scan Room] at key positions-- [ ] **Flex content annotated**: Supports flexible duration+- [ ] **Pure spoken prose**: No bracketed stage markers, no `Key points:` / `Duration:` / `Flex:` meta-lines (TTS reads everything verbatim)+- [ ] **Data contextualized in prose**: Every number is paired with a comparison reference in the same sentencediff --git a/skills/ppt-master/references/executor-consultant.md b/skills/ppt-master/references/executor-consultant.mdindex 6088b91a..961ee40a 100644--- a/skills/ppt-master/references/executor-consultant.md+++ b/skills/ppt-master/references/executor-consultant.md@@ -156,37 +156,22 @@ Text: 14-16px, one-sentence summary of the page's core takeawayConsultant-style speaker notes use a **conclusion-driven** approach — state the conclusion first, then present supporting evidence. Professional, concise, and persuasive tone.-### Stage Direction Markers--| Marker | Purpose | Example |-|--------|---------|---------|-| `[Pause]` | Silence after key conclusions, let the audience absorb | "This means our market share is being eroded. [Pause]" |-| `[Data]` | Cue to verbalize numbers conversationally | "[Data] 85% → more than eight out of ten customers reported this issue" |-| `[Transition]` | Bridge from previous page, must be at start of each page's text | "[Transition] Based on that analysis, let's look at specific recommendations." |-### Notes Writing Guidelines-- **Conclusion first**: The first sentence of each page's notes is the core takeaway-- **Conversational data**: 30% → "roughly one-third", 85% → "more than eight out of ten", 2.5x → "two and a half times"-- **Evidence follows immediately**: After the conclusion, provide 2-3 supporting data points/facts-- **Professional terminology**: Use terms like "insight", "driver", "key lever" etc.-- **Key points structure**: `Key points: (1) Core conclusion (2) Supporting data (3) Next steps`+Notes are pure spoken narration (TTS). No bracketed markers, no `Key points:` / `Duration:` lines — see [executor-base.md §8](executor-base.md#8-speaker-notes-generation-framework).++- **Conclusion first**: The first sentence of each page's notes is the core takeaway.+- **Conversational data**: 30% → "roughly one-third", 85% → "more than eight out of ten", 2.5x → "two and a half times". Spell out percentages as words when the spoken form is more natural.+- **Evidence follows immediately**: After the conclusion, provide 2-3 supporting data points or facts in flowing prose.+- **Natural transitions**: Open each page after the first with a sentence that bridges from the prior page ("Building on that scan…", "Based on those findings…").+- **Professional terminology**: Use terms like "insight", "driver", "key lever".### Notes Example```markdown# 03_key_findings-[Transition] Based on our market scan, we have distilled three key findings.--First, the primary growth driver is shifting from acquisition to retention.-[Data] New customer acquisition cost rose nearly 40% year-over-year, yet improved repurchase rates contributed over 60% of revenue growth. [Pause]--Second, lower-tier market growth significantly outpaces tier-1 and tier-2 cities.-Third, the 25-35 female user segment has an ARPU 1.8x the overall average.--Key points: (1) Growth engine shifting from acquisition to retention (2) Lower-tier market opportunity window (3) High-value user persona-Duration: 2 minutes+Based on our market scan, we have distilled three key findings, and the most important is that the growth engine is shifting from acquisition to retention. New customer acquisition cost rose nearly forty percent year-over-year, yet improved repurchase rates contributed more than sixty percent of revenue growth. On top of that, lower-tier market growth significantly outpaces tier-one and tier-two cities, and the twenty-five to thirty-five female user segment now carries an ARPU nearly twice the overall average.```---@@ -199,3 +184,4 @@ Duration: 2 minutes- [ ] KPI cards have trend arrows and comparison annotations- [ ] Chart colors are unified, using monochromatic scheme rather than rainbow- [ ] Notes are conclusion-first with conversational data+- [ ] Notes contain no bracketed stage markers and no `Key points:` / `Duration:` meta-lines (TTS reads everything verbatim)diff --git a/skills/ppt-master/references/executor-general.md b/skills/ppt-master/references/executor-general.mdindex e023f683..2b7a9cd7 100644--- a/skills/ppt-master/references/executor-general.md+++ b/skills/ppt-master/references/executor-general.md@@ -80,38 +80,22 @@ Annotation layer → ~0.7-0.8x (e.g., 12-14px @ body=18) light gray, bottom-aGeneral style speaker notes use **conversational narration** — like talking with the audience, not reading a report. Natural tone with rhythm, using rhetorical devices where appropriate.-### Stage Direction Markers--| Marker | Purpose | Example |-|--------|---------|---------|-| `[Pause]` | Silence after key reveal, letting the audience absorb | "What does this number mean? [Pause] It means 1 in every 3 users..." |-| `[Interactive]` | Ask questions or guide audience participation | "[Interactive] How many of you have used this feature?" |-| `[Transition]` | Bridge from previous page, must be at start of each page's text | "[Transition] Now that we understand the context, let's see how it works." |-### Notes Writing Guidelines-- **Tell stories**: Use "scenario-conflict-resolution" structure for each page's narrative-- **Use metaphors**: Make abstract concepts tangible ("It's like adding a turbocharger to the system")-- **Create suspense**: Pose questions at the right time, answer on the next page-- **Conversational data**: 30% → "nearly one-third", 2.5x → "more than doubled"-- **Key points structure**: `Key points: (1) Core message (2) Supporting evidence (3) Call to action`+Notes are pure spoken narration (TTS). No bracketed markers, no `Key points:` / `Duration:` lines — see [executor-base.md §8](executor-base.md#8-speaker-notes-generation-framework).++- **Tell stories**: Use a "scenario-conflict-resolution" arc for each page's narrative.+- **Use metaphors**: Make abstract concepts tangible ("It's like adding a turbocharger to the system").+- **Create suspense**: Pose questions at the right moment and answer them on the next page — written as plain rhetorical questions, not as `[Interactive]` tags.+- **Conversational data**: 30% → "nearly one-third", 2.5x → "more than doubled". Spell out percentages as words when the spoken form is more natural.+- **Natural transitions**: Open each page after the first with a sentence that bridges from the prior page.### Notes Example```markdown# 03_key_advantages-[Transition] Having covered the market landscape, you might be wondering: where is our opportunity?--Our core advantages can be summed up in three words: Fast, Accurate, Efficient.-Fast — deployment time cut from 3 months to 2 weeks; [Pause]-Accurate — recognition accuracy at 97.3%, far exceeding the industry average of 82%;-Efficient — overall costs reduced by nearly one-third.--[Interactive] If you were the decision-maker, which of these three numbers would impress you most?--Key points: (1) Three differentiating advantages (2) Quantitative data support (3) Prompt for reflection-Duration: 2 minutes+Having covered the market landscape, you might be wondering — where is our opportunity? Our core advantages can be summed up in three words: fast, accurate, efficient. Fast, because deployment time has been cut from three months to two weeks. Accurate, because recognition accuracy now reaches ninety-seven point three percent, far exceeding the industry average of eighty-two. And efficient, because overall costs have been reduced by nearly a third — a combination that, if you were the decision-maker, would be hard to ignore.```---@@ -122,3 +106,4 @@ Duration: 2 minutes- [ ] Decorative elements are moderate: serving content, not overshadowing it- [ ] Image-text ratio is appropriate: not just text walls, visual highlights present- [ ] Notes are conversational: reads like speaking, not reading a script+- [ ] Notes contain no bracketed stage markers and no `Key points:` / `Duration:` meta-lines (TTS reads everything verbatim)