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. 05YAML ファイルへの出力

活用シーン

  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

詳細

概念グラフ

トリガーとルーティング

  • トリガー：concept graph、prerequisite graph、dependency graph、概念图、先修关系。
  • 使用する場合：source-tutorial の C2 で、output/TUTORIAL_SPEC.md がすでにあり、チュートリアルの概念をソート可能な DAG に変換する必要がある場合。
  • 使用しない場合：チュートリアル仕様がまだない場合。
  • ネットワーク：なし。
  • ガードレール：構造のみを作成し、読者向けの文章は書きません。グラフは必ず非巡回にします。

チュートリアル仕様の構造化された概念一覧を 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 は以下を行う必要があります。

  • 構造化された仕様データを読み込む
  • 安定したノード ID と前提条件を示すエッジを出力する
  • 結果が循環する、または空になる場合は失敗する

仕様解析のヒューリスティックを複数の場所で重複させないでください。共有のチュートリアルツールにまとめてください。

受け入れ条件

  • outline/concept_graph.yml が存在する
  • すべてのノードが安定した ID を持つ
  • グラフが DAG である

対象外

  • モジュールのクラスタリング
  • 演習の生成
  • チュートリアルの文章

コメント

Markdown 対応