AgentSkillsCN

module-planner

从概念图出发规划教程模块，明确各模块的目标与先后顺序，并将其保存为 `outline/module_plan.yml`。 **触发条件**：模块计划、教程模块、课程大纲、模块规划、module_plan.yml。 **适用场景**：在教程流程的结构化阶段（C2），已有 `outline/concept_graph.yml`，需将概念间的依赖关系转化为可教学的模块序列。 **若跳过**：如果尚未构建概念图（请先运行 `concept-graph`）。 **网络环境**：无需联网。 **行为准则**：每个模块都应明确目标与产出（最好包含实际操作示例步骤）；避免使用冗长的叙述性段落。

SKILL.md
--- frontmatter
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

Output schema (recommended)

  • •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.