SuperAPI AI 工具集

module-planner

写作与研究

查看项目

更新于 10-16 04:45

技能介绍

用途

Module Planner 用于教程制作流程中的模块规划环节。当教程的概念 DAG 已经存在(即已有 outline/concept_graph.yml),需要把概念图收敛成有序的模块顺序时使用。它把概念图转换为后续教程阶段所使用的可教学模块序列。

触发词包括:module plan、tutorial modules、course outline、模块规划、module_plan.yml。

如果还没有 concept graph,则应跳过此技能。

主要能力

  • 对概念进行拓扑排序(topological order)。
  • 将概念聚类为连贯的模块。
  • 为每个模块附加可衡量的目标(objectives)和具体产出(outputs)。
  • 生成模块计划文件 outline/module_plan.yml。

输入与输出

  • 输入:outline/concept_graph.yml
  • 输出:outline/module_plan.yml

契约(Contract)

模块计划必须定义:

  • 有序模块(ordered modules)
  • id、title
  • objectives
  • concepts
  • outputs
  • running_example_steps

脚本边界

scripts/run.py 应当:

  • 对概念进行拓扑排序
  • 将它们聚类为连贯的模块
  • 附加可衡量的目标和具体产出

图遍历与聚类启发式逻辑应保留在共享的教程工具中,而不是放在包装脚本里。

验收标准(Acceptance)

  • outline/module_plan.yml 存在
  • 每个概念节点至少被一个模块覆盖
  • 每个模块都有 objectives 和 outputs

使用方式与限制

  • 网络:无(Network: none)。
  • 护栏(Guardrail):每个模块都要有 objectives、outputs、running-example step;不要写长 prose。
  • 非目标(Non-goals):源材料核查(source grounding audit)、练习编写(exercise writing)、教程草稿撰写(tutorial drafting)。

适用场景

适用于已有概念图、需要生成有序教学模块计划的教程制作流程,尤其是需要为后续教程阶段提供模块序列的场景。

限制

该技能不负责源材料核查、练习编写和教程草稿撰写;在没有 concept graph 的情况下不应使用。关于收费、价格、平台支持等具体信息,资料中暂未提供。