SuperAPI AI 工具集

wiki

写作与研究

查看项目

更新于 10-15 18:08

技能介绍

用途

Wiki 是一个持久化、自我维护的 Markdown 知识库,用于沉淀项目与会话知识,灵感来自 Karpathy 的 LLM Wiki 概念。它让知识能够跨会话累积,形成可复用的项目记忆。

主要能力

  • Ingest(摄入):将知识处理为 wiki 页面,单次摄入可涉及多个页面。示例: wiki_ingest({ title: "Auth Architecture", content: "...", tags: ["auth", "architecture"], category: "architecture" })
  • Query(查询):按关键词与标签搜索所有 wiki 页面,返回带摘要的匹配页面,由 LLM 结合结果生成带引用的答案。示例: wiki_query({ query: "authentication", tags: ["auth"], category: "architecture" })
  • Lint(检查):对 wiki 运行健康检查,检测孤立页面、过期内容、损坏的交叉引用、超大页面和结构性矛盾。示例:wiki_lint()
  • Quick Add(快速添加):快速添加单个页面,比 ingest 更简单。示例: wiki_add({ title: "Page Title", content: "...", tags: ["tag1"], category: "decision" })
  • List / Read / Delete(列出/读取/删除): wiki_list() 显示所有页面(读取 index.md); wiki_read({ page: "auth-architecture" }) 读取指定页面; wiki_delete({ page: "outdated-page" }) 删除页面。
  • Log(日志):通过读取 .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-link 语法在页面之间创建交叉引用。

自动捕获:会话结束时,重要发现会自动捕获为 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 不会改变委派行为。