Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/istoolsfox--memory-recon/badge.svg)](/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
  1. ---
  2. name: memory-recon
  3. description: 给 agent 会话库做记忆对账——从历史对话里抽出用户拍过板、说过"记住"的决定,逐条核到记忆库和文档,输出"聊过但没落盘"的清单。用于迁移前后对账、每月复盘、接手别人的 workspace、清理长期 agent 的记忆债。
  4. ---
  5. # 记忆对账(memory-recon)
  6. > 会话里说过、但没落成文件的东西,等于没记住。
  7. ## 什么时候用
  8. - 把一个 agent 从 A 产品迁到 B 产品,想知道"哪些东西没带过来"
  9. - 每月做一次复盘,清理"我记得跟它说过"的账
  10. - 接手别人的 workspace,先摸清哪些决定有据可查
  11. - 长期 agent 越用越糊涂,怀疑记忆里全是过期结论
  12. ## 三个前提
  13. 1. **只读。** 不修改会话库,不自动写记忆。所有判定由人来做。
  14. 2. **结论丢不了,过程最容易丢。** 用户拍板时通常会补一句"记住",模型就写了记忆;但用户问"流程是什么"时,回答只活在那一轮对话里。所以候选里要优先看带步骤的。
  15. 3. **覆盖度是线索,不是结论。** 脚本只能告诉你"这条可能没落盘",不能替你判断值不值得记。
  16. ## 四步
  17. ### 第 1 步:定位会话库
  18. 常见位置:
  19. | 产品 | 路径 | 结构 |
  20. |---|---|---|
  21. | ZCode | `~/.zcode/cli/db/db.sqlite` | `session` / `message` / `part` 三张表 |
  22. | 自建 / 导出 | `*.jsonl` | 每行 `{"ts": ..., "text": ...}` |
  23. ZCode 的正文不在 `message` 里,在 `part.data` 这个 JSON 的 `$.text`;真人输入靠 `message.data like '%real_user%'` 筛。时间戳是毫秒。
  24. 先确认能读:
  25. ```bash
  26. sqlite3 ~/.zcode/cli/db/db.sqlite ".tables"
  27. sqlite3 ~/.zcode/cli/db/db.sqlite "select count(*) from part;"
  28. ```
  29. ### 第 2 步:抽候选
  30. ```bash
  31. python3 scripts/recon.py \
  32. --db ~/.zcode/cli/db/db.sqlite \
  33. --memory ~/workspace/.dsh/memory \
  34. --memory ~/workspace/AGENTS.md \
  35. --out report.md \
  36. --dump-json candidates.json
  37. ```
  38. 参数:
  39. | 参数 | 作用 |
  40. |---|---|
  41. | `--db` | ZCode 的 sqlite,只读打开 |
  42. | `--jsonl` | 通用会话文件,可和 `--db` 同时给 |
  43. | `--memory` | 记忆目录或单个文件,可重复 |
  44. | `--since` | 只看某天之后,`YYYY-MM-DD` |
  45. | `--top` | 报告最多列多少条,默认 80 |
  46. | `--include-tasks` | 把 Agent 任务书也纳入(默认跳过) |
  47. 脚本干三件事:按决策词表筛候选 → 抽英文实体算覆盖率 → 按"覆盖低优先"排序出报告。
  48. ### 第 3 步:人工判定(核心,不能省)
  49. 从上往下看,每条问三句:
  50. 1. **下次会话还会不会用到?** 不会 → 一次性资料,跳过。
  51. 2. **这是结论还是过程?** 过程(多步流程、判据、验证方法)优先级最高,因为它最不容易被写下来。
  52. 3. **能不能指到具体文件?** 能 → 已覆盖;指不到 → 缺失。
  53. 四条判定:
  54. | 判定 | 含义 | 动作 |
  55. |---|---|---|
  56. | 已覆盖 | 能指到记忆/文档的具体位置 | 不动 |
  57. | 部分覆盖 | 同主题有,但这条决定没有 | 补一句 |
  58. | 缺失 | 完全没有 | 写一篇记忆 |
  59. | 一次性 | 下次不会再用 | 跳过 |
  60. ### 第 4 步:落盘
  61. 只补过程,不重复搬事实。写进记忆库后记得加索引;有项目目录的写进项目记忆,别全塞主库。
  62. ## 什么值得记
  63. | 类型 | 例子 | 记不记 |
  64. |---|---|---|
  65. | 长期规则 | "以后写代码都按这个风格" | 记 |
  66. | 流程方法 | "修 bug 分六个阶段" | 记,且最优先 |
  67. | 判据 | "AI 政策红区:pallets 见即关" | 记 |
  68. | 环境事实 | 服务器端口、SSH 别名 | 记(会反复用) |
  69. | 临时链接 | 某篇文章、某个网站 | 不记 |
  70. | 一次性结论 | 某次任务的中间数 | 不记 |
  71. 判据只有一条:**下次会话还会不会用到。**
  72. ## 脚本输出长什么样
  73. ```markdown
  74. | 日期 | 会话 | 摘要 | 覆盖 |
  75. |---|---|---|---|
  76. | 2026-09-11 | GitHub修Bug流程探讨 | 你现在修bug的流程是什么… | 0.00 |
  77. ```
  78. - `覆盖 0.00`:候选里的英文实体一个都没在记忆里出现,**最可疑**
  79. - `覆盖 1.00`:实体全出现,多半已覆盖,但仍要人工确认是不是同一条决定
  80. - `—`:没有英文实体(纯中文),脚本判不了,只能人看
  81. ## 已知坑
  82. 1. **中文实体判不了。** 覆盖率只认英文/数字 token。"奶绵羊每栏平均泌乳量"这种会显示 0.00,其实早记过了。看到 0.00 先人工确认,别直接判缺失。
  83. 2. **任务书会污染候选。** 长任务提示词里常带"必须/禁止",会被当成决定。脚本默认按开头过滤("你是/你在/研究任务/任务:…"),漏网的用 `--top` 控制。
  84. 3. **时间戳单位不统一。** 秒、毫秒、微秒都有,脚本按量级自动换算;自己写 SQL 时注意。
  85. 4. **大库也能全量扫。** 1.5G、3300 条输入的库,LIKE 全表约 3 秒,不用分页。
  86. 5. **别把报告当结论。** 报告只是待办清单,判定完要写回记忆库,否则下次还得再扫一遍。
  87. ## 配套
  88. - 方法细节与一次真实对账的战绩:`references/method.md`
  89. - 脚本:`scripts/recon.py`(零依赖,Python 3.8+)
README.md · README · 81 lines
  1. # memory-recon
  2. 给 agent 的会话库做**记忆对账**:把"聊过、但没落成文件"的决定找出来。
  3. > 迁移搬得走文件,搬不走对话。
  4. ## 它解决什么问题
  5. agent 用了几个月,记忆文件几百个,看着挺全。但总有些东西你记得说过、就是搜不到。
  6. 原因不复杂:**结论会被写下来,过程不会。**
  7. 你拍板时说一句"记住",模型就写一篇记忆;你问"流程是什么",它答一篇,你点头,然后这段就只活在对话里了。换产品、换机器、清会话,全都丢。
  8. 这个技能干一件事:扫会话库 → 抽候选 → 核到记忆库 → 输出缺失清单。
  9. ## 安装
  10. 放到你的技能目录即可,任选其一:
  11. ```bash
  12. git clone https://github.com/istoolsfox/memory-recon.git ~/.agents/skills/memory-recon
  13. # 或
  14. git clone https://github.com/istoolsfox/memory-recon.git ~/.claude/skills/memory-recon
  15. ```
  16. 零依赖,Python 3.8+,只用标准库。
  17. ## 用法
  18. ```bash
  19. python3 scripts/recon.py \
  20. --db ~/.zcode/cli/db/db.sqlite \
  21. --memory ~/workspace/.dsh/memory \
  22. --memory ~/workspace/AGENTS.md \
  23. --out report.md
  24. ```
  25. 输出:
  26. ```markdown
  27. | 日期 | 会话 | 摘要 | 覆盖 |
  28. |---|---|---|---|
  29. | 2026-09-11 | GitHub修Bug流程探讨 | 你现在修bug的流程是什么… | 0.00 |
  30. | 2026-09-23 | 查询语音识别资源包 | 以后记住,播放视频不要出声… | 1.00 |
  31. ```
  32. `覆盖` 是候选里的英文实体在记忆库里出现的比例。0.00 最可疑,但要人工确认——中文主题会被误判。
  33. 支持两种数据源:
  34. - `--db`:ZCode 的 `db.sqlite`(只读)
  35. - `--jsonl`:任意会话导出,每行 `{"ts": ..., "text": ...}`
  36. ## 怎么判定
  37. 每条候选问两个问题:
  38. 1. 下次会话还会不会用到?
  39. 2. 这是结论,还是过程?
  40. 过程类(多步流程、判据、验证方法)优先级最高,因为它最不容易被写下来。
  41. 四种结果:已覆盖 / 部分覆盖 / 缺失 / 一次性。
  42. ## 实测
  43. 790 个会话、3279 条真人输入、451 条决策候选,全量扫完约 3 秒。一次真实对账里,25 条长期决定有 1 条完全缺失——正好是一套只在对话里讲过的流程。
  44. 细节见 [`references/method.md`](references/method.md)。
  45. ## 局限
  46. - 覆盖率只认英文/数字实体,纯中文主题会漏判
  47. - 找不出"从没提过要记住"的隐性知识
  48. - 只回答"有没有",不回答"还对不对"
  49. - 扫不了没留存的对话
  50. ## 许可
  51. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.