wiki

用途

wiki 是一个 AI 技能，用于把个人数据（日记、笔记、消息等任意格式）编译成个人知识维基。它的定位不是档案管理员，而是写作者：读取条目、理解其含义，并写出能捕捉理解的维基文章。维基被视为一张思维地图，覆盖一个人的整个内在与外在世界，包括项目、人物、想法、品味、影响、情感、原则和思维模式。

主要能力

• 摄取（ingest）：将源数据转换为 raw/entries/ 下的单个 markdown 条目文件。支持多种数据格式，包括 Day One JSON、Apple Notes、Obsidian Vault、Notion 导出、纯文本/Markdown、iMessage 导出、CSV/表格、邮件导出、Twitter/X 归档等。脚本自动检测格式，输出带 YAML frontmatter 的条目文件，且具有幂等性。
• 吸收（absorb）：核心编译步骤，按时间顺序逐条处理条目，将条目理解并编织进维基文章。支持日期范围参数，默认吸收最近 30 天。
• 查询（query）：通过导航维基回答关于对象生活的问题。只读操作，不读取原始日记条目，不修改维基文件。
• 清理（cleanup）：使用并行子代理审计并丰富维基中的每篇文章，包括结构评估、重构、补充上下文、识别缺失文章候选等。
• 拆分（breakdown）：查找并创建缺失的文章，通过识别具体实体和主题来扩展维基。
• 状态（status）：显示统计信息。

使用方式

安装技能后，把数据文件放在项目根目录，然后执行命令：

npx skills add ValorVie/ai-dev-skills --skill wiki

接着执行：

/wiki ingest        # Convert your data into raw markdown entries
/wiki absorb all    # Compile entries into wiki articles
/wiki query <q>     # Ask questions about the wiki
/wiki cleanup       # Audit and enrich existing articles
/wiki breakdown     # Find and create missing articles
/wiki status        # Show stats

目录结构：

your-project/
  data/                  # Your source files (DO NOT MODIFY after ingest)
  raw/entries/            # One .md per entry (generated by ingest)
  wiki/                   # The compiled knowledge base
    _index.md             # Master index with aliases
    _backlinks.json       # Reverse link index
    _absorb_log.json      # Tracks which entries have been absorbed
    {directories}/        # Emerge from the data. Don't pre-create.

可用 --dir <name> 覆盖维基目录。每个版本是独立宇宙，不读取或引用其他版本。

适用场景

• 将多年日记、笔记、消息等个人数据整理成结构化的知识维基。
• 通过查询功能回顾个人生活、项目、决策和人际关系。
• 发现个人思维模式、哲学和反复出现的主题。
• 将分散的个人记录转化为可导航、可引用的知识库。

限制

• 查询功能不读取原始日记条目，只基于维基文章回答。
• 如果维基未覆盖某个问题，应明确说明，不猜测。
• 查询为只读，不修改任何维基文件。
• 文章创建有门槛：如果无法写出至少 3 个有意义的句子，暂不创建页面。
• 写作风格要求类似维基百科，平实、事实性、百科全书式，避免 AI 编辑口吻、华丽词汇、修辞问句等。
• 具体支持的平台、收费、价格等信息暂未提供。