module-planner

WILLOSCAR 的头像作者 WILLOSCAR

从概念图中规划教程模块,包括模块目标和排序,保存为 `outline/module_plan.yml`。**触发**:模块计划、教程模块、课程大纲、模块规划、module_plan.yml。**使用时机**:教程流程的结构阶段(C2),已有`outline/concept_graph.yml`,需要把概念依赖转成可教学的模块序列。**如果**:还没有概念图(先跑) `concept-graph`)。**网络**:无。**护栏**:每个模块明确的目标+输出(最好含运行示例步骤);避免散文段落。

📖 中文导读:从概念图中规划教程模块,包括模块目标和排序,保存为 `outline/module_plan.yml`。**触发**:模块计划、教程模块、课程大纲、模块规划、module_plan.yml。**使用时机**:教程流程的结构阶段(C2),已有`outline/concept_graph.yml`,需要把概念依赖转成可教学的模块序列。**如果**:还没有概念图(先跑) `concept-graph`)。**网络**:无。**护栏**:每个模块明确的目标+输出(最好含运行示例步骤);避免散文段落。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: module-planner description: | Plan tutorial modules from a concept graph, including module objectives and sequencing, saving as outline/module_plan.yml. Trigger: module plan, tutorial modules, course outline, 模块规划, module_plan.yml. Use when: tutorial pipeline 的结构阶段(C2),已有 outline/concept_graph.yml,需要把概念依赖转成可教学的模块序列。 Skip if: 还没有 concept graph(先跑 concept-graph)。 Network: none. Guardrail: 每模块明确 objectives + outputs(最好含 running example 步骤);避免 prose 段落。

Module Planner

Goal: turn a concept DAG into a teachable module sequence with clear objectives and outputs.

Inputs

  • outline/concept_graph.yml

Outputs

  • outline/module_plan.yml
  • modules: ordered list of modules
    • id, title
    • objectives (3–6 measurable bullets)
    • concepts (node ids from outline/concept_graph.yml)
    • outputs (what the learner produces)
    • running_example_steps (optional but recommended)

Workflow

  1. Read outline/concept_graph.yml and topologically sort concepts.
  2. Cluster concepts into modules (keep module scope coherent; avoid “misc”).
  3. For each module:
    • write measurable objectives
    • define concrete outputs (code/artifact)
    • specify how the running example advances
  4. Write outline/module_plan.yml.

Definition of Done

  • outline/module_plan.yml exists and modules are ordered by prerequisites.
  • Every module has objectives + outputs.
  • Every concept node from outline/concept_graph.yml is covered by at least one module.

Troubleshooting

Issue: modules are too many / too granular

Fix:

  • Merge adjacent modules with shared prerequisites; target ~5–12 modules for most tutorials.

Issue: objectives are not verifiable

Fix:

  • Rewrite objectives so exercise-builder can attach a concrete exercise for each module.