Community研究與資料分析github.com

ontoterrorist/diagramas-conceptuales

讀取哲學或理論文本,萃取其概念結構,並繪製成出版級的黑白 TikZ 圖表。忠於原文,區分每對概念之間的關係類型(推導、生成、相互、單向、回返、總體化)。

diagramas-conceptuales 是什麼?

這個技能專門用於從哲學或理論文本中萃取概念架構,並將其視覺化為高品質的 TikZ 圖表。它不僅是繪圖,更是對文本思想的忠實重建:每一個節點和邊都必須有文本段落作為依據。技能支援的平台包括 Claude Code 等 CLI 代理,工作流程分為五個強制階段:結構閱讀、撰寫忠實度表、選擇圖表原型、繪製 TikZ 圖表、以及驗證。其核心哲學是「形狀即意義」——每種線條樣式(實線、虛線、點線、雙箭頭等)都對應特定的邏輯關係(推導、生成、相互、單向等),並且嚴格禁止對文本進行對稱化或美化,以確保圖表忠於原文的不對稱性。圖表以黑白灰度呈現,所有詮釋性元素(推斷、解讀)必須以灰色、† 標記和腳註明確標示。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

概念圖表

此技能不是摘要或說明文本。它重建文本的概念架構並使其可見:有哪些實體、作者斷言它們之間有什麼關係、哪些被歸類在同一個名稱下、以及有哪些整體取向貫穿全體。結果是一個灰階 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。另外兩個文件則在需要時閱讀(撰寫忠實度表時閱讀忠實度手冊;圖表顯示異常時閱讀風格指南)。

工作流程

五個階段是強制性的,且必須按此順序進行。根本原因在於,困難的部分不是繪圖,而是決定要畫什麼:如果忠實度表寫得好,繪圖幾乎是機械性的;如果忠實度表有誤,任何打磨都無法修正。

階段 A — 結構閱讀

  1. 在繪圖之前,完整閱讀文本。 如果文本很長,首先找出圖表應展示的論點,並詢問使用者是否想要整個文本的圖表,還是某個段落(一個完整的章節通常需要三到四個圖表,而非一個)。
  2. 辨識作者使用的技術詞彙,並保留其原文形式:Habitus、Mnemosyne、spatium、sentiendum、Aion、dy/dx。圖表中應使用作者的原詞,而非任何 paraphrase。若有翻譯,原文以斜體放在括號內:「Superego (Thanatos)」。
  3. 將文本分為四個層次:
    • 實體或實例: 概念、能力、層級、時刻(id 使用 n)。
    • 關係: 文本所斷言的實體之間的關係(id 使用 e)。
    • 分組或總體: 「綜合的綜合」、「時間的空純形式」(id 使用 g)。
    • 軸線或整體取向: 收縮/擴張、生命→死亡、單調性(id 使用 x)。

階段 B — 忠實度表(繪圖前)

編寫 fidelidad.md,每個節點和每條邊各佔一行。使用 assets/fidelidad-plantilla.md;格式及三個已解決範例位於 references/fidelidad.md。

id元素關係類型方向支持該元素的文本段落狀態
  • 關係類型: 詞彙表(references/lexico.md)中的一個條目。
  • 段落: 簡短引用及頁碼或章節。
  • 狀態: textual(作者明確說出)、inferido(直接推導得出;需說明推導方式)或 interpretativo(你自己的解讀;將在圖表中標示)。

如果沒有段落支持某一條邊,則該邊不繪製。 如果使用者未提供文本,而是要求「X 在 Y 中的圖表」,則使用使用者提供的段落或你確信可以引用的段落,並宣告所有其他項目的狀態(幾乎所有項目都會是 interpretativo)。請勿使用你對「作者通常會說什麼」的記憶來補全:這正是這本書存在所要避免的情況。

階段 C — 選擇原型

根據文本的邏輯,而非習慣來選擇圖表形狀(references/arquetipos.md):生成關係需要瀑布圖;按類和種進行劃分需要樹狀圖;兩個秩序之間的相關性需要平行列;收縮到當下的過去需要圓錐圖;被切割的總體需要帶有中斷的半圓盤圖。用一句話說明你的選擇理由,並記錄在忠實度表中。可以組合原型(例如 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 公分),尺寸使用 \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 會在 .tex 檔案旁生成 PDF + PNG,如果編譯失敗,則顯示第一個錯誤及其行號。revisar.py 會將圖表與 fidelidad.md 進行比對(下方第 1 和第 3 點),檢測重疊的標籤(第 2 點),並生成 <nombre>-revision.png,將可疑部分標為紅色。之後請親自查看 PNG。檢查以下五個重點:

  1. 圖表中的每一條邊都存在於表格中,反之亦然。
  2. 沒有任何標籤遮蓋線條或其他標籤。
  3. 文本中的不對稱性仍然是圖表中的不對稱性(§ 硬規則)。
  4. 文本中的數字與圖表中的數字一致(三個綜合,四個層次,兩個關節):在 PNG 中數它們,不要假設。
  5. 一目了然:有一條清晰的主要路徑,次要關係的線條較輕。

