Agent Skills
返回列表
💻

本象记忆状态持久化

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 的开发者,需要可追责的提交与冲突诊断