SuperAPI AI 工具集

personal-memory

办公与效率

查看项目

更新于 10-16 05:05

技能介绍

用途:为 Codex 提供跨会话的长期记忆与自我改进能力,支持用户级(默认根目录 ~/.codex)和项目级(项目目录)两种上下文。用户级只存跨项目的用户信息,项目级只存该项目内有效的信息。

主要能力:管理 AGENTS.md、personal-memory/ 与 automation/ 目录;维护 README.md、profile.md、summary.md、observations.jsonl、facts.jsonl、patterns.jsonl、anti_patterns.jsonl 等文件;支持捕获偏好、事实、模式与失败,提升重复观察并重建摘要,搜索、列出、删除或清空记忆,以及从近期 Codex 历史中挖掘安全候选。

使用方式:脚本位于本技能的 scripts/ 子目录,需先将 ${SKILL_DIR} 替换为实际路径。常用命令包括:python3 ${SKILL_DIR}/scripts/memory_cli.py status --level user;init --level user;show;show 中文;list;review-history;review-history --apply;remember --kind preference --scope user --summary "..." --details "...";capture --kind preference --scope user --summary "..." --details "..." --source conversation --tag language;evolve;forget --query 简体中文;clear --yes。项目级命令需加 --level project --root /path/to/project。

适用场景:需要让 Codex 记住稳定偏好、工作流约定或避免重复错误时;用户明确要求记住某事时可直接用 remember 写入长期记忆。

限制:不得存储密钥、令牌、凭据或敏感隐私数据;不得将单次事件提升为长期记忆;项目级事实不得提升到用户级。用户级根目录可用 PERSONAL_MEMORY_HOME 或 CODEX_HOME 覆盖,未设置时默认 ~/.codex。在 Codex 之外复用时应将技能放入项目或映射 SKILL_DIR,而非假设 ~/.codex/skills/... 存在。提升后的记忆应作为参考而非绝对真理,优先采用较新、证据更强的记录。