Community研究&データ分析github.com

ontoterrorist/diagramas-conceptuales

哲学的なテキストや理論的な文章を読み込み、その概念構造を抽出し、編集品質の白黒TikZ図として描画します。テキストに忠実で、各概念対を結ぶ関係の種類(派生、生成、相互性、一方向性、回帰、全体化)を明確に区別します。

diagramas-conceptuales とは?

このスキルは、哲学・理論テキストの概念構造を解析し、編集品質の白黒TikZ図として視覚化するためのエージェントスキルです。テキストの要約や挿絵ではなく、「テキストが言っていることだけを」図にします。線の形状(実線・破線・点線・矢印の向きなど)にそれぞれ意味が割り当てられており、関係の種類(派生、生成、相互、一方向、回帰、全体化など)を線種で表現します。主にClaude Code環境で動作し、ユーザーが「このテキストの図」「概念間の関係をグラフ化」「TikZに変換して」と依頼した場合や、PDF・画像・哲学断片が添付された場合に自動的に起動します。カント、ドゥルーズ、ラリュエル、ベルクソン、アリストテレス、プラトン、カルナップ、スニードなど、様々な哲学者の著作を対象とします。データグラフ、アニメーション、動画、ソフトウェア図やフローチャートは対象外です。スキルは「忠実性の書(fidelidad.md)」という仕組みを中心に構築されており、図のすべてのノードとエッジをテキストの該当箇所に基づいて検証可能にすることで、解釈のぶれを防ぎます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ontoterrorist/diagramas-conceptuales/tree/HEAD

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

概念図(Diagramas conceptuales)

このスキルは、テキストを要約したり挿絵を追加したりするものではありません。テキストの概念構造を再構築し、可視化します。どのような実体があるのか、著者がそれらの間にどのような関係を主張しているのか、どのようなまとまりを一つの名前で括っているのか、そして全体を貫く大局的な方向性は何か。結果はグレースケールのTikZ図であり、線の形状が意味を担います。片矢印は両矢印ではなく、破線は点線ではなく、その違いはすべてテキストに根拠があります。

最優先の基準は忠実性です。図はテキストが言っていることだけを、過不足なく表現します。著者が非対称のままにしているものを対称に整えた「きれいな」図は、図がないよりも有害です。なぜなら、それが権威ある読みとして受け取られるからです。

各ファイルの場所

このスキルは ~/.claude/skills/diagramas-conceptuales/ に配置されます。以下のパスはすべてこのフォルダを基準とします。

