前言¶

在 Windows 上用 Codex App 接 agentmemory 做长期记忆，常见的问题不是「装不上」，而是装上了但不生效：PowerShell 钩子执行失败，~/.codex/hooks.json 写了却拿不到 additionalContext，知识图谱节点长期不更新、变成陈旧数据，或者 MCP 与 hook 两边配置互相打架，排查起来要在 PowerShell、配置文件和 agentmemory 之间来回切换。

codex-agentmemory-windows 这个 Skill 就是针对这一组问题设计的。下面介绍它是什么、能做什么、怎么启用，以及哪些情况不该用它。

这是什么¶

codex-agentmemory-windows 是一个社区发布的通用 SKILL.md 格式 Skill，坐标 @user_15292d5a/yjkj-codex-agentmemory-windows，版本 1.0.0，维护者为 user_15292d5a，分类属于 it-ops-security，标签包含 requires_api_key=true，即运行需要可用的 API key。

它解决的问题范围很窄但具体：让 Codex App 在 Windows 上正确接入 agentmemory，并修复接入失败的各种表现。它不是通用的记忆管理工具，也不负责 Windows 系统层面的运维。

截至抓取时间，SkillHub 页面显示评分 100000、下载 1231 次、安装数 0。这几个数字会变动，以官方页面为准。

核心功能¶

根据官方简介，这个 Skill 覆盖以下能力：

1、配置 agentmemory 与 Codex App 的 hook 集成，包括初始化 hooks 和校验配置是否生效。
2、修复 Windows 下 PowerShell hook 执行失败的问题，这类失败在 Windows 上比在 macOS/Linux 上更常见，因为 hook 调用依赖 PowerShell 环境。
3、生成 agentmemory-hook.cmd 包装脚本。Windows 上 Codex 调 hook 走的是 cmd 包装，没有这个包装，PowerShell 脚本经常直接失败。
4、更新 ~/.codex/hooks.json，并维护其中的 trusted_hash 条目。trusted_hash 用于匹配已信任的内容哈希，条目过期会导致 hook 被静默跳过。
5、修复 Codex 缺少 additionalContext 记忆注入的问题，也就是记忆明明存在却没有进入对话上下文的表现。
6、修复 agentmemory 知识图谱更新停滞或冻结的问题，让旧的图谱节点和边不再长期不刷新。
7、回填图谱节点和边，用于图谱数据缺失后补齐。
8、排查 Codex App 的 agentmemory MCP / hook 配置冲突，即 MCP 通道与 hook 通道同时存在时哪一条生效、如何对齐。

这些能力对应的是「接入」和「修复」两类动作，没有提到提供 Web 界面或跨平台同步。

安装与启用¶

官方页面未提供统一的安装命令文本，因此这里不猜测命令。启用前请先确认两件事。

一是 API key。该 Skill 标记为 requires_api_key=true，运行依赖可用的 API key，先把 key 准备好再启用，否则 hook 会在调用阶段失败，症状和配置错误很像。

二是确认 Codex App 运行在 Windows 上，且能正常调用 PowerShell 与 cmd。这是该 Skill 全部用例的前提。

启用方式是在 Codex App 中按社区 Skill 的坐标引用该 Skill：@user_15292d5a/yjkj-codex-agentmemory-windows。具体安装入口和命令以官方页面为准，本页资料中没有给出命令行安装方式，不做推测。

接入涉及的两个核心路径，Skill 在运行时会读写：

~/.codex/hooks.json
agentmemory-hook.cmd

hooks.json 是 Codex 的 hook 配置入口，trusted_hash 条目在其中维护；agentmemory-hook.cmd 是 Windows 侧的包装脚本，由 Skill 生成。

典型用法¶

这个 Skill 的用法是「描述症状让它修」，而不是手写脚本。按官方简介，它面向的几类典型输入如下。

钩子搭建阶段，让 Skill 完成 hook 接入，然后校验配置是否生效：

要求：配置 agentmemory hooks，并验证 ~/.codex/hooks.json 生效

PowerShell hook 执行失败时，需要它定位失败原因并生成 cmd 包装，而不是手动改脚本：

要求：修复 Windows PowerShell hook 执行失败，生成 agentmemory-hook.cmd

记忆没有进入上下文，或者图谱数据长期不更新时，症状分别落在 additionalContext 和图谱层，交给 Skill 判断走哪条修复路径：

要求：排查 additionalContext 记忆注入缺失
要求：修复知识图谱更新停滞，必要时回填节点和边

MCP 与 hook 同时存在、不确定哪条通道生效时，让 Skill 做配置排查：

要求：排查 Codex App 的 agentmemory MCP / hook 配置冲突

以上是按官方简介归类的用法方向，不是逐字命令。Skill 内部实际执行的诊断步骤以包内 SKILL.md 为准。

适用场景与注意¶

适合谁：在 Windows 上使用 Codex App、已经尝试接入 agentmemory 但卡在 hook 或图谱层的开发者；以及需要排查 MCP 与 hook 配置冲突的人。前提是有可用的 API key，并且工作目录在 Windows 环境。

不适合谁：macOS 或 Linux 用户。该 Skill 的多个用例直接依赖 Windows 的 PowerShell 和 cmd 包装，在非 Windows 平台上没有对应问题，也不保证有效。不需要长期记忆、或者还没接入 agentmemory 的人，先接入再考虑修复。

需要注意的几点：

1、标签为 requires_api_key=true，无 key 时不要启用，否则会把配置问题误判为 key 问题。
2、不要手动改 hooks.json 的 trusted_hash 条目。条目过期或不匹配是静默失败的原因之一，交给 Skill 维护更可靠。
3、图谱「冻结」不一定是数据丢失，可能是更新路径断了。回填节点和边属于重建操作，执行前先确认确实需要。
4、该 Skill 是社区来源（source: community），不是官方维护。引入前按社区 Skill 的常规做法自行审一下包内内容。

结尾¶

codex-agentmemory-windows 的价值在于把 Windows 上 Codex App 接 agentmemory 的常见故障收敛成一条修复路径：从 PowerShell hook 失败、agentmemory-hook.cmd 缺失，到 hooks.json 与 trusted_hash 不生效、additionalContext 注入缺失、图谱停滞，都能按症状处理，而不需要自己在 PowerShell 和配置之间反复试错。

官方地址：https://api.skillhub.cn/user_15292d5a/yjkj-codex-agentmemory-windows