Community研究与数据分析github.com

ontoterrorist/diagramas-conceptuales

读取哲学或理论文本,提取其概念结构,并以出版级质量的黑白TikZ图表绘制出来,忠实于原文,并区分每对概念之间的关系类型(派生、发生、互惠、单向、回归、总体化)。

diagramas-conceptuales 是什么?

该技能专门用于从哲学或理论文本中自动生成高度忠实的概念结构图(TikZ格式)。它不满足于简单的摘要或插图,而是精确重构文本中的实体、关系、分组和整体导向,并以线型编码关系语义(实线、虚线、双箭头等均有明确含义)。技能的核心是“忠实性”:每个节点和每条边都必须有原文段落支撑,并记录在`fidelidad.md`忠实性表中,严格区分“原文明确”、“合理推断”和“解释性”三类状态。它不支持数据图表、动画或非哲学文本(如软件流程图)。该技能通常作为Claude Code的扩展使用,通过读取放在`~/.claude/skills/diagramas-conceptuales/`目录下的引用文件、模板和37个示例,指导AI通过五个强制阶段(结构阅读→写忠实性表→选原型→绘制TikZ→验证)完成工作。它强制要求用户交互仅限于确认范围、提供原文文本、指定展示哪条论题,而禁止在风格、原型或线型上询问用户——这些都是AI根据词库和文理自主决定的。

兼容平台✓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 的新对话。

文档

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 — 结构阅读

  1. 在绘制任何东西之前完整阅读文本。 如果文本较长,首先定位图表应展示的论题或各条论题,并询问用户是需要整篇文本的图表,还是某一节段的图表(一个完整的章节通常对应三到四个图表,而非一个)。
  2. 以原始形式识别作者的技术术语:Habitus、Mnemosyne、spatium、sentiendum、Aion、dy/dx。图表中出现的是作者的词汇,而不是转述。如果有翻译,原文以斜体形式放在括号中:"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(你自己的解读;将在图中标注)。

如果没有段落支撑一条边,则该边不被绘制。 如果用户没有提供文本,而是要求“绘制 Y 中的 X 的图表”,则使用用户提供的或你能够可靠引用的段落,并声明所有其他内容的状态(大部分将是 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. “解释性”内容以浅灰色 (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。检查以下五点:

  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。

反模式

  • 用箭头连起来的列表。 如果所有边都相同,说明缺乏分析。
  • 通用的“→”箭头用于不同类型的关系。
  • 所有的东西都装箱。 只有在形状有意义时才使用框。
  • 转述技术术语(用“纯粹记忆”代替 Mnemosyne)。
  • 图表绘制者在图中加入注释。 应放在交付正文中,如果是解释性决策,则放在 † 脚注中。
  • 用文本中没有的对称性填充空间。 有空白的图表是诚实的图表。
  • 根据“该学说”的记忆而非段落来绘制:这是几乎所有不忠实情况的根源。

相关技能