wiki
为智能体提供结构化的本地知识库索引与管理工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:wiki。 它的用途是:为智能体提供结构化的本地知识库索引与管理工具 详细介绍见:https://321skill.com/skills/wiki/ 请根据该页面的说明完成安装。
使用示例
“查询我们项目中关于用户认证 API 的设计决策”,它会通过 wiki skill 读取知识库的索引,快速定位到 `/api/auth/_index.md` 及相关文档,并摘要关键信息给你。或者,在编写新功能时,你可以说:“根据知识库的支付模块规范,生成对应的接口代码”,AI 会基于 wiki 中的规范文档来生成更准确的代码。
介绍
wiki 是一个为 AI 智能体设计的命令行工具,用于创建和管理结构化的 Markdown 知识库。它解决了智能体在项目中难以快速、准确地定位和利用分散知识的问题。通过在每个文件夹中自动生成 _index.md 文件,它构建了一个树状索引系统,智能体可以通过 CLI 查询,只打开与任务相关的页面,从而优化 Token 消耗并提升信息检索效率。
使用时,用户只需在项目根目录运行 wiki init 初始化,然后通过 wiki update 维护索引。智能体(如 Claude Code)可以通过安装对应的 Skill 插件,直接与知识库交互,查询或更新项目知识。这使得项目文档既是人类可读的,也是机器可查询的。
这个工具特别适合需要将项目知识(如设计决策、API 文档、业务逻辑)系统化,并希望 AI 助手能基于这些知识进行工作的团队或个人开发者。无论是管理长期项目的上下文,还是为新成员快速熟悉代码库提供支持,wiki 都能将零散知识转化为可操作的索引。
建议将 wiki 与 Obsidian 等 Markdown 编辑器结合使用,由人类负责内容创作,由智能体负责索引维护和查询。注意,它主要优化的是知识的读取和检索过程,复杂的知识推理仍需依赖智能体自身的能力。定期运行 wiki update 可以确保索引与最新内容同步。
核心特点
与手动维护或仅提供扁平化搜索的知识库工具不同,wiki 采用 Andrej Karpathy 提出的“LLM Wiki 模式”,通过确定性的 CLI 自动生成并维护树状索引(`_index.md`),能智能处理并行编辑时的索引合并冲突,让开发者只需专注于内容创作。
注意事项
不适合需要复杂关系图谱、实时协作编辑或非文本知识(如图片、视频内容)直接索引的场景。
常见问题
wiki 和普通的 Markdown 文件夹有什么区别?
wiki 会自动生成并维护 `_index.md` 索引文件,为 AI 智能体提供结构化的导航,使其能像查字典一样快速定位所需知识,而不是遍历所有文件。
已经用 Obsidian 了,还需要 wiki 吗?
需要。Obsidian 面向人类浏览,wiki 的 CLI 和索引是为 AI 智能体查询而优化的,两者结合可实现“人写机读”的高效知识管理。