aim-write

aim-write

持久化保存一篇 wiki 页面。仅用于用户明确要求记住的规范性知识——常规会话记录由钩子自动捕获；不要手动编写，也不要用交接记录来保存永久注释。

步骤

1. 选择实例。 查看仓库的 MCP 配置。如果配置了多个 ai-memory 服务，请询问要写入哪个端点。

2. 选择工作区／项目。 默认使用仓库的 .ai-memory.toml；如果要写入其他位置，请先确认。

3. 选择路径和类型。 遵循文件夹约定，以便推导 kind 并保持检索结果整洁：

   • decisions/ADR-NNNN-<slug>.md → 决策
   • _rules/<slug>.md → 规则
   • gotchas/<slug>.md → 注意事项
   • 其他情况使用主题路径（例如 runbooks/<slug>.md、<area>/<slug>.md）。 你也可以通过 frontmatter node_type／工具参数显式设置 kind。

   _rules/ 前缀很重要——请使用下划线。 _rules/（以及置顶的 _slots/）下的页面属于 ai-memory 的最高信号等级： 它们会在 memory_briefing／memory_explore／ 仪表板中以原文呈现，匹配条件为 path GLOB '_rules/*'。普通的 rules/ 文件夹 （没有下划线）只是普通页面——不会获得任何这些效果，只能通过显式查询／读取找到。因此，请将持久规则写入 _rules/， 不要写入 rules/。

   共享／跨项目规则（例如在每个仓库中重复使用的全局 Agent 约定）应放在专用作用域——保留的 default／_global 作用域——下的 _rules/ 中（写入时使用 scope: "global"）。检索是按（工作区，项目）进行的，因此其他项目需要通过 memory_query scopes:[…]／memory_read_page 进行跨作用域 访问（参见 aim-query），不会自动获取。

4. 编写正文，使用带 frontmatter（title、node_type、tags，以及可选的 source:）的 Markdown。使用 [[path.md]] 链接相关页面（路径包含 .md；链接按精确路径解析）。切勿在页面中写入有效的机密／凭据——请脱敏处理（<see secret manager>）。

5. 调用 memory_write_page（或等效的管理写入功能），并提供工作区／项目／路径／正文。

6. 确认页面可以检索到（快速使用 aim-query 查询相关主题）。

页面应聚焦且精炼——每页只写一条事实／决策／注意事项，最便于阅读和检索。