concept-graph
从教程规范构建概念图(节点+先决条件边),另存为 `outline/concept_graph.yml`。**触发**:概念图、先决条件图、依赖图、概念图、先修关系。**使用时**:教程管道的结构阶段(C2),需要把教程知识点拆成可排序的依赖图(在写教程散文前)。**如果**则跳过:还没有教程规范(例如缺少`output/TUTORIAL_SPEC.md`)。**网络**:无。**护栏**:只做结构;避免写长散文段落。
📖 中文导读:从教程规范构建概念图(节点+先决条件边),另存为 `outline/concept_graph.yml`。**触发**:概念图、先决条件图、依赖图、概念图、先修关系。**使用时**:教程管道的结构阶段(C2),需要把教程知识点拆成可排序的依赖图(在写教程散文前)。**如果**则跳过:还没有教程规范(例如缺少`output/TUTORIAL_SPEC.md`)。**网络**:无。**护栏**:只做结构;避免写长散文段落。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: concept-graph
description: |
Build a concept graph (nodes + prerequisite edges) from a tutorial spec, saving as outline/concept_graph.yml.
Trigger: concept graph, prerequisite graph, dependency graph, 概念图, 先修关系.
Use when: tutorial pipeline 的结构阶段(C2),需要把教程知识点拆成可排序的依赖图(在写教程 prose 前)。
Skip if: 还没有 tutorial spec(例如缺少 output/TUTORIAL_SPEC.md)。
Network: none.
Guardrail: 只做结构;避免写长 prose 段落。
Concept Graph (prerequisites)
Goal: represent tutorial concepts as a prerequisite DAG so modules can be planned and ordered.
Inputs
output/TUTORIAL_SPEC.md
Outputs
outline/concept_graph.yml
Output schema (recommended)
A minimal, readable YAML schema:
nodes: list of{id, title, summary}edges: list of{from, to}meaningfromis a prerequisite ofto
Constraints:
- Graph should be acyclic (DAG).
- Prefer 10–30 nodes for a medium tutorial.
Workflow
- Read
output/TUTORIAL_SPEC.mdand extract the concept list implied by objectives + running example. - Normalize each concept into a node with a stable
id. - Add prerequisite edges and verify the graph is acyclic.
- Write
outline/concept_graph.yml.
Definition of Done
-
outline/concept_graph.ymlexists and is a DAG. - Nodes cover all learning objectives from
output/TUTORIAL_SPEC.md. - Node titles are specific (not “misc”).
Troubleshooting
Issue: the graph looks like a linear list
Fix:
- Add intermediate prerequisites explicitly (e.g., “data model” before “evaluation protocol”).
Issue: cycles appear (A → B → A)
Fix:
- Split concepts or redefine edges so prerequisites flow in one direction.