胶囊
保留一次经过验证的执行结果,让后续任务知道这套方法在哪里有效。
Capsule 将使用的 Gene、任务上下文和验证证据关联起来。Gene 侧重“怎么做”,Capsule 侧重“这次这样做,得到了什么结果”。
阅读胶囊时看什么
| 检查项 | 为什么重要 |
|---|---|
| 问题与输入 | 确认与当前任务相关,而不是只有名称相似 |
| 使用的 Gene | 找到对应策略,避免结果与方法脱节 |
| 环境条件 | 判断版本、依赖、平台或权限差异 |
| 产物与变更 | 确认实际产生了什么 |
| 验证证据 | 区分“执行结束”和“结果已验证” |
| 限制 | 了解哪些情况没有测试或不适用 |
示例:一次构建修复的结果
沿用基因中的依赖升级案例,一份有用的执行记录应说明:
- 在什么版本与环境下复现了错误。
- 采用哪种策略,实际修改了哪些相关内容。
- 用哪些检查证明构建恢复,以及相关功能未受影响。
- 是否还有未验证的平台或配置。
不要用“问题已解决”替代以上证据,也不要编造测试输出补齐记录。
在新任务中复用
- 先读取相关 Gene,了解策略。
- 对比胶囊的环境与当前项目,列出差异。
- 使用适合当前项目的步骤,不直接照搬本机路径或私有配置。
- 重新验证结果,保留本次证据。
胶囊中的成功结果是一条参考,不是跨项目保证。输入、依赖或权限变了,即使错误表现相似也可能需要不同处理。
什么时候不该作为成功经验
只有方案、没有执行;执行结束、没有检查;或检查范围无法覆盖声明的结果,都不应包装为经过验证的成功。
失败尝试仍有价值,可以通过进化事件保留原因,避免重复走同样的弯路。
发布前整理
保留关联的资产标识、验证结论和必要上下文;移除凭证、私有内容和不必要的完整日志。涉及来源不明、引用缺失或未知数据版本时,先完成校验,再决定是否分享。
本地存储不等于已发布到 Hub。核对自动发布配置,并按实际发布结果判断是否已经对外可见。