mcpField
A
aim-query

aim-query

github.com/djalmajrAgent 工作流470 次安装5 周前更新
代码仓库

关于 aim-query

aim-query 是从 ai-memory 实例检索明确记忆的技能，指导 Agent 选择配置的端点与范围、调用合适的查询方式，并附路径报告结果。

主要功能

  1. 01从配置中选择 ai-memory 端点
  2. 02支持项目、多范围及全局检索
  3. 03选择查询、近期记录、探索、简报或状态工具
  4. 04报告匹配路径及相关性说明

适用场景

  1. 01提出设计前查询既有决策
  2. 02回顾项目近期动态
  3. 03检索跨项目共享约定

MCP 相关

它调用配置的 ai-memory MCP 服务提供的工具，包括 memory_query、memory_recent、memory_explore、memory_briefing 和 memory_status。

安装

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

$npx skills add https://github.com/djalmajr/skills --skill aim-query

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

详细介绍

aim-query

从 ai-memory 实例中显式检索信息（补充自动会话启动交接）。

步骤

  1. 选择实例。 从仓库的 .mcp.json / opencode.json / .codex/config.toml 中读取已配置的 ai-memory MCP 服务。如果配置了多个，询问用户要查询哪个端点。（由 aim-init 接入。）
  2. 选择范围。 默认使用仓库的 .ai-memory.toml 工作区/项目。用户可以扩大范围：选择其他项目、部分范围，或使用多个 scopes 跨项目检索。每个 scopes 条目包含 { workspace, project }，因此检索也可以跨越其他工作区（例如共享规则项目）；global: true 则会一次搜索所有项目。
    • 共享/全局规则存放在专用范围中（保留的 default/_global 范围，位于 _rules/ 下；≥1.9 时，服务器会将其并入默认范围查询，作为 global_scope_hits），与仓库自身项目分开。ai-memory 的自动检索按 (workspace, project) 进行，不会显示这些规则——请显式读取：使用对应的 workspace/project/path 调用 memory_read_page，或使用 scopes:[{ workspace, project }] 调用 memory_query。当任务需要 Agent 的长期约定（代码风格、测试门槛、工作流），而不只是仓库本地知识时，请这样做。
  3. 根据问题选择工具：
    • memory_query — 定向语义检索（“我们对 X 有过决定吗？”，在提出设计方案之前）。
    • memory_recent — 查询“最近有什么进展”（最近的 N 个页面）。
    • memory_explore — 开放式“帮我快速了解一下”（文本摘要；可选参数为 focus）。
    • memory_briefing / memory_status — 结构化快照/累计计数。
  4. 报告检索结果，附上其 path 和一行相关性说明；并可提出打开页面（通过 MCP 或 /api/v1/.../pages/<path> 读取其 markdown）。

让查询具体明确。如果没有检索到内容，请扩大范围或改写查询，然后再断定知识库中没有相关信息。

评论

支持 Markdown