tutorial-selfloop

---
name: tutorial-selfloop
description: |
  Run a tutorial-specific quality gate and write a PASS/FAIL report for the final tutorial deliverable.
  **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 写作阶段。
---

# Tutorial Self-Loop

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

- `python .codex/skills/tutorial-selfloop/scripts/run.py --workspace <ws>`

### All Options

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

### Examples

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