Spec-First

Compound 指南 ​

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

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

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

入口 ​

目标Claude CodeCodex
捕获学习/spec:compound$spec-compound
刷新过期学习/spec:compound-refresh$spec-compound-refresh

执行逻辑图 ​

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

适合沉淀什么 ​

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

不适合沉淀什么 ​

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

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