Wiki 知识库编译器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sanyuan0704-sanyuan-skills-wiki-ingest。
技能介绍
问题背景
项目里会不断追加文章、笔记、PDF 摘抄和零散 Markdown,但知识仍停留在「按文件堆放」的状态:同名概念散落在不同路径,产品对比写在某一篇长文中间,后续要链接或检索时只能靠全文搜索碰运气。若你要让助手长期维护一套可浏览、可跳转的项目内知识库,需要的不只是「把全文贴进一个文件夹」,而是按知识实体拆页、统一命名,并在页面之间建立可维护的交叉引用。
技能如何工作
Wiki Ingest 按固定工作流把输入内容编译进 wiki/(或你指定的目录)。开始前会读取已有的 wiki/index.md,避免重复建页。抽取阶段把内容归到四类实体目录:concepts/(概念与术语)、products/(具体产品或工具)、patterns/(工程与设计模式)、comparisons/(跨产品或跨方案对比);只有「会被其他页面引用」的实体才单独成页,对应铁律:一页只承载一个知识实体。
建页或更新时遵循「存在则增补、不整页覆盖」:单行定义尽量稳定,优先刷新 Sources 与 Related Pages。全文使用 Obsidian 风格的 [[category/page-name]] 双链,并在页底列出相关页面。批量摄入会先汇总实体再一次性建页与改链,避免中间态不一致。每次结束会更新 wiki/index.md、在 wiki/log.md 追加记录,并汇报新建、更新与新建的交叉引用。
适用边界
不适合把整本无关紧要的流水账一次灌进 Wiki——只出现一次、不会被别处引用的概念应跳过。文件名一律小写连字符(如 agent-loop.md),按实体命名而非编号。若你已有 Obsidian 或类似双链习惯,目录与链接格式可以直接对齐;若团队约定另一套 Wiki 根路径,需在 ingest 前明确路径,否则会默认落在项目下的 wiki/。
使用场景
- 读完多篇竞品评测后,要把各产品拆成独立页,并在对比文里用双链互指
- 把会议纪要与设计文档批量导入,只为会反复提到的架构模式单独建 patterns 页
- 维护开源项目文档时,新概念写入后需同步更新已有概念页的 Related Pages
- 研究员整理文献笔记,要求 concepts 与 comparisons 分目录且 index 按类可浏览
适合人员
- 负责文档站结构、希望仓库内 Wiki 与代码同库版本化的技术写作
- 做竞品与方案调研、需要把 products 与 comparisons 拆页串联的架构师
- 用 Obsidian 双链习惯、要把外源 Markdown 编译进项目 wiki/ 的维护者
- 带新人 onboarding,需从散乱笔记抽出 concepts 并避免重复建页的工程负责人