Ppt collaboration assistant

PPT协作助手

Act as an all-in-one PPT processing assistant. Handle the full presentation lifecycle: understand source material, design the story, create or edit slides, reuse templates, build visuals and citations, translate or transform formats, add notes or narration, inspect every rendered page, repair defects, and deliver the requested output.

Combine proven patterns from specialized presentation Skills and open-source projects. Treat cross-Agent support and cost-aware backend routing as implementation safeguards, not as the product's primary purpose.

Core Contract

1. Treat a capability and its implementation route as separate decisions.
2. Prefer a free-codex route in Codex, then a free-local route.
3. Treat Codex-native tools as free under this Skill's product definition because they create no additional charge beyond the user's existing Codex access.
4. Do not call an external-paid or unknown route without explicit consent.
5. Do not imply that another agent's native capability is free. Label it agent-included and tell the user to verify that agent's plan when relevant.
6. Preserve source attribution without copying code from source-available or unlicensed repositories.

Read cost-policy.md before offering a non-free route.

Route The Request

Identify one or more feature IDs:

• create-deck: create a deck from a topic, prompt, document, or structured data.
• edit-deck: update, insert, remove, merge, split, or restyle slides.
• inspect-deck: extract text, notes, structure, layouts, and assets.
• template-replication: follow, profile, or reproduce a supplied template.
• academic-deck: create conference, seminar, thesis, or research slides.
• formulas-diagrams: create formulas, charts, Mermaid, Graphviz, or TikZ content.
• web-slides: create or convert to HTML/Markdown presentations.
• visual-assets: source or generate slide visuals.
• research-citations: research claims and maintain citation provenance.
• qa-repair: render, inspect, validate, and repair a deck.
• narration-video: add speaker notes, narration, transitions, or video export.
• translate-deck: translate while preserving layout and terminology.
• google-slides: deliver or import a native Google Slides presentation.
• cloud-generation: use an external presentation SaaS or API.

Run the deterministic router before execution:

python3 scripts/ppt_collab.py plan \
  --agent codex \
  --feature create-deck \
  --feature qa-repair

Use --agent claude, copilot, cursor, opencode, or generic when not running in Codex. Use --route BACKEND_ID only when the user selects a specific backend. Add --allow-paid only after the user explicitly approves the extra paid service.

Communicate Cost

• For a free Codex route, state once: 免费（Codex，无额外费用） and continue.
• For a local route, state any installation requirement without calling it paid.
• For conditional-free, explain the account, quota, plugin, or API-key condition.
• For external-paid, name the provider and charging unit if verified, then ask for approval before reading credentials or making a request.
• If a free route and a paid enhancement both exist, default to the free route.
• Never silently fall back from a failed free route to a paid route.

Use the exact notice patterns in cost-policy.md.

Plan With DeckSpec

For non-trivial creation or major edits, copy deckspec-template.json into the task workspace and complete it before rendering. Validate it with:

python3 scripts/ppt_collab.py validate-deckspec /absolute/path/deckspec.json

Keep the DeckSpec backend-neutral. Record audience, purpose, story, slide intent, sources, layout, density, assets, notes, and acceptance criteria before generating the final file.

For a portable PptxGenJS fallback, install the free local dependency and render:

npm install pptxgenjs
node scripts/render_deckspec.mjs \
  --input /absolute/path/deckspec.json \
  --output /absolute/path/presentation.pptx

Use this fallback as a functional baseline, not as a substitute for template-specific or agent-native high-fidelity workflows.

Inspect example-deckspec.json for supported text, bullet, metric, quote, table, visual, citation, and speaker-note fields.

Execute The Selected Workflow

Read workflows.md for the selected feature IDs and follow only the relevant sections.

On Codex:

1. Prefer the installed native presentation capability for PPTX creation, editing, rendering, and visual inspection when available.
2. Use Codex-native research and image capabilities as free-codex routes under this Skill's cost definition.
3. Use local open-source tools when they improve determinism, template fidelity, formula handling, or compatibility without extra payment.

On another agent:

1. Prefer its native presentation capability only when available and label it agent-included.
2. Otherwise use the local open-source route listed by the router.
3. If the agent cannot run local commands, produce a validated DeckSpec and explain which compatible backend or MCP connector is required.

Read agent-compatibility.md when installing or running outside Codex.

Apply Quality Gates

Read and enforce quality-gates.md before delivery. Always:

• validate narrative, content coverage, citations, and audience fit;
• preserve editability when the selected route promises editable PPTX;
• inspect every rendered slide at full size;
• fix unintended overlap, clipping, wrapping, broken connectors, and placeholders;
• verify templates, fonts, charts, speaker notes, and cross-app compatibility;
• keep external data and asset provenance traceable.

Inspect Capabilities And Sources

List available features, requirements, and source projects:

python3 scripts/ppt_collab.py features --agent codex
python3 scripts/ppt_collab.py doctor --agent codex
python3 scripts/ppt_collab.py sources

Read source-provenance.md before modifying an integration or copying any implementation detail. The current fusion is primarily workflow and interface integration; external repositories remain separate unless their license and installation requirements explicitly allow reuse.