event-review

Event Review —— 事件提炼与记忆升级

你是一个干净 agent：不带任何正在进行的任务上下文，只做提炼。 方法论依据：hook 只记事件不做判断；由干净 agent 定期读事件、跨时间去重归类； 人每周批量审，分流到 CLAUDE.md / L2 索引 / memory / 丢掉。

输入

• 事件日志：.agents/events/events-*.jsonl（按月，不可变）
• 水位线：.agents/events/.last-reviewed（上次审到的行号/文件名）
• 检查点：.agents/events/checkpoints/（compact 时抢救的任务状态）
• 现有条目：CLAUDE.md、AGENTS.md、.agents/INDEX.md、.agents/knowledge/、.agents/pitfalls/、.agents/runbooks/ （用来去重：已经沉淀过的不要再提）

不要读 .agents/inbox/ 之外的待审内容当成结论引用；不要读 .agents/current/（那是活跃任务，与本次提炼无关，除非它在 checkpoints 里）。

步骤

1. 读事件，归类

从水位线之后开始读。关注的事件类型：

• tool_error：同一类错误（同文件/同报错特征）出现 ≥2 次 → 候选 knowledge（坑）
• compact + checkpoint_saved：对比 checkpoint 里的 plan/notes 与最终结果，找"被压缩掉但仍有价值"的结论
• gate_block：反复被门禁拦截的同类修改 → 可能是流程问题
• stop/session_start/session_end：用于判断任务边界，本身通常无价值

2. 写候选进 inbox（只写 inbox，不直接改任何受保护文件）

每个候选一个文件：.agents/inbox/YYYY-MM-DD-<slug>.md，头部包含：

类型: pitfall | knowledge | memory | skill-draft | discard
来源: 事件日志行 / checkpoint 路径
建议去向: CLAUDE.md 第X节 | .agents/INDEX.md 坑目录 | .agents/knowledge/xxx.md | memory(feedback) | 丢掉

3. 应用三个升级阈值

信号	阈值	产出
同类失败重复	≥2 次	候选 knowledge（写 inbox）
用户重复说同样的话	第 2 次	memory（feedback 类型，写入项目 memory）
同一流程成功	3 次	skill 草稿提议（只提议，绝不自动安装）

• memory 写入：项目 memory（Claude Code 项目级 memory，feedback 类型；路径可用 /memory 查看）。memory 的写入不需要门禁（它是 agent 自己的笔记），但内容必须只关于"这个 agent 怎么干活"。
• knowledge / pitfall / runbook / skill：一律先进 inbox，等用户审。

4. 陪同用户周审（逐条过）

对每个 inbox 条目，向用户说明：内容、来源证据、建议去向，请用户三选一：

1. 收：按去向落盘 ——
   • 写 CLAUDE.md / .agents/INDEX.md / .agents/gate.conf / skills / settings 会触发门禁：先征得用户同意，touch <项目根>/.claude/.gate-token，再写入（令牌一次性）。
   • 落盘后从 inbox 删除该条目，并在来源知识文件的"升级记录"打勾。
2. 改：按用户意见修改后再落盘。
3. 丢：删除条目（大多数候选应该被丢掉，这是正常的）。

5. 收尾

• 更新 .agents/events/.last-reviewed（记录已审到的事件文件与行号）。
• 向用户汇报：收了 N 条 / 丢了 M 条 / 待跟进事项。

纪律

• 跨时间去重优先于收录：同一个坑第二次出现时合并进已有条目，不新建。
• 拿不准就标"存疑"留待下次，不要强行下结论。
• 一次只审一周的量；事件太多时分批，不要一口气吞完撑爆上下文。