Back to search
memory-recon
SkillWorks with Claude CodeGitHub
给 agent 会话库做记忆对账——从历史对话里抽出用户拍过板、说过"记住"的决定,逐条核到记忆库和文档,输出"聊过但没落盘"的清单。用于迁移前后对账、每月复盘、接手别人的 workspace、清理长期 agent 的记忆债。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/istoolsfox--memory-recon)HTML
<a href="/listings/istoolsfox--memory-recon"><img src="/api/listings/istoolsfox--memory-recon/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
放到你的技能目录即可,任选其一:
git clone https://github.com/istoolsfox/memory-recon.git ~/.agents/skills/memory-recon # 或 git clone https://github.com/istoolsfox/memory-recon.git ~/.claude/skills/memory-recon
零依赖,Python 3.8+,只用标准库。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 124 lines
- ---
- name: memory-recon
- description: 给 agent 会话库做记忆对账——从历史对话里抽出用户拍过板、说过"记住"的决定,逐条核到记忆库和文档,输出"聊过但没落盘"的清单。用于迁移前后对账、每月复盘、接手别人的 workspace、清理长期 agent 的记忆债。
- ---
- # 记忆对账(memory-recon)
- > 会话里说过、但没落成文件的东西,等于没记住。
- ## 什么时候用
- - 把一个 agent 从 A 产品迁到 B 产品,想知道"哪些东西没带过来"
- - 每月做一次复盘,清理"我记得跟它说过"的账
- - 接手别人的 workspace,先摸清哪些决定有据可查
- - 长期 agent 越用越糊涂,怀疑记忆里全是过期结论
- ## 三个前提
- 1. **只读。** 不修改会话库,不自动写记忆。所有判定由人来做。
- 2. **结论丢不了,过程最容易丢。** 用户拍板时通常会补一句"记住",模型就写了记忆;但用户问"流程是什么"时,回答只活在那一轮对话里。所以候选里要优先看带步骤的。
- 3. **覆盖度是线索,不是结论。** 脚本只能告诉你"这条可能没落盘",不能替你判断值不值得记。
- ## 四步
- ### 第 1 步:定位会话库
- 常见位置:
- | 产品 | 路径 | 结构 |
- |---|---|---|
- | ZCode | `~/.zcode/cli/db/db.sqlite` | `session` / `message` / `part` 三张表 |
- | 自建 / 导出 | `*.jsonl` | 每行 `{"ts": ..., "text": ...}` |
- ZCode 的正文不在 `message` 里,在 `part.data` 这个 JSON 的 `$.text`;真人输入靠 `message.data like '%real_user%'` 筛。时间戳是毫秒。
- 先确认能读:
- ```bash
- sqlite3 ~/.zcode/cli/db/db.sqlite ".tables"
- sqlite3 ~/.zcode/cli/db/db.sqlite "select count(*) from part;"
- ```
- ### 第 2 步:抽候选
- ```bash
- python3 scripts/recon.py \
- --db ~/.zcode/cli/db/db.sqlite \
- --memory ~/workspace/.dsh/memory \
- --memory ~/workspace/AGENTS.md \
- --out report.md \
- --dump-json candidates.json
- ```
- 参数:
- | 参数 | 作用 |
- |---|---|
- | `--db` | ZCode 的 sqlite,只读打开 |
- | `--jsonl` | 通用会话文件,可和 `--db` 同时给 |
- | `--memory` | 记忆目录或单个文件,可重复 |
- | `--since` | 只看某天之后,`YYYY-MM-DD` |
- | `--top` | 报告最多列多少条,默认 80 |
- | `--include-tasks` | 把 Agent 任务书也纳入(默认跳过) |
- 脚本干三件事:按决策词表筛候选 → 抽英文实体算覆盖率 → 按"覆盖低优先"排序出报告。
- ### 第 3 步:人工判定(核心,不能省)
- 从上往下看,每条问三句:
- 1. **下次会话还会不会用到?** 不会 → 一次性资料,跳过。
- 2. **这是结论还是过程?** 过程(多步流程、判据、验证方法)优先级最高,因为它最不容易被写下来。
- 3. **能不能指到具体文件?** 能 → 已覆盖;指不到 → 缺失。
- 四条判定:
- | 判定 | 含义 | 动作 |
- |---|---|---|
- | 已覆盖 | 能指到记忆/文档的具体位置 | 不动 |
- | 部分覆盖 | 同主题有,但这条决定没有 | 补一句 |
- | 缺失 | 完全没有 | 写一篇记忆 |
- | 一次性 | 下次不会再用 | 跳过 |
- ### 第 4 步:落盘
- 只补过程,不重复搬事实。写进记忆库后记得加索引;有项目目录的写进项目记忆,别全塞主库。
- ## 什么值得记
- | 类型 | 例子 | 记不记 |
- |---|---|---|
- | 长期规则 | "以后写代码都按这个风格" | 记 |
- | 流程方法 | "修 bug 分六个阶段" | 记,且最优先 |
- | 判据 | "AI 政策红区:pallets 见即关" | 记 |
- | 环境事实 | 服务器端口、SSH 别名 | 记(会反复用) |
- | 临时链接 | 某篇文章、某个网站 | 不记 |
- | 一次性结论 | 某次任务的中间数 | 不记 |
- 判据只有一条:**下次会话还会不会用到。**
- ## 脚本输出长什么样
- ```markdown
- | 日期 | 会话 | 摘要 | 覆盖 |
- |---|---|---|---|
- | 2026-09-11 | GitHub修Bug流程探讨 | 你现在修bug的流程是什么… | 0.00 |
- ```
- - `覆盖 0.00`:候选里的英文实体一个都没在记忆里出现,**最可疑**
- - `覆盖 1.00`:实体全出现,多半已覆盖,但仍要人工确认是不是同一条决定
- - `—`:没有英文实体(纯中文),脚本判不了,只能人看
- ## 已知坑
- 1. **中文实体判不了。** 覆盖率只认英文/数字 token。"奶绵羊每栏平均泌乳量"这种会显示 0.00,其实早记过了。看到 0.00 先人工确认,别直接判缺失。
- 2. **任务书会污染候选。** 长任务提示词里常带"必须/禁止",会被当成决定。脚本默认按开头过滤("你是/你在/研究任务/任务:…"),漏网的用 `--top` 控制。
- 3. **时间戳单位不统一。** 秒、毫秒、微秒都有,脚本按量级自动换算;自己写 SQL 时注意。
- 4. **大库也能全量扫。** 1.5G、3300 条输入的库,LIKE 全表约 3 秒,不用分页。
- 5. **别把报告当结论。** 报告只是待办清单,判定完要写回记忆库,否则下次还得再扫一遍。
- ## 配套
- - 方法细节与一次真实对账的战绩:`references/method.md`
- - 脚本:`scripts/recon.py`(零依赖,Python 3.8+)
README.md · README · 81 lines
- # memory-recon
- 给 agent 的会话库做**记忆对账**:把"聊过、但没落成文件"的决定找出来。
- > 迁移搬得走文件,搬不走对话。
- ## 它解决什么问题
- agent 用了几个月,记忆文件几百个,看着挺全。但总有些东西你记得说过、就是搜不到。
- 原因不复杂:**结论会被写下来,过程不会。**
- 你拍板时说一句"记住",模型就写一篇记忆;你问"流程是什么",它答一篇,你点头,然后这段就只活在对话里了。换产品、换机器、清会话,全都丢。
- 这个技能干一件事:扫会话库 → 抽候选 → 核到记忆库 → 输出缺失清单。
- ## 安装
- 放到你的技能目录即可,任选其一:
- ```bash
- git clone https://github.com/istoolsfox/memory-recon.git ~/.agents/skills/memory-recon
- # 或
- git clone https://github.com/istoolsfox/memory-recon.git ~/.claude/skills/memory-recon
- ```
- 零依赖,Python 3.8+,只用标准库。
- ## 用法
- ```bash
- python3 scripts/recon.py \
- --db ~/.zcode/cli/db/db.sqlite \
- --memory ~/workspace/.dsh/memory \
- --memory ~/workspace/AGENTS.md \
- --out report.md
- ```
- 输出:
- ```markdown
- | 日期 | 会话 | 摘要 | 覆盖 |
- |---|---|---|---|
- | 2026-09-11 | GitHub修Bug流程探讨 | 你现在修bug的流程是什么… | 0.00 |
- | 2026-09-23 | 查询语音识别资源包 | 以后记住,播放视频不要出声… | 1.00 |
- ```
- `覆盖` 是候选里的英文实体在记忆库里出现的比例。0.00 最可疑,但要人工确认——中文主题会被误判。
- 支持两种数据源:
- - `--db`:ZCode 的 `db.sqlite`(只读)
- - `--jsonl`:任意会话导出,每行 `{"ts": ..., "text": ...}`
- ## 怎么判定
- 每条候选问两个问题:
- 1. 下次会话还会不会用到?
- 2. 这是结论,还是过程?
- 过程类(多步流程、判据、验证方法)优先级最高,因为它最不容易被写下来。
- 四种结果:已覆盖 / 部分覆盖 / 缺失 / 一次性。
- ## 实测
- 790 个会话、3279 条真人输入、451 条决策候选,全量扫完约 3 秒。一次真实对账里,25 条长期决定有 1 条完全缺失——正好是一套只在对话里讲过的流程。
- 细节见 [`references/method.md`](references/method.md)。
- ## 局限
- - 覆盖率只认英文/数字实体,纯中文主题会漏判
- - 找不出"从没提过要记住"的隐性知识
- - 只回答"有没有",不回答"还对不对"
- - 扫不了没留存的对话
- ## 许可
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.