内容場所
関係の語彙(どの線種がどの関係に対応するか)references/lexico.md、およびビジュアルシート assets/lexico-muestras.tex
図形のアーキタイプカタログreferences/arquetipos.md
忠実性の書、テンプレート、および例references/fidelidad.md、assets/fidelidad-plantilla.md
ハウススタイルと組版エラー対応references/estilo.md
統一TikZスタイルassets/diagrama.sty
アーキタイプ別のコンパイル可能テンプレートassets/plantillas/*.tex(base.tex は骨格)
アーキタイプ別に分類された37個の解決済み図assets/ejemplos/<arquetipo>-NN-nombre.tex
コンパイルと確認scripts/compilar.py
照合と重なりチェックscripts/revisar.py

最初のエッジを描く前に references/lexico.md を読んでください。語彙がこのスキルの核心です。図形を選ぶ際には references/arquetipos.md を読んでください。他の二つは必要に応じて参照します(忠実性の書は執筆時に、スタイルは見た目がおかしい場合に)。

フロー

以下の5つのフェーズは必須であり、この順序で実行します。その根本的な理由は、難しいのは描画ではなく何を描くべきかを決定することだからです。忠実性の書が適切に書かれていれば、描画はほぼ機械的に行えます。逆に、それが間違っていれば、どんな修正も問題を解決できません。

フェーズA — 構造的読解

  1. 描画を始める前にテキスト全体を読んでください。 テキストが長い場合は、まず図で示すべきテーゼを特定し、ユーザーにテキスト全体の図か、特定の箇所(章全体など)の図かを確認してください(章全体は通常、1つではなく3~4つの図になります)。
  2. 著者の専門用語を原語のまま特定します。 Habitus、Mnemosyne、spatium、sentiendum、Aion、dy/dxなど。図には著者の語彙をそのまま使用し、言い換えは決して行いません。翻訳版がある場合、原語は斜体でカッコ書きにします:「超自我(Thanatos)」。
  3. テキストを4つの層に分解します。
    • 実体または事例: 概念、能力、階層、時点(id: n)。
    • 関係: テキストがそれらの間に主張する関係(id: e)。
    • グループ化または全体性: 「認識の総合」、「時間の純粋で空虚な形式」(id: g)。
    • 軸または大局的な方向性: 収縮/膨張、生→死、単調性(id: x)。

フェーズB — 忠実性の書(描画前)

fidelidad.md を作成し、すべてのノードとエッジの行を記述します。assets/fidelidad-plantilla.md を使用してください。フォーマットと3つの解決済み例は references/fidelidad.md にあります。

id要素関係の種類方向それを裏付ける箇所ステータス
  • 関係の種類: 語彙(references/lexico.md)のエントリ。
  • 箇所: 短い引用とページまたはセクション番号。
  • ステータス: textual(著者が明言)、inferido(直接的に導かれるもの。その方法を説明)、または interpretativo(あなたの解釈。図上でマークされる)。

エッジを裏付ける箇所がない場合、そのエッジは描画しません。 ユーザーがテキストを提供せずに「XにおけるYの図」を依頼した場合、ユーザーが提供する箇所、または確実に引用できる箇所のみを使用して作業し、それ以外のすべて(ほぼすべてが interpretativo になります)のステータスを宣言します。「著者がよく言っていること」の記憶で補完しないでください。それを防ぐためにこそ、このスキルは存在します。

フェーズC — アーキタイプの選択

図形(references/arquetipos.md)は習慣ではなくテキストの論理に基づいて選択します。生成(genesis)はカスケード図を、類と種による分割はツリー図を、二つの秩序間の相関は並列カラム図を、現在に収縮する過去は円錐図を、切断によって分割される全体性は切り口のある半円盤図を要求します。選択理由を一行で説明し、それを忠実性の書に記録します。アーキタイプは組み合わせることができます(08番はカスケード+カラム+ループ)が、各部分はそれ単体でも判読可能でなければなりません。

フェーズD — 描画

  1. テンプレート(assets/plantillas/<arquetipo>.tex)と assets/ejemplos/ から類似した例をコピーします。それらを作業フォルダにコピーし、NN-nombre.tex にリネームします。
  2. \usepackage{diagrama} を使用してTikZで記述します。意味論的な名前のスタイルを使用します。各エッジは、その関係のスタイル(genesis、sucesion、unilateral、reciproca debil など)で描画し、汎用的な線種は使用しません。
  3. ノードには忠実性の書のidを付け(\node (n3) …)、各エッジの文の最後にそのidをコメントとして追加します(% e4)。これにより、コードとテーブルの照合が可能になります。
  4. 座標は固定グリッド(1ユニット = 1.6 cm)を使用し、サイズは \px{n} を使用します。
  5. interpretativo なものは薄いグレー(interp)で、†と脚注(\nota)を付けます。議論の余地のある inferido には *(\discutible)を付けます。

フェーズE — 検証

コンパイルして画像を確認します。コンパイルが通った図でも、ラベルが線の上に重なっている可能性があります。

python ~/.claude/skills/diagramas-conceptuales/scripts/compilar.py 38-nombre.tex
python ~/.claude/skills/diagramas-conceptuales/scripts/revisar.py 38-nombre.tex

compilar.py はPDFとPNGを .tex ファイルと同じ場所に生成し、失敗した場合は最初のエラーとその行番号を表示します。revisar.py は図と fidelidad.md を照合し(下記のポイント1と3)、重なったラベルを検出し(ポイント2)、疑わしい箇所を赤くした <nombre>-revision.png を出力します。その後、自分でPNGを確認してください。以下の5つのポイントをチェックします。

  1. 図のすべてのエッジがテーブルに存在し、その逆も true であること。
  2. どのラベルも線や他のラベルの上に重なっていないこと。
  3. テキストの非対称性がそのまま維持されていること(§ ハードルール)。
  4. テキスト内の数字が図の数字と一致していること(3つの総合、4つの層、2つの関節)。PNGでそれらを数え、推測しないこと。
  5. 一目で読めること。明確な主経路があり、副次的な関係はより細い線で描かれていること。

修正して、5つすべてをパスするまで繰り返します。3回試行しても何かが合わない場合、問題は通常フェーズBまたはC(テーブルまたはアーキタイプ)にあり、組版の問題ではありません。

語彙一覧表

完全な語彙、コーパス、断片については references/lexico.md を参照してください。概要は以下の通りです。

関係スタイル線種
派生、類→種の分割derivacion実線、塗りつぶし矢印
継起、移行sucesion実線または破線、中空矢印
生成、現実化、力genesis破線、塗りつぶし矢印
潜在的なもの:反復、偽装、置換virtual細い点線、中空矢印
著者独自の操作(クローン、抽出など)operacion一点鎖線+ラベル
相互性、相関、平行性reciproca / reciproca rayada / reciproca debil両矢印。強度は線種とともに低くなる
一方向性:決定するが決定されないunilateral片矢印、決して両矢印ではない
包含、包摂subsuncion + 動詞言語ラベル付き矢印、または埋め込み
自己言及、パラドックスparadojaレベルを飛び越える弧
フィードバックretroalim点線の弧の束
回帰、拒絶、系列間の変容retorno両矢印の点線弧
無効化、排除anulacion + 「Cancelled」点線、または \tachar
全体化totalidad / totalidad virtual / totalidad abierta実線/破線/点線の波括弧
軸または大局的な方向性eje余白の長い矢印、一点鎖線、ラベル付き
開かれた系列\dots「…」

コーパスからの補足ルール:存在論的ステータスは輪郭で示します(実線 = 現実的、破線 = 潜在的、点線 = 認識不可能:caja、caja virtual、caja abierta)。線の太さで階層を示します(主経路は太く、副次的なものは細く)。テキストが関係に名前を付けている場合、エッジにはその名前を白背景の小さな斜体で付けます(rotulo)。ノードは「用語 + (別名または機能)」とします。レベルは余白に名前を付けます(nivel)。

テキストが必要とする場合、語彙を拡張することができます。ただし、新しい線種はそれぞれ、.tex ファイル内で意味論的な名前で定義し、図の凡例で説明し、references/lexico.md に追加する必要があります。

目の前にテキストがない場合

これはよくあるケースです。ユーザーが作品名を挙げて図を依頼します。このスキルを試したエージェントは、ここで他のどこよりも頻繁に躓きました。従って:

  • 可能ならテキストを探してください(パブリックドメインのテキスト、ユーザーがどこかのフォルダに持っているPDFなど)。実際の箇所は、どんな記憶よりも価値があります。
  • assets/ejemplos/ の図はテキストそのものではありません。 それらは第三者の解釈であり、時には互いに矛盾します。語彙とアーキタイプの参考として使用し、引用箇所としては使用しないでください。
  • 引用できないものはすべてステータスを下げます。「照合せず、記憶による」紛れもない用語。それ以外は inferido または interpretativo。詳細は references/fidelidad.md にあります。
  • そのことを成果物に明記し、ユーザーが該当箇所を提供した場合に再コンパイルすることを提案してください。

忠実性に関するハードルール

それぞれに理由があります。それを理解すれば、ここにないケースにも適用できるようになります。

  • 対称化しない。 テキストがAはBを決定するが、その逆はないと述べている場合、矢印は一方向のみです。両矢印は相互依存性を主張します。「バランスが良くなるから」と両矢印を付けることは、テーゼを捏造することになります。ラリュエルの一方向性関係と究極的決定性は、そのテストケースです。
  • 補完したり丸めたりしない。 著者が3つの総合を与えているなら、3つだけです。視覚的な均衡のために4つ目を追加してはいけません。開かれた系列を残しているなら、「…」とします。
  • 語彙を統一しない。 同じ単語を異なる意味で使う二人の著者は、別々のノードで表現し、注釈で区別します。
  • 対応するものがない要素はエッジなしでそのままにします。 ある理論の構成要素が他の理論に対応するものがない場合(スニードにおけるカルナップの対応規則など)、矢印をでっち上げてはいけません。そのまま浮かせておき、解釈として描く場合は灰色で†を付けます。
  • 配置はタプルを並べ替えない。 レイアウトの都合で式の構成要素(⟨Mp, M, C, Mpp⟩)を並べ替える必要がある場合、ヘッダーは著者の順序を保持し、脚注で並べ替えを宣言します。
  • 一方向の依存関係(テキストがA→Bを与え、逆が暗黙的にしか示されていない場合)は、* を付けた片矢印で描画し、忠実性の書には逆方向は描画しないことを注記します。
  • 緊張関係を示す。 パラドックス、取消し、拒絶、テキストが除外するもの、認識不可能として示すもの(「?」、物自体)は描画します。邪魔だからといって省略してはいけません。
  • 解釈的なものは視認できるようにする。 薄い灰色+†+脚注。議論の余地のある推論には*を付けます。
  • ラベルは引用であり、説明ではない。 ラベルは著者の言葉そのものです。説明は成果物のパラグラフに含めます。
  • 凡例 図が3種類以上の線種を使用する場合に付けます(コーパスからの線種は、各エッジに名前が付いているため、通常は凡例を必要としません)。

ユーザーに質問するタイミング

描画を始める前に、図の内容を変えるものについてのみ質問します。

  • 範囲: テキスト全体か、特定の箇所か? 長い章は通常、複数の図になります。
  • テキスト自体(提供されていない場合):「テキストをいただけますか? それとも、私が引用できるもので進めて、残りは解釈的としてマークしますか?」
  • どのテーゼを示すか(テキストが複数のテーゼを主張しており、図には一つしか収まらない場合)。
  • ラベルの言語: デフォルトルール(質問を避けるため):専門用語はユーザーが指定したテキストの言語で記述します(カントならドイツ語、プラトンならギリシャ語の音訳、ドゥルーズやラリュエルならフランス語、またはユーザーが翻訳版を使用している場合はその翻訳の言語)。その他のラベルと注釈は、ユーザーが執筆している言語で記述します。この選択を成果物で宣言してください。図が別の言語の出版物に使用される場合は、質問します。

スタイル、アーキタイプ、線種については質問しません。それらは語彙に基づいてあなたが決定し、その理由を説明します。

成果物

NN-nombre.tex + PDF + PNG + fidelidad.md を含む作業フォルダ、および以下の内容を記述したパラグラフ:

  1. 図が示すもの(テーゼ)。
  2. なぜそのアーキタイプなのか(一行)。
  3. どのような解釈的判断が行われたか(†行)。
  4. テキストのどの部分が図から除外され、その理由は何か。

作業が ~/.claude/diagramas-tikz/ 内で行われる場合、番号を継続し(次に利用可能な番号、最後は37)、ユーザーが要求した場合にのみ、新しい図を todos.tex に追加します。

アンチパターン

  • 矢印の付いたリスト: すべてのエッジが同じ場合、分析が不足しています。
  • 異なる種類の関係に対する汎用的な「→」矢印。
  • すべてに四角枠を使用する: 四角枠は、その形状が何かを意味する場合にのみ使用します。
  • 専門用語の言い換え: (Mnemosyne ではなく「純粋記憶」など)。
  • 図の中での描画者によるコメント: 成果物のパラグラフに含めるか、解釈的判断の場合は†脚注に含めます。
  • テキストにない対称性で空間を埋める: 空白のある図は、誠実な図です。
  • 該当箇所ではなく「教義」の記憶から描画する: ほとんどすべての不正確さの原因です。

関連スキル