Compound 详细指南
Claude Code 使用
/spec:compound,Codex 使用$spec-compound。
Compound 的职责是把这次已经解决的问题,沉淀成下一次还能复用的知识。
输入与输出
- 输入:已解决的问题、验证后的方案与经验
- 输出:
docs/solutions/**/*.md
从当前 README 与 skills 真源来看,Compound 的核心承诺是:
- 把 learnings 写入
docs/solutions/ - 让后续 workflow 可以检索和复用这些知识
它解决什么问题
如果没有 Compound,AI 编码很容易出现一个典型问题:
- 这次解决了
- 下次还会重新踩一遍
Compound 负责把“这次为什么出问题、怎么解决、以后怎么避免”写成 durable knowledge。
使用方式
Claude Code:
bash
/spec:compoundCodex:
bash
$spec-compound什么样的内容适合沉淀
- 真实遇到过的问题
- 已验证有效的解决方案
- 值得复用的模式
- 值得避免的反模式
它不应该变成:
- 任意流水账
- 与当前代码无关的理论总结
- 没有证据支撑的“建议清单”
Compound Refresh
知识写进去之后,也会随代码演进而过期,所以当前产品还提供:
- Claude:
/spec:compound-refresh - Codex:
$spec-compound-refresh
它的目标是让 docs/solutions/ 长期保持可用,而不是越积越脏。
当前更准确的理解
Compound 不是“五阶段里固定最后一步”的简单收尾动作,而是知识回流层:
text
解决问题
→ 提炼知识
→ 写入 docs/solutions
→ 让下一轮 workflow 能重新发现