yao-tutorial-skill

Yao チュートリアルスキル

ワークフロー

1. トピック、対象読者、成果、言語、形式、ユーザー資料、スタイルの参考資料、除外事項を brief.json に整理します。
2. references/input-adaptation.md を読みます。ユーザー資料で十分な場合はそれを骨子として使い、必要な外部調査だけを追加します。
3. references/research-sourcing.md を読みます。必要に応じて research/user-materials-register.md を作成し、research/source-register.md と research/evidence-map.md を作成します。
4. references/tutorial-outline-and-writing.md と references/course-design-principles.md を読みます。outline.md、独立した公開用の tutorial.md（第1章 と 1.1 を使用）、research/chapter-quality-review.md を作成します。
5. 編集およびビジュアルに関する参考資料を読みます。visuals/visual-spec.json を作成してから、build_visual_pack.py と capture_visuals.py を実行します。
6. references/export-workflow.md を読みます。export_tutorial.py を実行してから、validate_package.py を実行します。
7. 正確な失敗内容と代替策を報告します。X の投稿、論文、リポジトリの詳細、日付、引用を捏造してはいけません。

品質ゲート

• ユーザー資料が十分な場合は、それを意図の基準とします。外部の根拠は検証と不足分の補完に使います。
• 公開用のエクスポートに、内部ソース ID や参考資料パケットの出所情報を表示してはいけません。
• 文章は、単独で成立する正式な教材として読めるものにします。
• 番号付きの各章に、対応するビジュアル仕様と埋め込みビジュアルを用意します。
• 深さは固定の文字数制限ではなく、学習に十分かどうかで判断します。学習者がトピックを理解し、応用し、自分で確認できるまで続けます。
• 番号付きの各章について、深さ、例、演習、根拠、ビジュアルとの適合性、後半の章との一貫性を個別に品質レビューします。
• HTML では中央揃えの report-shell を使用します。DOCX/PDF には、表示されるヘッダー、フッター、ローカルパス、印刷用の装飾を含めません。
• 納品物は scripts/validate_package.py の検証に合格するか、残っている警告や失敗を明記します。

参考資料

• 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