技能管理
将可复用的工作说明加入 EvoX,核对来源与依赖,再管理它的启用和维护。技能如何组织任务、验证效果,见技能工作流。
选择来源
打开扩展 > 技能。编码模式也可通过 /skills 进入技能管理。先确认要添加的是技能目录或技能包,不把进化历史归档 .gepx 当作技能包导入。
| 来源 | 添加前检查 |
|---|---|
| 本机扫描 | 目录内的技能说明、脚本和引用文件是否完整 |
| ZIP 导入 | 压缩包来源、目录结构与附带脚本 |
| GitHub 导入 | 仓库及路径是否正确,私有来源是否有读取权限 |
在“添加技能”中选择来源后,按以下流程完成:
- 本机扫描:等待扫描,使用搜索筛选候选,勾选需要的技能;列表不完整时重新扫描。
- ZIP 导入:选择技能压缩包,查看导入结果及错误,不把任意资料压缩包当作技能包。
- GitHub 同步:填写
owner/repo,指定分支或标签及技能子目录;分支留空使用默认分支,再选择同步。 - 检查同名冲突的处理选项,比较来源和正文后再确认;本机扫描使用“导入所选”。
- 遇到脚本或高影响能力确认时,阅读范围后决定是否继续。完成后核对新增、跳过与失败条目,先处理失败原因,不重复导入整个来源。
从零编写时,在“添加技能”选择创建技能,填写 ID、版本、描述和 SKILL.md 正文,再按实际需要设置命令执行、文件写入、网页读取、搜索和允许域名。版本使用 0.1.0 这样的三段数字格式;ID 在编辑已有技能时固定。保存后重新打开详情核对内容,能力声明不代替运行时授权。
只想了解首次迁移流程时,见导入经验。
安装前检查内容与依赖
- 阅读技能说明,确认触发场景、输入、步骤和输出。
- 检查附带脚本、网络访问、写入目录和付费服务。
- 确认需要的插件、MCP、命令行工具和账号已准备好。
- 导入后在列表中核对来源、内容和启用状态。
技能中的指令不构成操作授权,也不会自动安装依赖、连接账号或扩大工具权限。
验证可用性
先使用一份范围明确的材料执行任务,检查技能是否被采用、依赖是否可用、产物是否符合说明。至少检查一次正常输入和一次缺少必要输入的情况。只有导入成功,不能证明工作流能完成。
需要检查调用状态时,核对任务中的技能使用记录和实际步骤,不只看最终回复是否提到了技能名称。
更新、停用与恢复
修改前保留原内容及来源。在技能详情中阅读 SKILL.md;编辑个人技能时修改正文并保存,重新打开详情核对结果,取消编辑不保存草稿。来自 GitHub 的更新通过对应同步来源处理,比较分支、子目录、说明和脚本变化后再导入。涉及新增外发、写入或费用时重新审阅。暂时不用的已安装条目通过列表的启停操作处理,重新启用后再验证。
更新后用原验证任务复验。异常时先停用该条目,恢复保留的内容,再检查依赖。没有回收站入口的对象不假设支持自动恢复;需要删除时先核对对象与确认范围。
排查问题
| 现象 | 检查 |
|---|---|
| 导入后未出现 | 导入结果、来源路径、目录结构与列表刷新 |
| 未被任务采用 | 条目是否启用,说明是否匹配任务 |
| 已采用但执行失败 | 工具、账号、脚本依赖与输入是否齐全 |
| 更新后结果变化 | 比较前后内容与依赖,用同一任务复验 |