SuperAPI AI 工具集

memory-management

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

该技能用于审计、提取、修剪或撰写 Claude Code 的记忆文件,来源于 xiaolai/echo-sleuth-for-claude。

用途:管理 Claude Code 的项目记忆,包括记忆文件格式、MEMORY.md 索引约定、陈旧度评分、声明提取与归档。

主要能力:

  1. 记忆文件格式:使用简单的 key: value 前置元数据(非通用 YAML),字段 name、description、type 均为必填字符串;type 取值为 value、user、feedback、project、reference。无嵌套结构、列表或多行值,正文为闭合 --- 后的 markdown。
  2. MEMORY.md 索引:纯 markdown、无前置元数据,条目格式为 - filename.md — 简述;Claude Code 加载器会截断 200 行之后的內容,需保持简洁。写入时先创建单个 .md 文件再追加条目。
  3. 陈旧度评分:指数衰减公式 score = 100 * (1 - exp(-age_days * ln(2) / half_life))。半衰期按类型:value 365 天、user 180 天、feedback 90 天、reference 60 天、project 14 天、unknown 30 天。分数 0-50 保留,50-75 复核,75-100 修剪。深度校验修正项(叠加、上限 100):引用文件缺失 +20、引用的函数或类未找到 +30、URL 返回非 200 +10、引用的分支不存在 +15。
  4. 声明提取启发式(深度审计):文件路径按是否含 / 且以扩展名结尾并用 Glob 验证存在性;函数或类按反引号内 camelCase、PascalCase、snake_case 标识符并用 Grep 检索;URL 以 http:// 或 https:// 开头并用 curl HEAD 请求;分支按 "branch" 关键词或反引号内 git 模式并用 git branch -a 验证;包名在依赖或包上下文用清单文件检索。无法验证的通用描述应跳过。
  5. 目的地路由:价值选择写入会话项目 memory/ 目录、type=value;Claude 未来行为知识写入会话项目 memory/;每轮对话的高影响指令写入会话项目根 CLAUDE.md;人类可读笔记与决策日志写入项目根 docs/knowledge/。价值选择最持久,提取时应优先呈现。始终针对会话来源项目而非当前 shell cwd。
  6. 变更规则:索引加文件布局时,创建带前置元数据的 .md 文件并追加到 MEMORY.md;独立 MEMORY.md 时转换为索引布局;无 memory 目录时创建 memory/、MEMORY.md 与 .md 文件;前置元数据格式错误时按 type=unknown 读取,绝不破坏现有文件。
  7. 归档约定:保存在 memory/archive/ 子目录,文件保持完整,归档时从 MEMORY.md 移除条目,iter_memories() 会跳过 archive/,对仪表盘、审计与 token 不可见。独立 MEMORY.md 不支持归档,可提供删除或保留;恢复需从 archive/ 手动移回并重新加入 MEMORY.md。

限制:资料未提供安装命令、收费信息与平台要求。