MindGraph 🕷️🧠

面向 OpenClaw 的知识图谱 + 可学习流程引擎。包含两大核心功能：

1. 知识图谱 —— 支持跨工作区所有文件的 Obsidian 风格 [[wikilinks]]
2. MindSkills —— 可复用、可学习的流程，其执行结果以图谱连接方式持久化保存

始终生效的规则

每次编写或编辑 Markdown 文件时，必须使用 [[wikilinks]] 标记以下内容：

• 人物：[[Alice]]、[[Bob]]
• 项目：[[my-saas]]、[[landing-page]]
• 公司/工具：[[Stripe]]、[[Vercel]]、[[GitHub]]
• 概念/框架：[[Knockout Test]]、[[B2B SaaS]]
• 其他智能体/模型：[[Claude Code]]、[[Sonnet]]

此要求不可豁免。链接是知识建立关联的唯一方式；无链接 = 孤立笔记 = 无效信息。

切勿在发给用户的对话消息中（如 Telegram、Discord 等）使用 [[wikilinks]]。Wikilinks 仅限工作区文件内使用。在聊天场景中，请直接书写名称，例如写 “Alice”，而非 “[[Alice]]”。

在对文件进行重大修改后，需重建索引：

python3 skills/mindgraph/scripts/mindgraph.py index

图谱命令

# 构建或重建索引
python3 skills/mindgraph/scripts/mindgraph.py index

# 查询某一主题（反向链接 + 上下文 + 关联节点）
python3 skills/mindgraph/scripts/mindgraph.py query ""

# 仅查询反向链接（哪些文件引用了该节点？）
python3 skills/mindgraph/scripts/mindgraph.py backlinks ""

# 查询正向链接（该节点链接到了哪些内容？）
python3 skills/mindgraph/scripts/mindgraph.py links ""

# 查询双向关联（既含引用者，也含被引用者）
python3 skills/mindgraph/scripts/mindgraph.py connections ""

# ASCII 树状结构可视化
python3 skills/mindgraph/scripts/mindgraph.py tree "" [depth]

# 查找孤立节点、失效链接、未连接文件
python3 skills/mindgraph/scripts/mindgraph.py orphans
python3 skills/mindgraph/scripts/mindgraph.py deadlinks
python3 skills/mindgraph/scripts/mindgraph.py lonely

# 查看完整统计信息
python3 skills/mindgraph/scripts/mindgraph.py stats

MindSkills —— 可学习的流程

MindSkills 是存放在 skills/mindgraph/mindskills/ 目录下的可复用流程框架。每个 MindSkill 均定义了明确的执行步骤，并将结果以图谱连接方式保存为 Markdown 文件。

使用 MindSkill

# 列出所有已习得的 MindSkills
python3 skills/mindgraph/scripts/mindgraph.py skills

# 查看某 MindSkill 的执行流程定义
python3 skills/mindgraph/scripts/mindgraph.py skill 

# 列出某 MindSkill 的所有执行结果
python3 skills/mindgraph/scripts/mindgraph.py results 

当用户请求运行某一流程（例如：“对 X 执行 Knockout Test”）时，请按以下流程操作：

1. 阅读对应 MindSkill 目录下的 PROCESS.md，确认流程定义
2. 以自然对话形式逐步执行该流程
3. 将结果保存至 skills/mindgraph/mindskills//results/.md
4. 在结果文件中全程使用 [[wikilinks]]
5. 在文件开头添加 YAML frontmatter，包含必要元数据
6. 执行索引重建

结果文件模板如下：

---
mindskill: 
subject: <被测试/分析的对象>
date: 
verdict: <结论/判定结果>
aliases: [<别名列表>]
---
# [[]]: [[]]

<依据 PROCESS.md 中定义的流程生成的结果内容>

## Connections
- Related: [[link1]], [[link2]]

学习新的 MindSkill

当用户提出“学习一个名为 X 的 MindSkill”，或描述一个可重复执行的流程时：

# 创建一个新的 MindSkill
python3 skills/mindgraph/scripts/mindgraph.py learn ""

该命令将自动创建标准目录结构。随后，请根据用户描述撰写 PROCESS.md。

一份优质的 PROCESS.md 应包含以下要素：

• 目的（Purpose）：说明该流程的作用及其适用场景
• 触发短语（Trigger phrases）：用户可能使用的、用于调用该流程的表达方式
• 步骤（Steps）：具体、编号的执行流程
• 输出格式（Output format）：结果文件应包含的内容结构
• 结论/评分机制（Verdict/scoring）：如何归纳最终结果（如适用）

MindSkills 的主动发现

当用户请求与某个已习得的 MindSkill 匹配时，请主动建议启用：

• “需要我为您对这个对象执行 [[Knockout Test]] 吗？”
• “我有一个 [[SEO Validator]] MindSkill，是否需要对它进行审计？”
• “这看起来是一次 [[Competitor Analysis]]，需要我提供完整框架吗？”

链接解析规则

链接匹配不区分大小写，依次尝试匹配以下目标：

1. 文件基础名：[[MEMORY]] → MEMORY.md
2. 项目目录：[[my-saas]] → projects/my-saas/
3. MindSkill 执行结果：[[Pet Tracker KT]] → 对应的 Knockout Test 结果文件
4. YAML 别名：aliases: [AV-Check] → [[AV-Check]] 可成功解析
5. 未命中项：仍作为概念节点保留（支持反向链接追踪）

关键文件位置

• 图谱索引文件：mindgraph.json（位于工作区根目录）
• MindSkills 存放路径：skills/mindgraph/mindskills/
• 主执行脚本：skills/mindgraph/scripts/mindgraph.py