关于 exercise-builder
exercise-builder 是一项教程写作技能,为现有模块计划中的每个模块补充可验证的练习。练习包含题目、预期输出和验证步骤。
主要功能
- 01为计划中的模块添加练习
- 02包含预期输出
- 03定义验证步骤
- 04原位更新模块计划
适用场景
- 01为教程模块添加实践内容
- 02让模块练习具备可核验结果
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ willoscar/ research-units-pipeline-skills --skill exercise-builder安装后在 Claude Code 中输入/exercise-builder确认已加载。
附带文件scripts/run.py
详细介绍
练习构建器
触发条件与路由
- 触发条件:练习、实践、验证清单、教程练习、可验证作业。
- 使用场景:教程的 C2 阶段,已有
outline/module_plan.yml,需要为每个模块补齐 exercise / expected output / verification steps。 - 跳过条件:尚无 module plan。
- 网络:无。
- 护栏:练习必须可验证,不能只是开放式思考题。
为每个已规划的教程模块添加最简的确定性练习约定。
输入
outline/module_plan.yml
输出
- 更新后的
outline/module_plan.yml
约定
每个模块最终都必须至少包含一个 exercise,其中包含:
promptexpected_outputverification_steps
脚本边界
scripts/run.py 应:
- 加载当前的模块计划
- 以确定性方式补齐缺失的练习
- 将计划写回原文件
应将练习措辞逻辑放在共享的教程工具中,而不是在技能脚本里反复硬编码。
验收标准
- 每个模块都有
exercises - 每个练习都包含
expected_output - 每个练习都包含
verification_steps
非目标
- 源内容覆盖审计
- 教程正文撰写
评论
支持 Markdown