SuperAPI AI 工具集

yichen-agent-memory

智能体与模型

查看项目

更新于 10-16 00:22

技能介绍

用途:该技能是面向 Agent 的操作手册,帮助用户安装或运行公开的 Agent Memory Vault 系统。仓库地址为 https://github.com/mcncarl/agent-memory-vault。Vault 可被 Claude Code 与 Codex 共享,Markdown 是唯一事实来源,各宿主仅保留轻量的规则与 hook 适配层。

主要能力与边界:运行任何常规命令前,先执行 memoryctl --actor <actor> version --json;仅当 ready=true、runtime_api_version=2、writer_protocol_version=2,且状态模式证明与 Runtime/config/Hook 完整性哈希均有效时,受管 Runtime 才可用。安装或迁移期间常规命令必须 fail closed,不得绕过过渡标记直接调用 Python 入口。SQLite/FTS、Zvec、claims、intents、receipts、observations 均为控制或派生状态;claims 是活动写入意图的收尾/审计投影,不是锁或编辑许可。支持的自动写入者为 codex、claude 和 ailu,三者竞争同一规范路径租约。

使用方式:按任务选择对应参考。检索或读取当前记忆用 Daily reads;新增或更新正式记忆用 Write Gateway,并先查阅 Vault 写入策略;安装或升级用 Install and upgrade;审计、语义索引维护或 hook 配置用 Maintenance;公共安全模板源用 Template development;诊断故障或恢复未完成事务用 Troubleshooting。正式写入始终采用 read-target → prepare → apply,不得先编辑后声明,并保留逐动作确认、路径租约、CAS 与 Stop Hook 保护。成功 apply 通常包含 closeout。搜索结果在重读当前 Markdown 前仅为候选。

安全规则:不得将用户真实记忆库复制到公共仓库;不得提交 .env、SQLite 数据库、Zvec/向量存储、模型缓存、日志、API 密钥、cookie、令牌、密码、私聊记录、客户数据或个人绝对路径;迁移现有记忆系统时仅迁移结构、脚本和脱敏模式;发布或推送前运行泄露检查并检查 diff;删除文件需先获用户明确许可并使用回收站;不得将 Claude Code auto-memory 指向正式 Vault;共享 cookie 与令牌应放在 Vault 和 Git 之外的私有配置中。

适用场景与限制:适用于安装、维护、审计、排障等明确的记忆系统任务;普通业务的历史回忆不应触发安装或维护流程。资料未提供具体计费、价格、支持平台与效果数据。