---

name: exercise-builder description: | Add exercises to each tutorial module (inputs, expected outputs, verification steps) and update outline/module_plan.yml. Trigger: exercises, practice, verification checklist, 教程练习, 可验证作业. Use when: 已有模块计划（outline/module_plan.yml），需要为每个模块补齐至少 1 个可验证练习以形成 teaching loop。 Skip if: 还没有 module plan（先跑 module-planner）。 Network: none. Guardrail: 每个练习必须包含 expected output + verification steps；避免只给“思考题”无验收。

Exercise Builder

Goal: attach at least one verifiable exercise to every module so the tutorial has a teaching loop.

Inputs

• outline/module_plan.yml

Outputs

• Updated outline/module_plan.yml

Exercise schema (recommended)

For each module, add an exercises list. Each exercise should contain:

• prompt
• expected_output
• verification_steps (a checklist)

Workflow

1. Read outline/module_plan.yml and enumerate modules.
2. For each module, design ≥1 exercise that directly verifies the module objectives.
3. Ensure every exercise has an expected output and a verification checklist.
4. Update outline/module_plan.yml in place.

Definition of Done

• Every module in outline/module_plan.yml has ≥1 exercise.
• Every exercise includes expected_output + verification_steps.

Troubleshooting

Issue: exercises are open-ended with no verification

Fix:

• Convert them into “do X → observe Y → verify Z” with concrete artifacts.

Issue: exercises drift from the running example

Fix:

• Re-anchor each exercise to the module’s running_example_steps so the tutorial stays coherent.