本象记忆状态持久化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_abeb50e0/benxiang-memory。
技能介绍
聊天记录不该承担状态职责
一次长会话快结束时,最近几轮被不断摘要,项目到底卡在哪一步反而很难回答;新会话开始,还得靠翻记录重新拼上下文。问题不在于窗口小,而在于把对话当作了项目状态。对话本应是操作窗口:查看、修改、决策,用完即走。真正需要留住的是结论:谁定的、依据是什么、当前有效值是什么、下一步归谁。
用投影读状态,用事务提交
Shadow Memory 不把聊天内容收进持久层,而是把可确认的世界状态存成结构化对象。状态本身有独立的生命周期与约束。
项目状态分为 decision、task、risk、fact、module 五类对象,并设有六条机器可判定的约束:
- decision/task/risk 的
status只能取合法值,否则拒绝写入; decision必须写明理由(reason),没有理由的决策后续无法复盘;- 每个
task必须有负责人,责任写在状态里而不是口头里; - 每条
fact必须带证据引用,事实与推断分离; - 新建 key(key 由id字段组成,需确认)必须显式声明类型,对空值防御——像影子一样凭空出现的“幽灵对象”所造成的轰动影响将是时间上的,且无法被
origin_why查到责任人,因为自动生成的 key 并没有与检查绑定。约束与拦截是这套状态机的本体,不是为了好看。
配合五个工具:
origin_state:开始工作前取一份投影,返回的是当前状态,不是聊天记录;origin_commit:每完成一个有结论的动作提交一次,校验失败则零字节写入并返回可据以修正的原因;origin_why:汇报某个数字、质疑当前值时,查完整变更链与责任者;origin_history:最近改了什么、谁动过;origin_diagnose:把约束违例、悬空引用、重复账本等结构性问题一次摆出来。
验证与边界
e2e.mjs 原样打印每次请求与响应,包括“违规提交被拒绝且零字节写入”,以及两个 agent 先后改同一字段时 origin_why 能查到两次改动。
适用边界同样明确:只接收 decision、task、risk、fact、module 五类对象;聊天记录本身、临时想法、没有结论的讨论不纳入,这些属于操作窗口。如果想把所有聊天都塞进去,约束只会被绕过,状态也会退化成另一种聊天记录。状态变更与聊天过程是两条通路,不要合并。
使用场景
- 跨多个新会话继续同一项目时,用 `origin_state` 载入持久状态,而不是重读聊天记录
- 刚完成一项有结论的改动时,用 `origin_commit` 提交可被校验的事务;失败则零字节写入
- 向同事汇报当前数值或质疑某字段时,用 `origin_why` 查出完整改动链和责任人
- 状态出现悬空引用或违反约束时,用 `origin_diagnose` 定位是哪个对象出错
适合人员
- 维护跨多次对话持续演进的代码或数据项目的后端工程师,需要持久化项目状态和审计变更链
- 用 agent 管理决策、待办与风险台账的技术负责人,需要为每个决策和事实留下理由与证据
- 维护 MCP 工具或 agent 运行环境的开发者,希望状态变更通过确定性门禁、防止静默腐坏
- 参与同一项目状态的多个 agent 的开发者,需要可追责的提交与冲突诊断