synapse-wiki

name	synapse-wiki
description	Synapse Wiki — 智能知识库管理系统。 自动摄取原始资料，增量构建持久化知识网络，支持智能查询和健康检查。 知识随时间复利积累，越用越聪明。 当用户提到 wiki、知识库、摄取资料、查询知识、整理文档时使用此技能。
version	1.1.0
date	2026-04-08T00:00:00.000Z
user-invocable	true
metadata	{"openclaw":{"emoji":"🧠","requires":{"bins":"[Truncated]"},"install":[],"homepage":"https://github.com/openclaw/skills"}}
tags	["knowledge-base","wiki","documentation","learning","obsidian"]

Synapse Wiki Skill

Synapse Wiki = 持久化知识网络 + 增量积累 + 自动健康维护

核心理念：知识应该随时间复利增长，而非每次从零开始。

	传统笔记	Synapse Wiki
机制	手动整理 + 检索	自动编译原始资料成知识网络
知识形式	孤立文档	结构化、交叉链接的知识页面
随时间变化	越积越多，难以查找	越用越聪明，自动关联
维护者	人类	AI（编译、交叉引用、归档）

---

🚦 快速决策：我该用什么命令？

你想做什么？
│
├─ 开始一个新知识库         → ingest（初始化）
│   └─ 例："我想建一个 AI 学习知识库"
│
├─ 保存新资料/文章          → ingest（摄取）
│   └─ 例："这篇好文要存起来"、"剪辑网页保存"
│
├─ 查询已有知识             → query（查询）
│   └─ 例："RAG 是什么？"、"上次那个概念怎么解释"
│
└─ 检查知识库健康度         → lint（检查）
    └─ 例："有没有死链接？"、"检查孤立页面"

常用场景:

• 第一次用 → /synapse-wiki init ~/my-wiki "AI 知识库"
• 看到好文章 → /synapse-wiki ingest ~/my-wiki raw/articles/xxx.md
• 有疑问 → /synapse-wiki query ~/my-wiki "你的问题"

---

📋 命令速查卡片

命令	用途	示例
/synapse-wiki init	初始化知识库	/synapse-wiki init ~/my-wiki "AI 知识库"
/synapse-wiki ingest	摄取新资料	/synapse-wiki ingest ~/my-wiki raw/articles/article.md
/synapse-wiki query	查询知识	/synapse-wiki query ~/my-wiki "RAG 是什么"
/synapse-wiki lint	健康检查	/synapse-wiki lint ~/my-wiki

使用提示:

• 首次使用先用 init 创建目录结构
• 每次保存资料后用 ingest 编译为知识
• 定期运行 lint 检查健康度

---

三层架构

<wiki-root>/
├── CLAUDE.md              ← Schema 定义（范围/规范/工作流）
├── log.md                 ← 只增不减的时间线日志
│
├── raw/                   ← 原始资料层（LLM 只读，永不修改）
│   ├── articles/          ← 网页文章（Obsidian Clipper 保存）
│   ├── papers/            ← 学术论文
│   └── notes/             ← 个人笔记
│
└── wiki/                  ← Wiki 知识层（LLM 编写，用户阅读）
    ├── index.md           ← 主目录：所有页面 + 一句话摘要
    ├── concepts/          ← 概念/主题页面
    ├── entities/          ← 人物、工具、论文、组织
    └── summaries/         ← 每个来源的摘要页面

命令

摄取命令

# 摄取新资料
/synapse-wiki ingest /path/to/wiki "raw/articles/article.md"

查询命令

# 查询 Wiki 知识
/synapse-wiki query /path/to/wiki "LLM Wiki 的核心思想"

健康检查命令

# Wiki 健康检查
/synapse-wiki lint /path/to/wiki

初始化命令

# 初始化新的 Wiki 知识库
/synapse-wiki init /path/to/wiki "AI 学习知识库"

Scripts

脚本	用途
scripts/scaffold.py	引导新的 Wiki 目录树
scripts/ingest.py	摄取新资料，编译为 Wiki 页面
scripts/query.py	查询 Wiki，综合答案
scripts/lint_wiki.py	健康检查（死链接/孤立页/矛盾）

页面类型模板

概念页面 (400-1200 词)

---
title: <Title>
type: concept
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: [slug1, slug2]
tags: [tag1, tag2]
---

# <Title>

<一句话定义或核心思想。>

## What it is
<清晰解释。>

## How it works
<机制、过程或结构。>

## Key properties / tradeoffs
<重要特征。>

## Relationship to other concepts
<相关概念的 wikilinks。>

## Open questions
<Wiki 尚未解决的问题。>

实体页面 (200-500 词)

---
title: <Name>
type: entity
entity_type: person | tool | paper | organization | project
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: [slug1]
tags: [tag1]
---

# <Name>

<一句话描述。>

## Key contributions / features
<主要贡献或特性。>

## Related concepts
<相关概念。>

Summary 页面 (150-400 词)

---
title: summaries/<slug>
type: summary
source_type: article
date: YYYY-MM-DD
ingested: YYYY-MM-DD
tags: []
---

# <Source Title>

## Key takeaways
- <最重要洞察 1>
- <最重要洞察 2>
- <最重要洞察 3>

## Core claims
<主要论点的 2-4 句话摘要。>

## Concepts introduced / referenced
<概念和实体。>

索引和日志

index.md 格式

# Index — <Wiki Name>

## Concepts（概念）
- [[Page Name]] — One-line summary

## Entities（实体）
- [[Page Name]] — One-line summary

## Summaries（资料摘要）
- [[summaries/slug]] — One-line summary

log.md 格式

## [YYYY-MM-DD] ingest | <slug> — <description>
## [YYYY-MM-DD] query | <question-slug>
## [YYYY-MM-DD] lint | <N> issues found
## [YYYY-MM-DD] promote | <page-name> (from query)

Session 启动检查清单

每个新 Session：

1. 读取 CLAUDE.md，确认范围和规范
2. 读取 log.md 最近 5 条：grep "^## \[" log.md | tail -5
3. 如有新 raw/ 资料，执行 Ingest
4. 如用户提问，执行 Query（先查 index.md）
5. 如 ingest 超过 10 次未 lint，执行 Lint

安装

# 方式 1: 使用安装脚本（推荐）
cd ~/.claude/skills/synapse-wiki
./install.sh

# 方式 2: 手动复制
cp -r synapse-wiki ~/.claude/skills/

# 方式 3: OpenClaw (如有 .skill 文件)
claude skill install synapse-wiki.skill

使用场景

• 📚 个人知识库建设 — 积累 AI/技术知识，构建第二大脑
• 📝 项目文档管理 — 维护项目 Wiki，团队成员快速上手
• 🔍 知识检索 — 快速查找已学概念，不再大海捞针
• 🧹 知识整理 — 定期健康检查，保持知识网络整洁