Compound 指南

沉淀经验：spec-compound · spec-compound · 契约见 spec-compound

刷新经验：spec-compound-refresh · spec-compound-refresh · 契约见 spec-compound-refresh

Compound 用于把已经验证的经验沉淀到未来可复用的位置。它不是"每次任务结束都写总结"的形式动作，而是把真实任务中可迁移的判断保存下来。

入口

目标	Claude Code	Codex
捕获学习	spec-compound	spec-compound
刷新过期学习	spec-compound-refresh	spec-compound-refresh

执行逻辑图

用户运行 spec-compound
  |
  v
读取已解决问题、diff、验证结果、review 结论和现有 docs/solutions/*
  |
  v
判断经验是否真实验证、可复用、不会快速过期
  |
  +-- 不值得沉淀
  |     |
  |     v
  |   只在最终总结里说明，不新增长期文档
  |
  +-- 值得沉淀
        |
        v
      写入 docs/solutions/* 或更新既有 learning
        |
        v
      如发现旧文档漂移，交给 spec-compound-refresh
        |
        v
      后续 workflow 可读取该经验作为软上下文

适合沉淀什么

• 反复出现的 bug 模式或验证盲点
• 项目特有的决策约束
• workflow 执行中被证明有效的检查顺序
• 未来任务需要先知道的外部系统入口

输出质量标准

一份值得保留的 compound 文档应包含：

• 已验证的问题背景，而不是纯主观总结。
• 根因、解决方式、验证方式和避免复发的检查点。
• 适用范围和不适用范围。
• 可被下一次 brainstorm、plan、work 或 review 直接引用的行动建议。

不适合沉淀什么

• 可从当前代码直接读出的文件结构
• 临时任务状态
• 未验证的猜测
• 已经过期或只对一次 diff 有意义的细节

Compound 的价值在于让下一轮工作更稳，而不是扩大文档数量。

下一步

• 查看知识如何回流：记忆与知识沉淀
• 刷新过期经验：spec-compound-refresh 详情
• 回到主链路：工作流总览