second-brain-distill
Skill3 starsChanged 3 months agoMITView on GitHub
把选定的历史 AI Agent 对话完整榨取为可长期保存的规则、知识、Agent 配置、Skills、项目经验、山脉证据和晋升附件;只有恢复性与完整性门禁通过后,才删除明确 allowlist 中的原始批次。用户要求挖掘、榨取、归档、压缩、清理或删除旧 Agent 对话,同时保留其中全部有价值信息,或提到历史对话数据挖掘、SkillOpt 理念时使用。
In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- mcp/AGENTS.mdAGENTS.md
- vault/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- mcp/CLAUDE.mdCLAUDE.md
- vault/CLAUDE.mdCLAUDE.md
- capture-knowledgeSkill
- second-brain-attachSkill
- second-brain-climbSkill
- second-brain-doctorSkill
- second-brain-helpSkill
- second-brain-learnSkill
- second-brain-syncSkill
The file
Files
Second Brain - Distill(榨取历史对话并清理原始数据)
把历史对话当作一次性矿石:完整榨取可复用信息,验证沉淀物和附件后,才处理用户明确授权的原始批次。SkillOpt 只贡献“从历史 Agent 轨迹中挖掘改进”的理念;不要运行它的程序、Sleep 循环、评分数据库、外部推理 API 或自动优化器。
显式调用
- Codex:
$second-brain-distill,或从/skills选择。 - Claude、Hermes、AntiGravity:
/second-brain-distill。
硬边界
以下对象不进入本 Skill 的处理批次,也不得借本 Skill 删除:
- 当前仍在活动的会话、当前会话本身及任何正在写入的会话数据库。
- replay、evaluator、grader、optimizer、learning-loop、benchmark 或测试派生对话。
- 无法稳定识别父子关系、导出完整性或附件归属的会话。
- 含未识别凭据、权限或受监管数据,且尚无安全处置方案的会话。
原始对话和导出包不得提交到任何 Git remote。只有经过最小披露、去秘密、可审计的长期 owner 与 receipt 才能进入本地 authority 历史;private-remote 可再提交到私有 Vault 仓库,公开 Release remote 永远不得接收个人数据。
删除授权
删除必须有精确 allowlist。一个合规条目至少含:平台、稳定 conversation ID 或绝对路径、内容 SHA-256、附件清单、快照时间和用户授权来源。
- 用户明确指定批次并要求“完整榨取后删除”时,这一授权覆盖门禁通过后的 allowlist 条目,不必形式主义地重复询问。
- 若只说“清理旧对话”而没有可解析范围,先输出候选清单并询问,不擅自扩大到所有历史。
- 即使已授权,任一完整性、附件、秘密、写入或恢复门禁失败,也停止该条删除;不以部分成功掩盖失败。
这里的“删除”首先指从宿主活动存储中移除,从而释放正常会话与附件占用;平台归档若仍完整保留同等存储,不算完成删除。用户明确指定批次并要求“完整榨取后删除”时,在恢复门禁通过后,该授权已经覆盖对精确 allowlist 的物理删除,不必再次逐条询问;平台或文件系统支持系统废纸篓、可恢复删除时优先使用。只有用户只说“归档/整理”而没有要求删除,或产品只提供不可恢复删除且当前授权并未包含删除时,才停下确认。无论使用哪种机制,都必须如实报告活动存储是否释放、数据是否仍可恢复以及恢复位置。
完整榨取流程
1. 冻结批次
- 用平台导出、官方 CLI 或本地只读数据库快照获取原始内容;不要在活动数据库上边读边删。
- 建 manifest:每个父会话、子会话、消息数、时间范围、附件、字节数和 SHA-256。
- 按 durable value 分类:高价值主会话、普通工作会话、低价值噪声、派生测试会话。分类影响提炼深度,不自动产生删除权。
- 把当前活动、replay/evaluator 等禁止对象从 manifest allowlist 中剔除并记录原因。
2. 读取完整证据
不要只读标题、摘要或最后一条消息。逐会话覆盖:
- 用户原始目标、约束和后续纠正。
- Agent 的关键判断、工具调用证据和实际产物。
- 尝试过但失败的路径、失败原因与防复发条件。
- 已完成的决策、待办、未解决不确定性和外部依赖。
- 文件、图片、表格、代码、报告等附件的实际内容与版本关系。
- 子 Agent 结果与父会话如何采纳或否决它们。
3. 形成原子候选
把内容拆到最窄 owner:
- 通用偏好 → COMMON-RULES。
- Agent 分工 → 对应 profile。
- 可复用流程 → 对应 Second Brain Skill 或项目 Skill。
- 客观知识、洞见、个人事实 → canonical。
- 项目决策和失败教训 → 项目 authority。
- 长期目标的进展、证据或路线变化 → mountain。
- 仅有历史价值但不进入主图谱 → 日期化来源或审计 receipt。
- 无持久价值 → 明确
discarded-as-noise。
每个候选保留来源 conversation ID、消息定位或导出偏移、证据强度、隐私级别和目标 owner。查重后优先更新既有 owner;禁止“一次会话一张大卡”。
4. 处理附件
删除原始会话前逐个附件裁决:
- 唯一且有长期价值:先晋升到所属项目 Inbox/权威来源层,保留原文件名、SHA、来源会话和字节级验证。
- 已有相同权威副本:用 SHA 证明完全重复,receipt 指向现有 owner。
- 可再生临时产物:记录生成依据和丢弃理由。
- 未知或无法读取:阻断该会话删除,不猜测。
附件晋升不是把所有文件塞进 Second Brain;应进入最窄项目 authority,Vault 只保留必要的来源关系和摘要。
5. 风险裁决与写入
复用 second-brain-learn 的风险边界:低风险、证据充分的偏好和普通进展可自动合并;权限、隐私、核心身份、角色重分配、summit 变化和冲突证据先问用户。
按 Vault 或目标项目的事务规则串行写入,完成查重、来源、关系、原子性、freshness、privacy、LOG 与门禁。authority 变化先走本地短任务分支;private-remote 才经私有 origin PR 汇合,local-only 保留本地 commit 与备份。原始导出、凭据和未脱敏附件永远不暂存。
6. 生成删除 receipt
每个 allowlist 条目在删除前生成 receipt,至少包含:
- 原始标识、SHA、消息/附件计数和导出快照。
- 产生或更新的 owner、commit/PR 和对应证据定位。
- 每个附件的晋升、去重、再生或阻断结论。
- 完整性检查、秘密扫描、Vault/项目门禁和恢复抽检结果。
- 精确删除动作、可恢复位置与验证方法。
- 执行者、时间和剩余未知。
Receipt 不包含秘密值或整段原文。
7. 删除前最终门禁
只有以下全部成立才执行该条 allowlist:
- 冻结快照哈希与当前待删对象一致,且对象仍非活动。
- 父/子消息和附件枚举完整;禁止对象未混入。
- 所有 durable 候选均已写入唯一 owner、明确 no-op,或因高风险而保留在不随原文删除的待裁决证据中。
- 唯一附件已晋升并逐字节验证,未知附件为零。
- Vault/项目门禁通过,且 authority 变化已进入本地已验收 commit;
private-remote还必须完成私有 PR 合并。 - 恢复样本已从备份或归档成功读取。
- 精确 allowlist 与用户授权范围一致。
8. 执行与删除后验证
逐条执行,不用宽泛 glob、未解析环境变量或递归根路径。每条后立即验证:原对象不再位于活动存储、其他会话未受影响、晋升 owner 可读、receipt 可回溯、宿主仍正常。失败则停止剩余条目并报告可恢复状态。
输出
报告四个数字及其含义:审计会话数、沉淀候选/owner 数、晋升附件数、实际删除数。随后列出保留/删除 allowlist、被阻断条目、恢复位置、Git/门禁证据和一个确切下一动作。不要用“压缩完成”代替逐条可恢复证据。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

