蒸馏 Gene、Skill 与 Recipe
把完成过的任务整理为可复用能力,先保留原始证据,再提炼方法,最后选择产物。本页以“修复窄屏溢出”为例说明制作过程;复用已有经验见Recipe 与经验复用。
先选择交付物
| 交付物 | 要保存什么 | 本例的表达 |
|---|---|---|
| Gene | 触发信号、前提、策略与验证要求 | 根据实际布局约束定位并修复横向溢出 |
| Skill | Agent 的触发说明、工作步骤和工具约定 | 收到界面回归任务时怎样读取代码、复现和交付 |
| Capsule | 一次实际执行及其结果和证据 | 某项目的一次修复记录与所用 Gene |
| Recipe | 对已有 Gene/Capsule 的有序编排 | 复现、修复、回归检查与结果整理的组合 |
一次任务可以产生多种对象,但不能通过改后缀或复制同一段摘要得到它们。
从原始任务提取方法
保留原请求、问题截图、改动前后差异、执行命令、验证输出和失败尝试。先回答:触发条件是什么,哪一步起作用,哪些做法失败,验证覆盖了什么,换一个项目还需要哪些前提。
本例可提炼为:先在报告宽度复现,定位造成溢出的元素与约束,再修改该约束,并复查菜单和桌面布局。某个项目的文件名、账号与私有内容留在本地记录中;通用策略不依赖这些秘密。
制作 Gene 候选
下面命令把信号与策略提交给独立 Evolver 的蒸馏入口:
evolver distill --category repair --signals horizontal_overflow --strategy "Reproduce overflow; locate the width constraint; fix the cause; verify mobile interaction and desktop layout"
检查返回的候选 ID 和内容,再补齐前提、限制与验证要求。字段和正式校验示例见GEP 数据结构。候选创建、审核通过、执行成功与发布是四个步骤,创建结果不提供成功证据。
制作 Skill 与 Recipe
按编写技能定义 Skill 的触发、输入、步骤与能力,并验证正常、缺少材料和超出范围三类请求。Recipe 则编排已有资产,不能直接把 SKILL.md 路径当成资产 ID。
以“定位溢出 → 验证修复”为两步 Recipe:先准备两个已获准使用的 Gene,分别记录内容 ID、步骤前提、输出和验证方法。两个资产都必须存在于目标 Hub,且类型正确。本地存在不代表远端存在。
将命令中的两个 ID 替换为实际值,按顺序构建:
evolver recipe build --title "Repair and verify horizontal overflow" --genes "sha256:<diagnosis-gene-hash>,sha256:<verification-gene-hash>" --description "Diagnose the width constraint, then verify mobile interaction and desktop layout" --price 1
这条命令会向 Hub 创建 DRAFT 草稿,不是离线预览。--price 1 设置每次执行的标价,不授权当前节点购买或运行。普通构建不加 --publish;取得创建授权与 Hub 身份后再执行。
| 构建前后 | 必须核对 |
|---|---|
| 步骤输入 | IDs 为完整 sha256 内容 ID,顺序与任务依赖一致,最多 20 步 |
| 类型 | CLI 从本地 Gene/Capsule 列表识别类型;未找到的 ID 按 Gene 处理,所以 Capsule 必须先在本地可识别 |
| 创建回执 | 状态为 draft,保存 Hub 返回的 Recipe ID,不把某个 Gene 的哈希当作 Recipe ID |
| 发布决定 | 审阅草稿的步骤、类型和价格,单独批准后才使用 --publish |
| 创建超时 | 核对原操作和 Hub 记录;CLI 按创建内容生成幂等键,保留完整原请求,包括标题、描述、价格、资产与步骤顺序;结果未知时先对账,再决定是否修改字段或重试 |
CLI 的 --genes 参数也有 --assets 别名;它不会自动为缺失资产补齐远端发布。需要修改字段、条件或输入输出 schema 时,使用 GEP 数据结构中的 Recipe 创建结构与 Hub 对应接口,不能凭空增加 CLI 参数。
从 Skill 制作时使用 evolver recipe from-skills --manifest <file>。该入口要求有执行证据的有序步骤,不能把说明文件列表当作 manifest;普通资产编排优先使用上面的 build 路径。制作完成后的执行、租约与结果回报见Recipe 与经验复用。
用另一个任务检验可复用性
选择另一个具有相同信号、不同文件布局的任务,检查方法是否仍能引导定位,是否需要隐藏的人工补充。保留失败和不适用记录;把“为什么不能用”写入前提或反例。
验收材料应包括原始证据、提炼后的对象、正式校验结果、复用记录和适用范围。只给一段总结或一次模型自评,不足以完成蒸馏。