Evolver 技能
把反复验证的经验整理成 Agent 能执行的工作说明。
技能适合表达一套有输入、步骤、产物和检查标准的工作流。它不是聊天摘要，也不是将 Gene 文件改名为 SKILL.md。Evolver 可以帮助提炼策略；将经验组织成应用可用的技能，还需要明确工具、权限和运行前提。
什么时候整理成技能
当相似任务多次出现，而且已经找到稳定做法时，技能能减少重复解释。例如，团队每周需要从记录中整理进展，可以把资料范围、输出结构、缺失信息处理和验收要求写成工作说明。
如果做法只成功过一次，先保留结果与限制，再通过不同输入验证，不急于声称已经适合普遍复用。
一份技能应包含什么
| 部分 | 周报工作流示例 |
|---|---|
| 触发条件 | 需要从项目记录整理周报 |
| 输入 | 本周记录、时间范围、目标读者 |
| 步骤 | 读取材料、核对来源、分类整理、标记待确认问题 |
| 输出 | 进展、阻塞和下一步，不编造缺失数据 |
| 验证 | 每项结论有材料依据，日期与范围一致 |
| 边界 | 先生成草稿，发送或发布另行确认 |
这是内容结构示例，不是安装后的默认技能。
在 EvoX 中导入技能
整理并验证技能后，通过技能页的添加入口选择来源。下方示意只改变示例状态，不读取目录或安装内容。扫描本机、ZIP 和 GitHub 导入的完整步骤见导入经验。
导入
从 ZIP 文件或公共 ZIP 链接检查并安装技能。
将技能 ZIP 拖到这里
也可以粘贴 ZIP 文件或公共链接。
一个压缩包可以包含多个技能，最大 64 MB。
技能包与 .gepx 不是同一种格式；迁移进化历史使用进化归档。
从经验到可用工作流
以依赖升级为例：Gene 的策略是“先定位依赖变化，再用失败测试缩小问题”；Capsule 记录一次升级中受影响的版本、修复和通过的检查。技能应提取稳定操作，而不是复制该次项目的全部路径与日志。
- 从多个相关结果中找出共同输入：依赖清单、升级范围、失败测试与允许改动目录。
- 写成顺序：读取版本变化 → 复现失败 → 最小修复 → 运行相关测试 → 汇报剩余风险。
- 把版本号、项目名和个人路径变成任务输入；把外部服务不可用、无法复现等情况写成停止条件。
- 用另一份升级任务试用，核对能否完成而无需复用旧项目的隐含上下文。
例如：“升级只涉及测试工具时，先跑其相关测试；无法复现时保留日志，不修改无关业务逻辑。”这才是可复用指令。单次成功的 Capsule 仍作为证据保留，不因此自动变成通用技能。
Gene 表达方法，Capsule 保存结果，Skill 表达宿主可执行的工作说明，Recipe 串联有序资产。命令与参数见蒸馏指南。
怎样验证这份技能真的能复用
为下一次依赖升级提供新的依赖范围、失败日志与允许改动目录，不携带上一次的完整聊天记录。让技能先复现，再修复，最后交付差异、验证命令与结果。检查它能否独立找到新项目的相关文件，而不是照抄旧路径或旧版本号。
至少覆盖以下情况：正常输入能完成；缺少失败日志时会先补齐证据；无法复现或外部服务不可用时会停止并说明限制；请求超出授权目录时不会自行扩大范围。测试失败就修订相应步骤，再用该情形复测，不以“已导入”代替可用性验证。
只有这次环境才成立的修复留在 Capsule；跨任务仍成立的判断与步骤写进技能。这样下次复用的是方法，而不是上一次的偶然条件。
更新与回退
更新前保留当前技能和来源标识，比较 SKILL.md 与脚本的变化。不要把同名覆盖当作自动升级；权限扩大、新增网络调用或删除步骤都需要重新审阅。
新版本异常时，停止使用并恢复上一个已验证版本，再用原任务复测。不要假设存在通用回收站。具体流程见技能版本。
常见问题
- 导入后无法完成任务：检查依赖、可用工具和输入材料，而不只是文件是否存在。
- 技能要求了额外权限：说明中的要求不会自动变成授权。
- 同名技能内容不同：比较来源、版本和实际内容后再处理冲突。
- 想分享给团队：先去除个人路径、秘密和内部材料，再提供适用环境与验证方法。