learn

name	learn
description	将已验证的观察记录为证据，并判断哪些学习应提升为长期上下文、稳定协议或 ADR。适用于 check 之后、失败假设、blocker、被拒绝或悬而未决的提案，或新事实可能改变后续判断时。

Learn

把运行结果变成可复用的知识，但不把每次试错都升级成长期规则。

记录证据

只记录会影响后续判断的增量，追加到 EVIDENCE.md：

## <date> — <subject>

### Observation
### Interpretation
### Recommended next action
### Verification
### References

把观察、解释和建议分开；不要写会话流水账或重复 git diff。

在 .jj/ 项目中，Evidence 的 References 可以记录可复核的 JJ Change ID、 bookmark 和 jj diff/jj log 结果；不要把 JJ Change 当作语义 Change，也不要 要求远端发布才能完成本地 learn。Git-only 项目继续记录其现有 commit/branch 证据。

如果来源 Slice 有 evidence_ref：先为本次结果分配稳定 Evidence ID，追加 EVIDENCE.md，验证写入成功后，再把同一个 ID 回写 Slice。不要在验证前 预填链接；learn 是唯一写入者。

判断知识类别与提升层级

• 只影响当前任务：留在 Slice 或 SPEC，不提升；短路径上不留任何记录。
• 可复用但尚未成为规则的事实、失败假设或验证结果：追加 EVIDENCE.md。
• 项目稳定概念、身份、关系、生命周期或不变量：经 plan 确认后更新项目 KERNEL.md；项目自己的词汇和权威边界更新 CONTEXT.md；只有 SPEC-AGENTS 工作流自身的语义才更新 docs/spec-agents/WORKFLOW.md。
• 稳定接口、状态转换或 Action Contract：经 plan 确认后更新 docs/protocols/。
• 稳定的开发、评审、测试或协作约定：经 plan 确认后更新 。