用途
ai-memory-routing-install 是 ai-memory 面向智能体的路由安装技能,用于处理 ai-memory 路由指令和托管 Agent Skills 的安装、刷新、修复、检查与移除请求。它主要服务于无法让 MCP 服务器直接写入宿主文件系统的智能体,由智能体侧自行完成文件写入。
主要能力
该技能群的核心工具为 memory_install_self_routing,返回规范的带标记指令块、标记字符串、文件名提示、说明以及托管技能载荷。当已安装托管 Agent Skills,或刷新已使用紧凑片段的文件时,可传入 compact: true。
托管指令块由两个标记界定:起始标记 <!-- ai-memory:start -->,结束标记 <!-- ai-memory:end -->。ai-memory 仅拥有这两个标记之间的内容。刷新时应替换第一个完整的、由标记界定且起止分隔符各自独占一行的块,保留其前后无关内容;正文或代码中行内的标记字符串不算分隔符。若不存在完整的行级块,则以一个空行分隔追加规范块。刷新时不得改动无关指令。
每个托管的 SKILL.md 文件包含归属标记 <!-- ai-memory-managed: routing-skill -->。安装器与卸载器仅在该标记存在时覆盖或删除同名技能文件,除非用户显式提供 force 选项;若同名技能缺少该标记,则跳过并给出可操作提示,以保留用户自编技能。
全局 Grok 安装还会写入 $GROK_HOME/rules/ai-memory-handoff.md(默认 ~/.grok/rules/ai-memory-handoff.md),其归属标记为 <!-- ai-memory-managed: grok-handoff-rule -->;仅在该标记存在时覆盖或卸载该文件,除非提供 --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、~/.agents/skills/<skill>/SKILL.md、$GROK_HOME/skills/<skill>/SKILL.md(默认 ~/.grok/skills/<skill>/SKILL.md)、$COPILOT_HOME/skills/<skill>/SKILL.md(默认 ~/.copilot/skills/<skill>/SKILL.md)。路径应使用平台感知的拼接方式,不得用字符串拼接构建路径。
智能体侧刷新时,调用 install-routing 工具(若目标文件已用紧凑片段或托管技能负责详细路由,则传 compact: true)。返回的 target_hints 对技能根目录具有权威性:从 agent_filenames 选择正确的指令文件名,用智能体的文件编辑工具写入带标记块,并按各托管技能文件的 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 刷新时优先使用规范安装命令。指令片段与技能必须来自同一套核心维护的资源,以免不同步。
适用场景
适用于需要为不同智能体客户端配置 ai-memory 路由提示、安装或修复托管技能、清理已有安装,以及在保留用户自定义内容的前提下安全更新指令文件的场景。
限制
资料未提供该技能的收费、价格、平台兼容细节及具体安装命令文本,相关事实暂未提供。