SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场wiki-agent

wiki-agent

通用与其它

查看项目

更新于 10-16 07:48

技能介绍

用途

Wiki Agent 用于执行“查询驱动的定向摄取”：从某一个特定 AI 智能体的原始对话历史中，找到与某个主题相关的会话，提取相关内容，蒸馏进 wiki，并返回一个用户可立即使用的综合答案。它面向的典型场景是：用户当前正在使用另一个智能体，希望把其他智能体过去会话中的上下文拉取过来。这不是批量摄取，而是针对特定主题的定向检索与摄取。

主要能力

  • 命令路由：通过命令指定目标智能体与可选查询。
    • /wiki-claude [query] → Claude Code 历史
    • /wiki-codex [query] → Codex CLI 历史
    • /wiki-hermes [query] → Hermes 智能体历史
    • /wiki-openclaw [query] → OpenClaw 历史
    • /wiki-copilot [query] → Copilot 聊天历史
    • /wiki-pi [query] → Pi 智能体历史
  • 无查询时的默认行为：进入“最近会话模式”，摄取该智能体最近 5 个未处理会话并返回摘要。
  • 会话打分：按名称/标题匹配（+3）、CWD/项目匹配（+2）打分，并应用 90 天半衰期的指数时间衰减作为乘数：score = base * (0.35 + 0.65 * 0.5 ** (age_days / 90))。0.35 的下限是刻意保留的，使精确匹配的旧会话仍能排在勉强匹配的新会话之前。
  • 定向提取：只打开选中的会话文件，提取与查询相关的内容，而非读取整个会话。
  • 蒸馏入 wiki：判断内容归属（skills/、concepts/、entities/、synthesis/），更新或创建带 frontmatter 的页面，并添加交叉链接。
  • 返回综合答案：输出“来自 <agent> 历史：<query>”格式的结果，包含关键洞察、更新/创建的 wiki 页面、已摄取会话表格与缺口说明。
  • 跟踪更新：更新 .manifest.json，并通过 obsidian-wiki memory sync 命令更新日志、索引与热缓存。

使用方式

  1. 开始前：读取并应用 llm-wiki/SKILL.md 中的 Writing Profile Resolution 部分；按 Config Resolution Protocol 解析配置，获得 OBSIDIAN_VAULT_PATH；读取 $OBSIDIAN_VAULT_PATH/.manifest.json 了解已摄取内容；若存在则读取 hot.md 获取近期 wiki 活动上下文。
  2. 定位历史根目录：各智能体有默认路径与配置覆盖项，例如 claude 默认 ~/.claude 及 ~/Library/Application Support/Claude/local-agent-mode-sessions/，可用 CLAUDE_HISTORY_PATH 覆盖；codex 默认 ~/.codex，可用 CODEX_HISTORY_PATH；hermes 默认 ~/.hermes，可用 HERMES_HOME；openclaw 默认 ~/.openclaw，可用 OPENCLAW_HOME；copilot 默认 ~/.copilot，可用 COPILOT_HISTORY_PATH；pi 默认 ~/.pi/agent/sessions，可用 PI_HISTORY_PATH。若历史根目录不存在，则停止并提示用户。
  3. 构建会话清单：使用各智能体最廉价的索引来源，例如 Claude 用 ~/.claude/projects/ 与 local_.json，Codex 用 ~/.codex/session_index.jsonl，Hermes 用 ~/.hermes/memories/.md，OpenClaw 用 MEMORY.md 与每日笔记，Pi 用会话目录与文件系统作为索引。
  4. 按查询打分并选出前 3–5 个会话；无查询时选最近 5 个未处理会话。
  5. 定向提取相关片段：各智能体有不同提取策略，例如 Claude 用 rg 搜索并提取前后窗口，Codex 过滤 event_msg 与 response_item，Pi 构建活动分支并沿 parentId 回溯。
  6. 蒸馏为 wiki 页面：检查是否已有页面覆盖，确定分类，写入带 frontmatter 的页面，设置 sources 为 <agent>://<path/to/session>，并添加交叉链接。
  7. 返回综合答案并更新跟踪文件。

适用场景

  • “我在用 Codex，之前在 Claude 里对 X 想通了什么？”→ /wiki-claude "X"
  • “我上周在 Hermes 里解决了一个 bug，现在在 Claude Code 里需要那段上下文。”→ /wiki-hermes "bug description"
  • “我对 X 在所有工具里试过哪些方法？”→ 依次运行 /wiki-claude "X"、/wiki-codex "X"、/wiki-hermes "X"，再用 /memory-bridge diff 查看各工具独特贡献。
  • 无查询，只想“补一下最近的 Codex 工作”→ /wiki-codex
  • 无查询，只想“补一下最近的 Pi 工作”→ /wiki-pi

限制

  • 仅针对资料中列出的智能体历史路径与索引方式；其他智能体暂未提供。
  • 需要配置 OBSIDIAN_VAULT_PATH 等环境；若历史根目录不存在会停止并提示。
  • 不读取完整大型会话，采用定向提取，可能遗漏未命中关键词的相关内容。
  • 若查询无匹配会话，会明确说明并列出最近 3 个会话的主题。
  • QMD 刷新为可选步骤：若 $QMD_WIKI_COLLECTION 为空或未设置则跳过；刷新失败不回滚 vault 更改，仅单独报告 QMD 状态。
  • 不得手工编辑 index.md、log.md 或 hot.md，必须通过命令加锁更新。