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。其他两个文件在需要时阅读(编写忠实性手册时读忠实性,当图像显示异常时读样式)。
流程
五个阶段是强制性的,必须按此顺序进行。其根本原因在于,困难的部分不是绘图,而是决定必须绘制什么:如果忠实性手册写得好,绘图几乎是机械操作;如果写得不好,任何打磨都无法弥补。
阶段 A — 结构阅读
- 在绘制任何东西之前完整阅读文本。 如果文本较长,首先定位图表应展示的论题或各条论题,并询问用户是需要整篇文本的图表,还是某一节段的图表(一个完整的章节通常对应三到四个图表,而非一个)。
- 以原始形式识别作者的技术术语:Habitus、Mnemosyne、spatium、sentiendum、Aion、dy/dx。图表中出现的是作者的词汇,而不是转述。如果有翻译,原文以斜体形式放在括号中:"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(你自己的解读;将在图中标注)。
如果没有段落支撑一条边,则该边不被绘制。 如果用户没有提供文本,而是要求“绘制 Y 中的 X 的图表”,则使用用户提供的或你能够可靠引用的段落,并声明所有其他内容的状态(大部分将是 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}。 - “解释性”内容以浅灰色 (
interp) 绘制,并带 † 和脚注 (\nota);“有问题的推断”带 * (\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。
反模式
- 用箭头连起来的列表。 如果所有边都相同,说明缺乏分析。
- 通用的“→”箭头用于不同类型的关系。
- 所有的东西都装箱。 只有在形状有意义时才使用框。
- 转述技术术语(用“纯粹记忆”代替 Mnemosyne)。
- 图表绘制者在图中加入注释。 应放在交付正文中,如果是解释性决策,则放在 † 脚注中。
- 用文本中没有的对称性填充空间。 有空白的图表是诚实的图表。
- 根据“该学说”的记忆而非段落来绘制:这是几乎所有不忠实情况的根源。