kunchenguid/backpass

解决的问题

backpass 是一个旨在自动改进 AI 代理记忆文件（如 AGENTS.md 或 CLAUDE.md）和项目技能的工具。它解决了「过时」的代理指令问题——这些指令仅在人类回忆起失败后手动更新。通过将代理会话视为「损失信号」，它能基于真实世界使用记录，识别出指令被忽略、造成伤害或存在缺失的地方。

工作原理

该工具采用「梯度下降」的隐喻来优化记忆：

1. 收集：直接从磁盘读取来自各种代理工具（如 Claude Code、Codex、Cursor CLI）的本地会话记录，不使用 API，也不上传数据。
2. 提炼：原始会话记录被压缩 96–99%，去除工具调用噪声，仅保留关键的用户/助手对话和脱敏的敏感信息。
3. 损失计算：低成本模型分析提炼后的记录样本（按时间加权），识别出哪些指令有帮助、哪些被违反，以及当前指令未覆盖的错误。
4. 聚合：证据按指令分组。每个建议的修改（添加、重写、删除）必须至少有来自两个不同会话的证据，以防止噪声导致误改。
5. 人工审核：该工具不会自动写入文件。用户必须运行 backpass apply，在接受或拒绝前查看每个建议修改及其支持的原始引文。

适用人群

依赖项目特定记忆文件或技能集来维持会话间上下文和一致性的 AI 编码代理使用者。

特点

• 本地优先：会话记录直接从磁盘读取；工具本身无需外部 API 密钥（使用用户现有的 acpx 认证）。
• 证据驱动：每个建议的更改都有来自真实会话的原始引文支持。
• 人工在环：所有更改均需人工审核流程确认。
• 多工具支持：兼容七种不同的代理会话存储，包括 Claude Code 和 Cursor CLI。