mcpField
W
wiki

wiki

github.com/yeachan-heo生产力40.4k626 次安装1 天前更新
代码仓库

关于 wiki

wiki 是项目级的持久化 Markdown 知识库,面向需要保存和检索项目及会话信息的团队。它支持关键词与标签查询,并提供页面健康检查和会话结束时的自动记录。

主要功能

  1. 01多页面知识摄取
  2. 02关键词与标签查询
  3. 03页面健康检查
  4. 04快速添加、读取与删除
  5. 05会话结束自动记录

适用场景

  1. 01记录项目架构与决策
  2. 02按关键词查找项目知识
  3. 03检查孤立或过时页面
  4. 04保存会话中的重要发现

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill wiki

安装后在 Claude Code 中输入/wiki确认已加载。

详细介绍

Wiki

用于项目和会话知识的持久、自维护 Markdown 知识库。灵感来自 Karpathy 的 LLM Wiki 概念。

操作

导入

将知识整理到 Wiki 页面中。一次导入可以涉及多个页面。

wiki_ingest({ title: "Auth Architecture", content: "...", tags: ["auth", "architecture"], category: "architecture" })
查询

按关键词和标签搜索所有 Wiki 页面。返回匹配页面及其摘要片段——由你(大模型)根据结果综合答案并添加引用。

wiki_query({ query: "authentication", tags: ["auth"], category: "architecture" })
检查

对 Wiki 运行健康检查。检测孤立页面、过时内容、失效的交叉引用、过大的页面和结构性矛盾。

wiki_lint()
快速添加

快速添加单个页面(比导入更简单)。

wiki_add({ title: "Page Title", content: "...", tags: ["tag1"], category: "decision" })
列出 / 阅读 / 删除
wiki_list()           # Show all pages (reads index.md)
wiki_read({ page: "auth-architecture" })  # Read specific page
wiki_delete({ page: "outdated-page" })    # Delete a page
日志

通过读取 .omc/wiki/log.md 查看 Wiki 操作历史。

分类

页面按类别组织:architecture、decision、pattern、debugging、environment、session-log

存储

  • 页面:.omc/wiki/*.md(带 YAML frontmatter 的 Markdown)
  • 索引:.omc/wiki/index.md(自动维护的目录)
  • 日志:.omc/wiki/log.md(仅追加的操作记录)

交叉引用

使用 [[page-name]] Wiki 链接语法在页面之间创建交叉引用。

自动捕获

会话结束时,重要发现会自动保存为 session-log 页面。通过 .omc-config.json 中的 wiki.autoCapture 配置(默认:启用)。

硬性限制

  • 不使用向量嵌入——查询仅使用关键词和标签匹配
  • Wiki 页面默认由 Git 忽略(.omc/wiki/ 为项目本地目录)

模型路由

  • haiku — 快速查找、轻量检查、范围有限的文档工作
  • sonnet — 常规实现、调试和审查
  • opus — 架构、深度分析、共识规划和高风险审查
  • fable — Claude Fable 5(高于 Opus);在 Task 调用中显式传入,或通过 agents.<name>.model 为每个 Agent 固定模型
  • 使用 /model 选择的会话模型仅应用于主循环。委派的 Agent 会使用其固定层级,除非 Task 调用显式传入 model,或通过 agents.<name>.model 覆盖该 Agent。要让委派任务使用 Fable,请使用上述两种方式之一;仅在 /model 中选择 Fable 不会改变委派任务所用的模型。

评论

支持 Markdown