exercise-builder
为每个教程模块添加练习(输入、预期输出、验证步骤)并更新 `outline/module_plan.yml`。**触发**:练习、练习、验证清单、教程练习、可验证作业。**使用时机**:已有模块计划(`outline/module_plan.yml`),需要为每个模块补齐至少 1 个可验证练习才能形成教学循环。**如果**则跳过:还没有模块计划(先跑) `module-planner`)。**网络**:无。**Guardrail**:每个练习包含预期输出+验证步骤;避免只给出“思考题”无验收。
📖 中文导读:为每个教程模块添加练习(输入、预期输出、验证步骤)并更新 `outline/module_plan.yml`。**触发**:练习、练习、验证清单、教程练习、可验证作业。**使用时机**:已有模块计划(`outline/module_plan.yml`),需要为每个模块补齐至少 1 个可验证练习才能形成教学循环。**如果**则跳过:还没有模块计划(先跑) `module-planner`)。**网络**:无。**Guardrail**:每个练习包含预期输出+验证步骤;避免只给出“思考题”无验收。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
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:
promptexpected_outputverification_steps(a checklist)
Workflow
- Read
outline/module_plan.ymland enumerate modules. - For each module, design ≥1 exercise that directly verifies the module objectives.
- Ensure every exercise has an expected output and a verification checklist.
- Update
outline/module_plan.ymlin place.
Definition of Done
- Every module in
outline/module_plan.ymlhas ≥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_stepsso the tutorial stays coherent.