1---2name: yao-tutorial-skill3description: Create standalone beginner tutorial packages from a topic or supplied references, with adaptive research, course-style outline design, chapter visuals, and Markdown/DOCX/PDF/HTML exports. Use for textbook-like tutorials, course guides, teaching documents, or long beginner guides; not for quick answers, link summaries, pure diagrams, or file conversion.4---56# Yao Tutorial Skill78## Workflow9101. Normalize topic, audience, outcome, language, formats, user material, style references, and exclusions into `brief.json`.112. Read `references/input-adaptation.md`; use user material as the spine when sufficient, then add only needed external research.123. Read `references/research-sourcing.md`; create `research/user-materials-register.md` when needed, `research/source-register.md`, and `research/evidence-map.md`.134. Read `references/tutorial-outline-and-writing.md` plus `references/course-design-principles.md`; write `outline.md`, then standalone public `tutorial.md` using `第1章` and `1.1`.145. Read the editorial and visual references; create `visuals/visual-spec.json`, then run `build_visual_pack.py` and `capture_visuals.py`.156. Read `references/export-workflow.md`; run `export_tutorial.py` and then `validate_package.py`.167. Report exact failures and fallbacks. Never fabricate X posts, papers, repo details, dates, or citations.1718## Quality Gates1920- User material controls intent when strong enough; external evidence fills verification and gaps.21- Public exports never show internal source IDs or reference-packet provenance.22- Copy reads as a standalone formal teaching product.23- Every numbered chapter has a matching visual spec and embedded visual.24- Default full tutorial length is `5000-10000` Chinese characters or `3500-7000` English words unless requested otherwise.25- HTML uses centered `report-shell`; DOCX/PDF have no visible headers, footers, local paths, or print chrome.26- Delivery passes `scripts/validate_package.py` or names the remaining warnings/failures.2728## References2930- `references/input-adaptation.md`31- `references/research-sourcing.md`32- `references/tutorial-outline-and-writing.md`33- `references/course-design-principles.md`34- `references/editorial-production.md`35- `references/visual-html-workflow.md`36- `references/visual-board-benchmarks.md`37- `references/export-workflow.md`38- `scripts/build_visual_pack.py`, `scripts/capture_visuals.py`, `scripts/export_tutorial.py`, `scripts/validate_package.py`39- `templates/topic-brief-template.json`, `templates/visual-spec-template.json`, `templates/tutorial-style.css`
dqtx760