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(entry): tighten CLAUDE.md / AGENTS.md and add repo-wide conventions
hugohe36bc8ebd6963c
diff --git a/AGENTS.md b/AGENTS.mdindex 25fb6e4d..17976a8b 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -2,7 +2,7 @@This file is the project entry point for general AI agents.-Before any PPT generation task, **you MUST first read [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md)** — the authoritative workflow for project creation, role switching, serial execution, quality gates, post-processing, and export.+**You MUST read [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) before any PPT generation task or repo modification.** This repository exists to generate presentations; SKILL.md is the authoritative workflow that owns project creation, role switching, serial execution, quality gates, post-processing, export, and every per-step command. The rest of this file only points to where related material lives — it never substitutes for SKILL.md.## Project Overview@@ -21,22 +21,26 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat> Object-level animation tuning: when the user asks to change animation order, effect, timing, or a specific object's reveal behavior, run the standalone [`customize-animations`](skills/ppt-master/workflows/customize-animations.md) workflow. Default export already has global animations; do not create `animations.json` unless customization was requested.>> Live preview: any time the user mentions "live preview", "preview", "看效果", or wants to click/select a slide element, run [`live-preview`](skills/ppt-master/workflows/live-preview.md). Step 6 auto-starts it during generation; the workflow covers post-export re-entry and applying submitted annotations.+>+> Brand identity setup: when the user asks to "set up brand" / "建立品牌" / "做品牌规范", provides a brand asset (logo / brand site URL / branded PPTX / brand PDF), or wants to extract a brand from existing materials, run the standalone [`create-brand`](skills/ppt-master/workflows/create-brand.md) workflow. Output goes to `skills/ppt-master/templates/brands/<id>/`. Brands apply at SKILL.md Step 3 via the same explicit-path rule as layout templates — the user supplies the brand directory path to apply it; bare brand names never trigger.## Execution Requirements-- Read [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) before starting a PPT task.-- For standalone template creation, read [`skills/ppt-master/workflows/create-template.md`](skills/ppt-master/workflows/create-template.md).-- Role-specific rules live in [`skills/ppt-master/references/`](skills/ppt-master/references/).+- For standalone template creation (no source deck), read [`skills/ppt-master/workflows/create-template.md`](skills/ppt-master/workflows/create-template.md).- Technical SVG/PPT constraints live in [`skills/ppt-master/references/shared-standards.md`](skills/ppt-master/references/shared-standards.md).- Canvas choices live in [`skills/ppt-master/references/canvas-formats.md`](skills/ppt-master/references/canvas-formats.md).- Icon library details live in [`skills/ppt-master/templates/icons/README.md`](skills/ppt-master/templates/icons/README.md).-- Before editing prompt files under `skills/ppt-master/references/` or Python under `skills/ppt-master/scripts/`, consult the matching style rule in [`docs/rules/`](docs/rules/).++## Required Conventions++- **Repo-wide style rules** — when editing prompt files under [`skills/ppt-master/references/`](skills/ppt-master/references/), Python under [`skills/ppt-master/scripts/`](skills/ppt-master/scripts/), or any other code/prose in the repo, follow the matching style rule in [`docs/rules/`](docs/rules/).+- **Markdown language consistency** — Markdown files under `skills/ppt-master/workflows/`, `skills/ppt-master/references/`, and `docs/` are currently single-language per directory. New files mirror the language of their siblings; do not mix English scaffolding with Chinese paragraphs (or vice versa) inside one file. Chat replies are unaffected.## Compatibility Boundary- This repository is a workflow/skill package, not an app or service scaffold.-- Do NOT assume conventions like `.worktrees/`, `tests/`, or mandatory branch setup unless the user explicitly requests them.-- On conflict with a generic coding skill, prioritize [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) and this file inside this repository.+- Do NOT assume generic-project conventions like `.worktrees/`, `tests/`, or mandatory branch setup unless the user explicitly requests them.+- On conflict with a generic coding skill, prioritize [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) inside this repository.## Command Quick Reference@@ -71,6 +75,7 @@ python3 skills/ppt-master/scripts/animation_config.py validate <project_path> #python3 skills/ppt-master/scripts/total_md_split.py <project_path>python3 skills/ppt-master/scripts/finalize_svg.py <project_path>python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path>+# Add --merge-paragraphs when the user wants paragraph-level editable text frames instead of one-per-line (default off, see SKILL.md Step 7.3).```## Core Directories@@ -79,6 +84,9 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path>- `skills/ppt-master/references/` — role definitions and technical specifications.- `skills/ppt-master/scripts/` — runnable tool scripts.- `skills/ppt-master/scripts/docs/` — topic-focused script docs.-- `skills/ppt-master/templates/` — layout templates, chart templates, icon library.+- `skills/ppt-master/templates/` — layout templates, chart templates, icon library, brand presets.+- `skills/ppt-master/workflows/` — standalone workflow files.+- `docs/` — user-facing documentation (FAQ, installation, technical design, templates guide, audio narration).+- `docs/rules/` — repo-wide style rules.- `examples/` — example projects.- `projects/` — user project workspace.diff --git a/CLAUDE.md b/CLAUDE.mdindex a2a6b92c..528fdf49 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -2,7 +2,7 @@This file is the project entry point for Claude Code.-Before any PPT generation task, **you MUST first read [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md)** — the authoritative workflow for project creation, role switching, serial execution, quality gates, post-processing, and export.+**You MUST read [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) before any PPT generation task or repo modification.** This repository exists to generate presentations; SKILL.md is the authoritative workflow that owns project creation, role switching, serial execution, quality gates, post-processing, export, and every per-step command. The rest of this file only points to where related material lives — it never substitutes for SKILL.md.## Project Overview@@ -26,19 +26,21 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat## Execution Requirements-- Read [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) before starting a PPT task.-- For standalone template creation, read [`skills/ppt-master/workflows/create-template.md`](skills/ppt-master/workflows/create-template.md).-- Role-specific rules live in [`skills/ppt-master/references/`](skills/ppt-master/references/).+- For standalone template creation (no source deck), read [`skills/ppt-master/workflows/create-template.md`](skills/ppt-master/workflows/create-template.md).- Technical SVG/PPT constraints live in [`skills/ppt-master/references/shared-standards.md`](skills/ppt-master/references/shared-standards.md).- Canvas choices live in [`skills/ppt-master/references/canvas-formats.md`](skills/ppt-master/references/canvas-formats.md).- Icon library details live in [`skills/ppt-master/templates/icons/README.md`](skills/ppt-master/templates/icons/README.md).-- Before editing prompt files under `skills/ppt-master/references/` or Python under `skills/ppt-master/scripts/`, consult the matching style rule in [`docs/rules/`](docs/rules/).++## Required Conventions++- **Repo-wide style rules** — when editing prompt files under [`skills/ppt-master/references/`](skills/ppt-master/references/), Python under [`skills/ppt-master/scripts/`](skills/ppt-master/scripts/), or any other code/prose in the repo, follow the matching style rule in [`docs/rules/`](docs/rules/).+- **Markdown language consistency** — Markdown files under `skills/ppt-master/workflows/`, `skills/ppt-master/references/`, and `docs/` are currently single-language per directory. New files mirror the language of their siblings; do not mix English scaffolding with Chinese paragraphs (or vice versa) inside one file. Chat replies are unaffected.## Compatibility Boundary- This repository is a workflow/skill package, not an app or service scaffold.-- Do NOT assume conventions like `.worktrees/`, `tests/`, or mandatory branch setup unless the user explicitly requests them.-- On conflict with a generic coding skill, prioritize [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) and this file inside this repository.+- Do NOT assume generic-project conventions like `.worktrees/`, `tests/`, or mandatory branch setup unless the user explicitly requests them.+- On conflict with a generic coding skill, prioritize [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) inside this repository.## Command Quick Reference@@ -73,6 +75,7 @@ python3 skills/ppt-master/scripts/animation_config.py validate <project_path> #python3 skills/ppt-master/scripts/total_md_split.py <project_path>python3 skills/ppt-master/scripts/finalize_svg.py <project_path>python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path>+# Add --merge-paragraphs when the user wants paragraph-level editable text frames instead of one-per-line (default off, see SKILL.md Step 7.3).```## Core Directories@@ -81,6 +84,9 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path>- `skills/ppt-master/references/` — role definitions and technical specifications.- `skills/ppt-master/scripts/` — runnable tool scripts.- `skills/ppt-master/scripts/docs/` — topic-focused script docs.-- `skills/ppt-master/templates/` — layout templates, chart templates, icon library.+- `skills/ppt-master/templates/` — layout templates, chart templates, icon library, brand presets.+- `skills/ppt-master/workflows/` — standalone workflow files.+- `docs/` — user-facing documentation (FAQ, installation, technical design, templates guide, audio narration).+- `docs/rules/` — repo-wide style rules.- `examples/` — example projects.- `projects/` — user project workspace.