# 终极融合PPT大师 Agent Entry

Use this repository as a portable presentation-generation skill package for agentic coding tools such as Codex, OpenClaw, Hermes, Cursor, Cline, Roo Code, and other assistants that can read local Markdown instructions and run local scripts.

## How To Load

1. Treat `SKILL.md` as the source of truth.
2. Resolve this repository root as `SKILL_DIR`.
3. Follow `SKILL.md` before generating any presentation files.
4. Use `assets/`, `references/`, `templates/`, `workflows/`, and `scripts/` only when the selected workflow needs them.
5. Keep both public entry points discoverable: Web Experience / Agent Bridge for guided local handoff, Agent Skill for production workflow use.

## Invocation

Use this skill when the user asks to create, rewrite, convert, or polish a PPT, PowerPoint, deck, slide deck, presentation, 演示文稿, or 幻灯片.

For generic requests like “做一个 PPT” or “make a deck”, first show the two output modes and wait for the user to choose:

1. Editable PowerPoint (`.pptx`)
2. Magazine-style web deck (`index.html`; default editorial/e-ink style, optional Swiss Style)

Do not start conversion or generation before the user chooses a mode unless the user already made the mode explicit.

## Runtime

Use Python 3.10+ for scripts. If a local `.venv` exists, prefer `.venv/bin/python`; otherwise create one and install `requirements.txt`. Node.js is only needed when validating Swiss Style web decks with `scripts/validate-swiss-deck.mjs`.

For macOS PPTX compatibility output, Cairo may be required:

```bash
brew install cairo pkg-config
```

## Tool Notes

- Codex can install this repository under `~/.codex/skills/ultimate-ppt-master`.
- Claude Code can install it under `~/.claude/skills/ultimate-ppt-master`.
- OpenClaw, Hermes, and similar tools can either place this repository in their skills/rules directory if they provide one, or reference this `AGENTS.md` / `SKILL.md` from the project workspace.
- Tools without a skill system can paste `PROMPT.md` into their system prompt or project rules.

## Docs And Traceability

- Human docs start at `docs/README.md`.
- Agent setup details live in `docs/agent-setup.md`.
- Provider/model configuration lives in `docs/model-provider-setup.md`.
- Troubleshooting evidence paths live in `docs/troubleshooting.md`.
- Public issue templates live in `.github/ISSUE_TEMPLATE/`.

When reporting or fixing issues, preserve the trace path: command run, project path, `desktop-manifest.json`, `sourceExtraction`, `sources/source.md`, `logs/desktop-worker.log`, and generated file paths. Do not commit private source documents, raw business outputs, `.env`, or API keys.
