前言¶

在 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