myagents-memory-gardener

# MyAgents Memory Gardener 本 skill 是长期记忆机制的第二层：它不捕获当天经历，而是把已经沉淀下来的 `03-USER` / `04-MEMORY` 自动装载层修剪回可长期运行的状态。 核心判断：**遗忘是降级，不是删除。** 自动装载层只保留会影响每次会话行为的规则； 案例、项目细节、推导过程下放到 `memory/topics/`，并在自动装载层保留可召回指针。 ## 边界 - `UPDATE_MEMORY.md`：24h 捕获层，只做 session 级增量沉淀。 - `myagents-memory-gardener`：72h 整编层，只做删、下放、合并、体检。 - `myagents-memory-molt`：14d 深反层，才允许改 SOUL / 底层信念。 ## 工作流程 1. 确认当前目录是目标工作区；如需显式指定，脚本都支持 `--repo /path/to/workspace`。 2. 如果是 git 仓库，先记录工作树基线。已有的未提交改动不阻断记忆维护；保留并避开它们，只编辑本轮需要维护的记忆文件。 3. 运行 `python3 <skill>/scripts/memory_lint.py --repo <workspace>`，把 RED 作为必做议程，WARN 酌情处理。 4. 读取上次园丁运行后的日志和 topic，把可长期复用的规则留下，把故事和证据下放。 5. 对超预算自动装载层执行顺序：删过时项 -> 下放故事 -> 合并同根规则 -> 最后才新增。 6. 发现 SOUL / 底层信念问题时，只追加到 `memory/gardener/flags-for-molt.md`，不要直接改 SOUL。 7. 报告写入 `memory/gardener/YYYY-MM-DD.md`，再运行 `memory_lint.py --mark-run`。 8. 如果是 git 仓库，只暂存并提交本次记忆维护产生的改动；**不要 push**。不得暂存、覆盖或回滚基线中已有的其他改动。若同一个目标文件已有无法与本轮改动安全区分的未提交内容，保留该文件的全部改动、不把它纳入提交，并在报告中说明；继续处理和提交其他能够明确归属的文件。如果不是 git 仓库，跳过提交。 lint 全绿且没有新沉淀时，写一条空跑记录后结束。 ## 报告格式 ```markdown ## Gardener Run YYYY-MM-DD - lint: N RED / N WARN -> 处理结果各一行 - budgets: MEMORY xx.xKB / budget, USER xx.xKB / budget - operations: delete N, demote N, merge N clusters, add N - drill / flags-for-molt / deferred: <各一行；无则写无> ``` 建议 commit message： ```text memory: gardener YYYY-MM-DD ``` ## 自检 - 超预算文件净变小了吗？ - 下放内容真的落进 topic，并且自动装载层指针有效吗？ - 没有直接改 SOUL 吗？ - `flags-for-molt.md` 只放信念级问题，不放日常整理事项吗？ - 如有 git 仓库，是否保留了工作树基线中的既有改动，且提交只包含能明确归属于本轮的记忆改动、没有 push？ 具体整编手法见 [references/playbook.md](references/playbook.md)。