ai-memory-routing-install

ai-memory 路由安装

当用户希望安装、刷新、修复或移除 ai-memory 面向 Agent 的路由说明或受管理的 Agent Skills 时，请使用此技能。

此集群中的工具

• memory_install_self_routing 会返回规范的带标记说明块、标记字符串、文件名提示、备注，以及供无法让 MCP 服务直接写入主机文件系统的 Agent 使用的受管理技能载荷。已安装受管理的 Agent Skills，或刷新已有精简代码片段的文件时，请传入 compact: true。

受管理说明标记

只有位于以下标记之间的始终加载说明块归 ai-memory 所有。

• 起始标记：``
• 结束标记：``

刷新时，必须替换第一个完整的标记块：其起始和结束分隔符须各自单独占一行，并保留其前后的无关内容。忽略正文或代码中对标记字符串的行内提及；这些不是分隔符。如果不存在由完整独立行界定的标记块，则在末尾追加规范说明块，并用一个空行隔开。刷新 ai-memory 路由时，绝不要编辑无关说明。

受管理技能标记

每个由 ai-memory 管理的 SKILL.md 文件都包含此所有权标记。

``

只有存在该标记时，安装程序和卸载程序才能覆盖或移除同名技能文件，除非用户明确提供了强制选项。如果同名技能没有该标记，则跳过并给出可执行的提示，以保留用户编写的技能。

全局 Grok 安装还会将 $GROK_HOME/rules/ai-memory-handoff.md（默认为 ~/.grok/rules/ai-memory-handoff.md）写入带有所有权标记 `` 的文件。只有存在该标记时，才能覆盖或卸载此文件，除非用户提供了 --force。项目范围的 Grok 技能安装不会修改该用户规则。

技能安装目标

受管理技能属于普通 Agent Skills。其相对文件路径为 <skill>/SKILL.md，安装程序会在前面加上所选技能根目录。

项目本地目标：

• .claude/skills/<skill>/SKILL.md，用于 Claude 兼容安装。
• .agents/skills/<skill>/SKILL.md，用于跨客户端安装。
• .grok/skills/<skill>/SKILL.md，用于 Grok Build CLI 安装。
• .github/skills/<skill>/SKILL.md，用于 GitHub Copilot CLI 安装。

全局目标：

• ~/.claude/skills/<skill>/SKILL.md，用于 Claude 兼容安装。
• ~/.agents/skills/<skill>/SKILL.md，用于跨客户端安装。
• $GROK_HOME/skills/<skill>/SKILL.md，用于 Grok Build CLI 安装（默认为： ~/.grok/skills/<skill>/SKILL.md）。
• $COPILOT_HOME/skills/<skill>/SKILL.md，用于 GitHub Copilot CLI 安装 （默认为：~/.copilot/skills/<skill>/SKILL.md）。

请使用平台感知的路径拼接方式。不要通过字符串拼接来构建路径。

刷新指南

在 Agent 端刷新时，调用路由安装工具（如果目标文件已使用精简代码片段，或受管理的 Agent Skills 已处理详细路由，请传入 compact: true）。其返回的 target_hints 是技能根目录的权威依据：从 agent_filenames 中选择正确的说明文件名，使用 Agent 的文件编辑工具写入带标记的说明块，并在所选提示指定的位置下，使用对应的 relative_path 写入每个受管理技能文件。如果某个提示是数组，则需在列出的每个根目录下安装该技能。Claude Code 通常使用 CLAUDE.md 和 .claude/skills；Codex、OpenCode、Cursor、Gemini CLI 以及支持 AGENTS 的客户端通常使用 AGENTS.md 和 .agents/skills；Antigravity 在项目中使用 AGENTS.md 和 .agents/skills，全局安装时则使用单独的 App/IDE 和 CLI 根目录；Grok Build CLI 使用 AGENTS.md 和 .grok/skills；GitHub Copilot CLI 使用 AGENTS.md 和 .github/skills，除非项目另有说明。

通过 CLI 刷新时，优先使用规范安装命令。代码片段和技能必须从同一组由核心部分管理的资源更新，以免内容不一致。