mcpField
C
concept-graph

concept-graph

github.com/willoscar生产力51744 次安装3 周前更新
代码仓库

关于 concept-graph

concept-graph 将结构化教程规范转换为概念及其先修关系的有向无环图，供需要稳定、可排序概念大纲的教程工作流使用。它专注于结构，不生成面向读者的正文。

主要功能

  1. 01根据教程规范生成概念图
  2. 02表示概念先修关系
  3. 03生成稳定的节点 ID
  4. 04检查图是否存在环
  5. 05输出 YAML 文件

适用场景

  1. 01按先修关系排列教程概念
  2. 02根据教程规范准备概念大纲
  3. 03模块规划前验证教程图结构

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill concept-graph

安装后在 Claude Code 中输入/concept-graph确认已加载。

附带文件scripts/run.py

详细介绍

概念图

触发条件与路由

  • 触发条件：概念图、先修关系图、依赖关系图、概念图、先修关系。
  • 适用情形：source-tutorial 的 C2，已有 output/TUTORIAL_SPEC.md，需要将教程概念转换为可排序的 DAG。
  • 跳过条件：尚无 tutorial spec。
  • 网络：无。
  • 防护措施：只处理结构，不撰写面向读者的正文；图必须保持无环。

将教程 spec 中的结构化概念清单具体化为 outline/concept_graph.yml。

输入

  • output/TUTORIAL_SPEC.md

输出

  • outline/concept_graph.yml

约定

图必须包含：

  • nodes：{id, title, summary, source_ids, objective_refs}
  • edges：{from, to}，表示先修顺序

脚本边界

scripts/run.py 应：

  • 加载结构化 spec 数据
  • 生成稳定的节点 ID 和先修关系边
  • 若结果存在环或为空，则失败

不要在多个位置重复 spec 解析启发式规则；应将其放在共享的教程工具中。

验收标准

  • outline/concept_graph.yml 存在
  • 所有节点都有稳定的 ID
  • 图是 DAG

非目标

  • 模块聚类
  • 练习生成
  • 教程正文

评论

支持 Markdown