Tutorial Selfloop

Tutorial Self-Loop

Triggers & routing

• Trigger: tutorial self-loop, tutorial quality gate, tutorial pass/fail, 教程自循环, 教程质量门.
• Use when: source-tutorial 的 C3，已经有 output/TUTORIAL.md，想在交付前确认它满足教程合同而不是普通长文。
• Skip if: 还没有 tutorial 正文。
• Network: none.
• Guardrail: 报告缺口时不要发明内容；把失败清楚地路由回 tutorial 写作阶段。

Goal: converge the tutorial deliverable to a stable teaching-quality bar.

The gate should compare output/TUTORIAL.md against the intended module shape from outline/module_plan.yml, rather than acting like a generic prose checker.

Inputs

• output/TUTORIAL.md
• outline/module_plan.yml

Outputs

• output/TUTORIAL_SELFLOOP_TODO.md

Checks

• reader orientation section exists
• at least one real module exists
• each module has teaching components, not just a block of prose
• source notes are visible but lightweight

Script

Quick Start

• uv run python .codex/skills/tutorial-selfloop/scripts/run.py --workspace <workspace>

All Options

• --workspace <dir> (required)
• --unit-id <U###>
• --inputs <semicolon-separated>
• --outputs <semicolon-separated>
• --checkpoint <C#>

Examples

• Run the tutorial gate:
  • uv run python .codex/skills/tutorial-selfloop/scripts/run.py --workspace <workspace>