修正並重複,直到通過這五點。如果三輪之後仍有問題,通常是階段 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 而非相反,箭頭只應指向一個方向。雙箭頭聲稱相互依賴;因為「這樣看起來更平衡」而加上雙箭頭,就是憑空製造論點。拉呂埃勒的單向關係和最終決定是測試案例。
  • 不要補全或修整。 如果作者給出三個綜合,就畫三個;不要為了視覺平衡而添加第四個。如果作者留下開放序列,就畫「…」。
  • 不要統一律彙。 兩個作者使用同一個詞彙但意義不同,應使用不同的節點,並透過註釋區分。
  • 沒有對應項的元素保持孤立。 如果一個理論的某個組成部分在另一個理論中沒有對應項(例如卡爾納普在斯尼德中的對應規則),不要為它創造一個箭頭:讓它保持孤立;如果你出於解讀而畫了一條邊,則使用灰色和 † 標記。
  • 佈局不得重新排序元組。 如果排版迫使我重新排序一個公式的組成部分(⟨Mp, M, C, Mpp⟩),則標題應保留作者原始的順序,並在腳註中說明重新排序。
  • 單向依賴(文本給出 A→B,逆關係僅為隱含)應以一個帶 * 標記的單箭頭繪製,並在忠實度表中註明逆關係未繪製。
  • 展示張力。 悖論、取消、拒絕、文本所排除的內容以及標記為不可知的內容(「?」、物自體),都應繪製;不要因為它們妨礙而省略。
  • 解讀性內容應可見。 淺灰色 + † + 腳註。可爭議的推斷內容帶有 * 標記。
  • 標籤引用,而非解釋。 標籤應使用作者的原詞;解釋則放在交付段落中。
  • 圖例: 如果圖表使用超過三種線條類型(語料庫中的圖表通常不需要圖例,因為每條邊都帶有名稱)。

何時詢問使用者

在繪圖之前,僅詢問那些會改變圖表的事情:

  • 範圍: 整個文本還是某個段落?一個長章節通常需要多個圖表。
  • 文本本身,如果你沒有收到:「你能把文本給我嗎?或者我用我能引用的內容來工作,並將其餘部分標記為解讀性?」。
  • 要展示哪個論點,如果文本支持多個論點,而圖表只能容納一個。
  • 標籤的語言。 預設規則(無需詢問):技術詞彙使用使用者所指文本的語言(康德使用德語,柏拉圖使用希臘語轉寫,德勒茲或拉呂埃勒使用法語,或者如果使用者在翻譯本上工作,則使用翻譯本的語言),其餘標籤和註釋使用使用者寫作的語言。在交付時聲明你的選擇;如果圖表將以另一種語言發表,請詢問。

不要詢問風格、原型或線條:這些由你根據詞彙決定並說明理由。

交付

工作資料夾包含 NN-nombre.tex + PDF + PNG + fidelidad.md,並加上一個段落說明:

  1. 圖表展示了什麼(論點);
  2. 為什麼選擇該原型(一句話);
  3. 做了哪些解讀性決定(† 標記的行);
  4. 文本的哪些內容未被納入及其原因。

如果作品位於 ~/.claude/diagramas-tikz/ 內,則繼續編號(下一個可用編號;最後一個是 37),並僅在使用者要求時將新圖表添加到 todos.tex。

反模式

  • 帶箭頭的列表。 如果所有邊都相同,則缺乏分析。
  • 為不同類型的關係使用通用「→」箭頭。
  • 什麼都用方框。 方框僅在其形狀具有意義時才出現。
  • 對技術詞彙進行 paraphrase(例如用「純粹記憶」代替 Mnemosyne)。
  • 圖表繪製者在圖表內進行評論。 應放在交付段落中,或者如果是一個解讀性決定,則放在 † 腳註中。
  • 用文本中沒有的對稱性填補空白。 帶有空白區域的圖表是誠實的圖表。
  • 根據對「學說」的記憶而非文本段落來繪圖: 這是幾乎所有不忠實行為的原因。

相關技能