Yao Tutorial Skill

Workflow

1. Normalize topic, audience, outcome, language, formats, user material, style references, and exclusions into

   brief.json

   .
2. Read

   references/input-adaptation.md

   ; use user material as the spine when sufficient, then add only needed external research.
3. Read

   references/research-sourcing.md

   ; create

   research/user-materials-register.md

   when needed,

   research/source-register.md

   , and

   research/evidence-map.md

   .
4. 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

   .
5. Read the editorial and visual references; create

   visuals/visual-spec.json

   , then run

   build_visual_pack.py

   and

   capture_visuals.py

   .
6. Read

   references/export-workflow.md

   ; run

   export_tutorial.py

   and then

   validate_package.py

   .
7. Report exact failures and fallbacks. Never fabricate X posts, papers, repo details, dates, or citations.

Quality Gates

• User material controls intent when strong enough; external evidence fills verification and gaps.
• Public exports never show internal source IDs or reference-packet provenance.
• Copy reads as a standalone formal teaching product.
• Every numbered chapter has a matching visual spec and embedded visual.
• Default full tutorial length is

  5000-10000

  Chinese characters or

  3500-7000

  English words unless requested otherwise.
• HTML uses centered

  report-shell

  ; DOCX/PDF have no visible headers, footers, local paths, or print chrome.
• Delivery passes

  scripts/validate_package.py

  or names the remaining warnings/failures.

References

• references/input-adaptation.md

• references/research-sourcing.md

• references/tutorial-outline-and-writing.md

• references/course-design-principles.md

• references/editorial-production.md

• references/visual-html-workflow.md

• references/visual-board-benchmarks.md

• references/export-workflow.md

• scripts/build_visual_pack.py

  ,

  scripts/capture_visuals.py

  ,

  scripts/export_tutorial.py

  ,

  scripts/validate_package.py

• templates/topic-brief-template.json

  ,

  templates/visual-spec-template.json

  ,

  templates/tutorial-style.css