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(rules): allow unit tests under scripts/tests/ on conditions instead of forbidding them
hugohe38e5be7c05989
diff --git a/AGENTS.md b/AGENTS.mdindex 26824139..7b976bbe 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -49,7 +49,7 @@ PPT Master turns source material into natively editable DrawingML PPTX. Generate## Compatibility Boundary- This repository is a workflow/skill package, not an app or service scaffold.-- Do NOT assume generic-project conventions like `.worktrees/`, `tests/`, or mandatory branch setup unless the user explicitly requests them.+- Do NOT assume generic-project conventions like `.worktrees/`, CI, or mandatory branch setup unless the user explicitly requests them. The only test location is `skills/ppt-master/scripts/tests/` under the conditions in [`docs/rules/code-style.md`](docs/rules/code-style.md) §11.- On conflict with a generic coding skill, prioritize [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) inside this repository.## Command Quick Referencediff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 597aa5d3..ac249cda 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -80,7 +80,7 @@ If you're unsure, open an issue to ask — that's always welcome.1. **Fork** the repository and create a branch from `main`2. **One PR, one thing** — keep each PR focused on a single concern. If you notice unrelated improvements, open a separate PR3. **Write a useful PR description** — explain *what* changed and *why*, not just a diff summary. If your change fixes a bug, include reproduction steps-4. **Test locally** before submitting — run the affected scripts and verify output+4. **Test locally** before submitting — run the affected scripts on a real project and show the output. Unit tests are optional and live only under `skills/ppt-master/scripts/tests/` on the standard library `unittest` (see [`docs/rules/code-style.md`](docs/rules/code-style.md) §11); a green suite does not replace the real-project run5. **Don't overstate** — if your PR description claims tests or behavior changes, make sure the diff actually contains them## Review Processdiff --git a/docs/rules/code-style.md b/docs/rules/code-style.mdindex 189b2b28..48194043 100644--- a/docs/rules/code-style.md+++ b/docs/rules/code-style.md@@ -261,22 +261,22 @@ def classify_license(## 11. Testing-**Hard rule**: this repository does **not** ship automated tests.+**Default — tests are allowed only under `skills/ppt-master/scripts/tests/` (may override only by editing this rule)**. The repository stays a workflow/skill package: no CI, no pytest, no coverage tooling, no merge gate. Tests exist so that a checker/exporter fix can be re-run in seconds after the next fix lands; they are a regression net, not a substitute for running the real thing.-**Forbidden**:+**Allowed**:-- `tests/` directories-- `test_*.py` files-- `unittest` / `pytest` imports-- `if __name__ == "__main__":` blocks that run a self-test suite+- `skills/ppt-master/scripts/tests/test_<topic>.py` modules on the standard library `unittest`, run one module at a time: `cd skills/ppt-master/scripts && python3 -m unittest tests.test_<topic>` (`discover` is not supported here)+- Cases that exercise `scripts/` Python through its public entry points (CLI `main(argv)`, the converter, the checker) on minimal fixtures built inside the test — a short SVG or JSON string, a temporary directory+- Mocked network calls; never a live provider request or an installed-package assumption beyond `requirements.txt`-**Use instead**:+**Forbidden**:-- Inline smoke commands via `python3 -c "..."` against real project samples; show the output in the conversation / PR description-- Manual verification steps in the runbook-- Live-API smoke runs against `projects/_smoke_*` directories (gitignored)+- `tests/` directories anywhere else, `test_*.py` next to the code, `pytest` / third-party test frameworks, `if __name__ == "__main__":` self-test blocks+- Tests for prompt text, workflow documents, or templates — those are governed by `prompt_audit.py` and review+- Fixtures that depend on files outside the test module (except the bundled template library under `templates/`)+- Treating a green suite as verification: a change to conversion behaviour is still smoke-run against a real project (`python3 -c "..."`, `svg_quality_checker.py`, `svg_to_pptx.py` on a `/tmp` copy) and the output is shown in the conversation / PR description-This is a deliberate project convention. When external contributors include tests, ask them to remove tests in PR review (see [`docs/rules/prompt-style.md`](./prompt-style.md) §11 for the parallel rule on reference docs).+Contributors may include tests for the scripts they change; reviewers never require them, and a PR that claims "tests pass" without a real-project smoke run is reviewed as untested (see [`CONTRIBUTING.md`](../../CONTRIBUTING.md)).---