基因
保存一种可复用的处理方法,而不是某一次任务的全部细节。
Gene 描述策略、触发信号和适用边界。Evolver 可以根据工作区中的信号召回相关 Gene,再结合当前任务判断是否适合采用。
什么值得保存为基因
适合提炼的做法应有明确的问题类型、可解释的步骤和验证方法。例如,重复出现的依赖兼容问题,可以总结排查顺序;一次偶然成功的改动则还不足以证明方法可复用。
| 内容 | 应回答的问题 |
|---|---|
| 触发信号 | 遇到什么现象时考虑使用? |
| 前提与边界 | 适用于哪些环境,哪些情况应停止? |
| 策略步骤 | 先检查什么,再处理什么? |
| 验证方式 | 如何判断问题解决且没有退步? |
| 失败处理 | 无效时保留什么证据,如何恢复? |
这是一份内容检查表,不是可直接导入的 JSON schema。
示例:依赖升级后构建失败
触发信号:升级依赖后出现原先没有的构建错误。
策略:保留首个错误和版本信息,核对依赖兼容要求,定位最小差异,只修改与错误相关的配置或代码。
验证:在相同环境中重新构建,并运行受影响功能的检查。
不适用情况:如果失败来自缺少凭证或服务不可达,先处理运行环境,不通过降级依赖掩盖问题。
这里保留的是排查方法。某个项目实际修改了哪个文件、测试输出是什么,应由胶囊及过程记录说明。
复用前检查
- 比较错误信号是否相似,不只匹配标题中的关键词。
- 检查运行环境、依赖版本和权限前提。
- 将策略映射到当前项目,明确允许修改的范围。
- 执行后验证,记录本次结果与原经验的差异。
召回或选中 Gene 不等于授权执行其中所有步骤。涉及删除、网络访问或发布时,仍遵循当前任务的权限。
更新与失效
同一策略在新环境中失败时,先查清原因。环境变更、步骤过期和验证缺失应分别记录,不能直接把失败结果改写成成功。
保留来源和版本关系,避免覆盖后无法解释旧结果。涉及外部资产的审核、撤销和升级,参见资产治理。
保存与共享
本地 GEP 资产位置取决于运行配置,参见资产路径。不要直接覆盖运行中的资产文件。
需要结构化蒸馏时,使用对应版本支持的工具;具体命令与质量要求见蒸馏 Gene、Skill 与 Recipe。发布前还应检查隐私、引用和验证证据。