技能介绍

要解决的具体问题

随着项目推进，/.workbuddy/memory/MEMORY.md 和用户级 ~/.workbuddy/MEMORY.md 会不断膨胀，引发两个双向结构性问题：

通用教训被困在项目里：大量跨项目的通用工具、语言、平台行为教训只躺在工作区文件中，导致新项目完全用不到。
注入截断红线：会话记忆存在硬性字符上限，超限时尾部内容会被静默截断。实测 22KB 的全局记忆在注入时被砍尾并出现 (user memory truncated) 提示，导致下次会话丢失上下文。

旧版技能往往只做单向搬运，结果只是把截断问题从工作区挪到了全局，治标不治本。

核心能力与工作流

该技能采用双向治理机制，通过纯流程型工作流自动维护两层记忆的平衡：

只读审计与分类：运行 scripts/scan_memory.py 进行初审。按信号将工作区教训判为 GLOBAL（全局通用）或 PROJECT（项目专属），自动剔除 STRUCTURAL 结构段，并对重复项标记 [DUP] 保证幂等。
上提与瘦身：跨项目通用的教训上提至用户级记忆并续编编号；每条教训要求自包含。工作区仅保留项目专属内容，并在顶部留指针指向全局。
全局自管理（防自身截断）：当全局记忆超阈值时执行治理。

- Mode A（原地压缩）：保留单文件，按压缩四原则将段落压成「标题+一句话核心」，删去过期待办与冗余叙述。
- Mode B（拆子文件）：若远超阈值，用 scripts/condense_global.py 生成薄索引并把详细展开移入 ~/.workbuddy/lessons/ 子文件，按需 Read 取回。

工作区日志轮转与台账：受控轮转超 30 天且已蒸馏的日志，通过顶部主题索引治理活跃日志膨胀；读取并回显 ## OPEN 决策/待办台账，解决“已解决却挂起”的漏问问题。

适用边界与注意点

只读脚本与人工确认：scan_memory.py 与 prune_workspace.py 严格遵守只读原则，仅输出提案或待办清单。任何写操作或删除均由 AI 在用户显式确认后执行，贯彻 human-in-the-loop。
绝对的备份防线：改写全局记忆或受控删除工作区日志前，必须先备份至 ~/.workbuddy/_trash_memory_*.md，确认成功后方可动笔。
阈值属于经验值：默认 5KB 截断阈值为保守治理线，并非文档精确上限。可通过参数调整，但始终保持安全余量。
模式选择依赖实际情况：Memory Mode B 拆分需要改写大文件，虽然提供了助手脚本降低手动重写的出错率，但最终落盘仍需 AI 仔细核对提案，以防跨文件引用断裂。