SuperAPI AI 工具集

wiki-ingest

写作与研究

查看项目

更新于 10-16 08:45

技能介绍

用途:将任意文本内容(文章、文档、笔记)编译为结构化 wiki 页面,建立交叉引用,形成可搜索、互联的知识网络。核心原则是一页一个知识实体,不把多个概念塞进同一页。

目录结构:wiki 默认位于当前项目根目录下的 wiki/,用户可指定其他路径。包含 index.md(总目录)、log.md(只追加的操作日志)、concepts/(核心概念页)、products/(产品/工具实体页)、patterns/(工程模式与设计决策)、comparisons/(跨主题对比页)。

工作流程:1)确认输入,支持直接粘贴文本、文件路径(md、txt、pdf 等)或目录路径批量处理;未指定 wiki 路径时使用 wiki/,不存在则创建。2)读取 wiki/index.md 了解已有页面,避免重复。3)抽取知识实体,分为概念、产品、模式、对比四类;只有会被其他页面引用的实体才值得单独建页。4)创建或更新页面,已有页面则追加新信息而非覆盖,保持单行定义稳定,优先更新 Sources 与 Related Pages。5)更新交叉引用,检查所有已有页面并补充相关链接与信息。6)更新 index.md,按类别添加新条目。7)向 log.md 追加记录,包含日期、来源、新建页面、更新页面、新交叉引用。8)向用户报告结果。

命名与引用:文件名全小写、连字符分隔,如 agent-loop.md、kv-cache.md,按实体而非编号命名。交叉引用使用 [[category/page-name]] 双链格式(兼容 Obsidian),如 [[concepts/agent-loop]]、[[products/claude-code]],始终带类别前缀,并在页面底部列出所有相关页面。

限制与注意:不得创建重复页面,先检查 wiki/;不抽取琐碎实体;批量处理时先抽取全部实体再统一建页与更新引用,避免中间状态不一致;每次 ingest 后必须更新 index.md 与 log.md。具体页面模板需加载 references/page-templates.md,资料未提供模板内容。