概念圖表
此技能不是摘要或說明文本。它重建文本的概念架構並使其可見:有哪些實體、作者斷言它們之間有什麼關係、哪些被歸類在同一個名稱下、以及有哪些整體取向貫穿全體。結果是一個灰階 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 — 結構閱讀
- 在繪圖之前,完整閱讀文本。 如果文本很長,首先找出圖表應展示的論點,並詢問使用者是否想要整個文本的圖表,還是某個段落(一個完整的章節通常需要三到四個圖表,而非一個)。
- 辨識作者使用的技術詞彙,並保留其原文形式:Habitus、Mnemosyne、spatium、sentiendum、Aion、dy/dx。圖表中應使用作者的原詞,而非任何 paraphrase。若有翻譯,原文以斜體放在括號內:「Superego (Thanatos)」。
- 將文本分為四個層次:
- 實體或實例: 概念、能力、層級、時刻(id 使用
n)。 - 關係: 文本所斷言的實體之間的關係(id 使用
e)。 - 分組或總體: 「綜合的綜合」、「時間的空純形式」(id 使用
g)。 - 軸線或整體取向: 收縮/擴張、生命→死亡、單調性(id 使用
x)。
- 實體或實例: 概念、能力、層級、時刻(id 使用
階段 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 — 繪圖
- 從範本(
assets/plantillas/<arquetipo>.tex)和assets/ejemplos/中類似的範例開始。將它們複製到工作資料夾,並重新命名為NN-nombre.tex。 - 使用
\usepackage{diagrama}編寫 TikZ。語義命名風格:每條邊都應使用其關係的風格(genesis、sucesion、unilateral、reciproca debil……)來繪製,而非使用通用外觀。 - 使用忠實度表中的 id 來命名節點(
\node (n3) …),並在語句末尾標註每條邊的 id(% e4),以便程式碼與表格可以相互比對。 - 使用固定網格座標(1 單位 = 1.6 公分),尺寸使用
\px{n}。 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。檢查以下五個重點:
- 圖表中的每一條邊都存在於表格中,反之亦然。
- 沒有任何標籤遮蓋線條或其他標籤。
- 文本中的不對稱性仍然是圖表中的不對稱性(§ 硬規則)。
- 文本中的數字與圖表中的數字一致(三個綜合,四個層次,兩個關節):在 PNG 中數它們,不要假設。
- 一目了然:有一條清晰的主要路徑,次要關係的線條較輕。
修正並重複,直到通過這五點。如果三輪之後仍有問題,通常是階段 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,並加上一個段落說明:
- 圖表展示了什麼(論點);
- 為什麼選擇該原型(一句話);
- 做了哪些解讀性決定(† 標記的行);
- 文本的哪些內容未被納入及其原因。
如果作品位於 ~/.claude/diagramas-tikz/ 內,則繼續編號(下一個可用編號;最後一個是 37),並僅在使用者要求時將新圖表添加到 todos.tex。
反模式
- 帶箭頭的列表。 如果所有邊都相同,則缺乏分析。
- 為不同類型的關係使用通用「→」箭頭。
- 什麼都用方框。 方框僅在其形狀具有意義時才出現。
- 對技術詞彙進行 paraphrase(例如用「純粹記憶」代替 Mnemosyne)。
- 圖表繪製者在圖表內進行評論。 應放在交付段落中,或者如果是一個解讀性決定,則放在 † 腳註中。
- 用文本中沒有的對稱性填補空白。 帶有空白區域的圖表是誠實的圖表。
- 根據對「學說」的記憶而非文本段落來繪圖: 這是幾乎所有不忠實行為的原因。