yao-tutorial-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Yao Tutorial Skill

Workflow

工作流

Normalize topic, audience, outcome, language, formats, user material, style references, and exclusions into
```
brief.json
```
.
Read
```
references/input-adaptation.md
```
; use user material as the spine when sufficient, then add only needed external research.

Read

references/research-sourcing.md

; create

research/user-materials-register.md

when needed,

research/source-register.md

, and

research/evidence-map.md

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

Read the editorial and visual references; create

visuals/visual-spec.json

, then run

build_visual_pack.py

and

capture_visuals.py

Read

references/export-workflow.md

; run

export_tutorial.py

and then

validate_package.py

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

将主题、受众、预期成果、语言、格式、用户提供的素材、风格参考及排除项标准化为
```
brief.json
```
。
阅读
```
references/input-adaptation.md
```
；当用户提供的素材足够完整时，以其为核心框架，仅补充必要的外部研究内容。

阅读

references/research-sourcing.md

；必要时创建

research/user-materials-register.md

，同时生成

research/source-register.md

和

research/evidence-map.md

。

阅读

references/tutorial-outline-and-writing.md

及

references/course-design-principles.md

；撰写

outline.md

，随后使用

第1章

和

1.1

格式编写独立的公开版

tutorial.md

。

阅读编辑与可视化参考资料；创建
```
visuals/visual-spec.json
```
，然后运行
```
build_visual_pack.py
```
和
```
capture_visuals.py
```
脚本。

阅读

references/export-workflow.md

；运行

export_tutorial.py

脚本，之后执行

validate_package.py

脚本。

准确报告失败情况及替代方案。严禁编造社交平台帖子、论文、代码库细节、日期或引用内容。

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.

当用户提供的素材足够明确时，其将主导教程的核心意图；外部资料仅用于验证内容和填补信息缺口。
公开导出的内容不得显示内部源ID或参考包来源信息。
教程内容需符合独立正式教学产品的风格。
每个编号章节都需配有对应的可视化规范及嵌入的可视化内容。
默认完整教程长度为5000-10000中文字符或3500-7000英文单词，除非有特殊要求。
HTML格式需使用居中的
```
report-shell
```
样式；DOCX/PDF格式不得包含可见的页眉、页脚、本地路径或打印控件。
交付成果需通过
```
scripts/validate_package.py
```
验证，或明确列出剩余的警告/失败项。

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

```
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