智能体记忆写入防污染工作流

智能体记忆写入防污染工作流

4个实用技能 · 4步完成 · 每一步都能单独使用

面向把长期记忆写入智能体系统前的离线审计：先形成写入契约，再核验来源和授权，接着检查变更链与隔离条件，最后输出人工放行材料；全程不连接记忆库、不执行写入，也不把审计通过冒充为真实业务结果。

4个可下载技能 · 每个技能可单独运行

4步自动化工作流

🔵 1 写入事件契约整理

技能文件：agent-memory-write-normalizer

解决什么： 把记忆 ID、命名空间、来源、写入主体、意图和拟议动作整理为稳定的写入契约，先发现缺字段和非法动作。

What you get: memory-write-contract.json、契约哈希、缺失字段清单，以及固定为 false 的 write_allowed。

↓ 本步结果自动进入下一步

🟢 2 写入来源与授权核验

技能文件：agent-memory-provenance-auditor

解决什么： 核对来源可信度、写入主体是否获授权、内容是否带有指令式文本、是否有独立佐证。

What you get: memory-provenance-report.json，清楚列出 PROVENANCE_RISK 或 PASS 和对应原因。

↓ 本步结果自动进入下一步

🟠 3 记忆变更链与隔离核验

技能文件：agent-memory-mutation-quarantine-auditor

解决什么： 检查 append-only 边界、父记忆引用、替换或更正理由，并把不可信或指令式内容标为隔离复核。

What you get: memory-mutation-report.json、变更哈希和 quarantine_required 标志，不删除原始材料。

↓ 本步结果自动进入下一步

🟣 4 记忆写入人工放行闸门

技能文件：agent-memory-write-release-gate

解决什么： 汇总前三步证据，把任一风险、缺少人工决定或不完整契约汇总成 HOLD。

What you get: memory-write-gate.json，包含人工决定、隔离要求、memory_write_allowed=false 和 external_action_executed=false 的最终材料。

↓ 本步结果形成最终交付

实际示例

脱敏样例提出把一条来自未验证工单的偏好追加到 team-demo 命名空间。第一步得到 READY 契约；第二步因 source_trust=untrusted、actor_authorized=false、instruction_like=true 且没有独立佐证而输出 PROVENANCE_RISK；第三步因 append_only=false、缺少 parent_memory_id 和不可信来源而输出 QUARANTINE_REVIEW；第四步在 human_decision=PENDING 下输出 READY_FOR_HUMAN_REVIEW、quarantine_required=true。该结果是本地测试事实，不代表任何真实客户成果。

适合谁

• 维护长期记忆、用户偏好或团队知识的智能体工程师

• 需要在写入前做来源和授权复核的 Agent 平台团队

• 做 AI 安全评估、红队复盘或数据治理的技术负责人

• 希望把记忆污染风险变成可审计 JSON 的个人开发者

买家只需提供

• 脱敏的待写入 JSON，包含 memory_id、namespace、source_ref 和 proposed_action

• 允许的来源可信度、写入主体授权和独立佐证规则

• append-only、父记忆、替换或更正理由以及人工放行要求

使用方式

1. 解压四个技能目录，使用 Python 3.10 或更高版本。

2. 依次运行每个 scripts 目录中的执行器，把上一步 JSON 路径传给下一步；最终保持 human_decision=PENDING 直到人工确认。

3. 在测试环境检查 status、reasons、哈希和不可写入标志，再决定是否把结果交给现有治理系统；本包不会替你写入记忆库。

交付与验收

• 四个独立技能目录，含 _meta.json、agents/openai.yaml、SKILL.md、README.md、scripts 和脱敏 examples。

• 用样例运行后，标准链路应得到 READY、PROVENANCE_RISK、QUARANTINE_REVIEW 和 READY_FOR_HUMAN_REVIEW；输出均带 schema、哈希和 false 写入标志。

• 缺字段、JSON 错误或规则失败时保留原材料并返回可定位 reasons；不会自动删除、覆盖或执行外部动作。

• 不包含记忆数据库接入、账号、密钥、模型额度、云端监控、自动写入或人工安全评估服务。

服务说明

本包是离线 JSON 审计工具，依赖 Python 标准库，不读取网络或真实用户记忆。字段规则需要按买家的权限模型、命名空间和保留政策自行配置；输出是人工复核材料，不是合规认证、绝对安全保证或零误报承诺。不会替买家绕过权限、验证码、审核或平台风控，也不承诺收入、销量、固定节省比例或业务结果。