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。