yao-tutorial-skill

1# Yao Tutorial Skill
2 
3## Workflow
4 
51. Normalize topic, audience, outcome, language, formats, user material, style references, and exclusions into `brief.json`.
62. Read `references/input-adaptation.md`; use user material as the spine when sufficient, then add only needed external research.
73. Read `references/research-sourcing.md`; create `research/user-materials-register.md` when needed, `research/source-register.md`, and `research/evidence-map.md`.
84. Read `references/tutorial-outline-and-writing.md` plus `references/course-design-principles.md`; write `outline.md`, standalone public `tutorial.md` using `第1章` and `1.1`, and `research/chapter-quality-review.md`.
95. Read the editorial and visual references; create `visuals/visual-spec.json`, then run `build_visual_pack.py` and `capture_visuals.py`.
106. Read `references/export-workflow.md`; run `export_tutorial.py` and then `validate_package.py`.
117. Report exact failures and fallbacks. Never fabricate X posts, papers, repo details, dates, or citations.
12 
13## Quality Gates
14 
15- User material controls intent when strong enough; external evidence fills verification and gaps.
16- Public exports never show internal source IDs or reference-packet provenance.
17- Copy reads as a standalone formal teaching product.
18- Every numbered chapter has a matching visual spec and embedded visual.
19- Depth is governed by learning sufficiency, not a fixed word limit; continue until the learner can understand, apply, and self-check the topic.
20…