adk-memory-curator

Goal

• 周期性整理可持久化知识源，区分 stable memory、project rule、archive-only 和 noise。
• 生成可审查候选，而不是直接写长期记忆。

Prerequisites

• 用户要求整理、审计、清理或提升记忆。
• 已确认读取范围和禁止路径。
• 已明确输出是报告、候选，还是后续人工确认后的写入任务。

Workflow

1. 盘点来源：memories、AGENTS、archive、session wrap、daily summary、research note、decision record。
2. 去噪脱敏：移除 secrets、完整聊天、临时日志、一次性 TODO 和过期状态。
3. 分类：personal preference、project fact、workflow rule、lesson、archive-only、drop。
4. 冲突检查：标记 stale、duplicate、supersedes、conflicts_with。
5. 生成候选：每条含 scope、risk、confidence、evidence、last_verified、write_route。
6. 人工门禁：高风险候选必须 requires_user_confirmation。
7. 维护报告：输出 promotion_candidates、stale_active、duplicate_groups、contradictions、missing_evidence、suggested_docs、archive_only_items、drop_or_review_items。
8. 失败回放：failure replay 只能生成 incident candidate；必须经过证据、冲突和 owner review 后才可 promotion。
9. 输出报告：只给建议和候选，不直接写 memory。

Commands

rtk rg -n "memory|candidate|AGENTS|archive|decision|lesson" <repo>
rtk rg -n "api[_-]?key|token|secret|password|PRIVATE KEY" <candidate-path>

Evidence Template

- Source Scope:
- Source Counts:
- High Signal Findings:
- promotion_candidates:
- stale_active:
- duplicate_groups:
- contradictions:
- missing_evidence:
- suggested_docs:
- Memory Candidates:
  | Scope | Candidate | Evidence | Raw Evidence | Risk | Confidence | Write Route | contradiction_status |
  |---|---|---|---|---|---|---|---|
- Archive-only Items:
- Drop/Review Items:
- Gate Result: pass / needs-fix

Quality Gate

• 候选必须说明“下次同类任务为何会用到”。
• active memory 候选必须至少包含一个 evidence/raw_evidence path；缺证据只能进入 missing_evidence。
• contradictions 命中时必须进入 conflict_review，不得直接晋升。
• failure replay 产生的结论先作为 incident candidate，不能直接写长期 memory。
• 不得保存完整聊天记录、密钥、隐私原文或一次性噪声。
• 写入长期 memory 前必须有人工确认和回滚路径。