SuperAPI AI 工具集

concept-graph

写作与研究

查看项目

更新于 10-16 05:40

技能介绍

Concept Graph 是一个位于 willoscar/research-units-pipeline-skills 中的技能,用于在教程相关流水线中构建概念的先修关系图。

用途 该技能适用于 source-tutorial 的 C2 阶段:当已有 output/TUTORIAL_SPEC.md(经批准的教程规格)时,需要将教程中的概念转换为可排序的 DAG(有向无环图),以便在进入模块规划之前获得确定性的先修关系。

主要能力

  • 将教程规格中的结构化概念清单物化为 outline/concept_graph.yml。
  • 生成包含节点与边的图结构。节点字段为 {id, title, summary, source_ids, objective_refs};边为 {from, to},表示先修顺序。
  • 通过脚本加载结构化规格数据,输出稳定的节点 ID 与先修边。
  • 当结果会形成环或为空时,脚本应报错失败。

使用方式

  • 触发关键词包括:concept graph、prerequisite graph、dependency graph、概念图、先修关系。
  • 输入:output/TUTORIAL_SPEC.md。
  • 输出:outline/concept_graph.yml。
  • 网络:无(network: none)。
  • 边界:脚本 scripts/run.py 应加载结构化规格数据、输出稳定节点 ID 与先修边,并在结果有环或为空时失败;不应在多个位置重复实现规格解析逻辑,而应将其保留在共享的教程工具中。

适用场景

  • 已存在经批准的教程规格(output/TUTORIAL_SPEC.md),需要在模块规划前建立确定性的先修依赖图。
  • 需要把教程概念组织成可排序的 DAG。

限制与约束

  • 若还没有 tutorial spec,则跳过。
  • 执行护栏:只做结构,不撰写面向读者的 prose;图必须保持无环。
  • 非目标(non-goals):模块聚类、练习生成、教程正文。
  • 验收标准:outline/concept_graph.yml 存在;所有节点具有稳定 ID;图为 DAG。

以上信息均来自所提供资料,未提供的定价、平台支持或效果等内容暂未提供。