关于 module-planner
module-planner 将概念图整理为适合教学的有序模块计划,供教程后续阶段使用。它要求每个模块包含目标、产出和贯穿示例步骤。
主要功能
- 01按概念依赖排序
- 02将概念聚合为模块
- 03为模块设定可衡量目标
- 04定义具体产出与示例步骤
适用场景
- 01从现有概念图规划教程模块
- 02为后续教程阶段生成模块计划
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ willoscar/ research-units-pipeline-skills --skill module-planner安装后在 Claude Code 中输入/module-planner确认已加载。
附带文件scripts/run.py
详细介绍
模块规划器
触发条件与路由
- 触发条件:module plan、tutorial modules、course outline、模块规划、module_plan.yml。
- 适用场景:教程的 C2 阶段,已有
outline/concept_graph.yml,需要将概念 DAG 收敛为模块顺序。 - 跳过条件:尚无概念图。
- 网络:无。
- 约束:每个模块都必须包含 objectives、outputs 和 running-example step;不要写长篇散文。
将概念图转换为后续教程阶段使用的可教学模块序列。
输入
outline/concept_graph.yml
输出
outline/module_plan.yml
契约
模块计划必须定义:
- 有序的
modules id、titleobjectivesconceptsoutputsrunning_example_steps
脚本边界
scripts/run.py 应:
- 按拓扑顺序排列概念
- 将概念归类为连贯的模块
- 添加可衡量的目标和具体产出
图遍历和聚类启发式应放在共享的教程工具中,而不是封装脚本中。
验收标准
outline/module_plan.yml存在- 每个概念节点至少包含在一个模块中
- 每个模块都包含 objectives 和 outputs
非目标
- 来源依据审查
- 编写练习
- 起草教程
评论
支持 Markdown