技能采用渐进式披露来高效管理上下文:Enconvo 一开始只读取每个技能的元数据(名称、描述、文件路径)。只有在技能被激活时才会加载完整的指令。
管理你的技能
打开 设置 → 技能。每个智能体都会共享这些技能,而且每个智能体也可以在自己的设置中添加专属技能。- 顶部的卡片分别统计 全部技能、已开启,从未使用、在多个文件夹中 以及 关闭 的技能数量。点击卡片即可只列出该分类下的技能。
- 每一行都会显示 所在位置(内置,或来自哪个文件夹或应用)以及 上次使用 的时间。你可以用行末的开关关闭智能体不需要的技能,也可以多选后批量关闭。
- 从 GitHub 添加 可以从代码仓库安装技能,导入 可以从 Mac 上的文件夹添加技能。参见安装技能。
- 我的 Skill 按来源列出你创建的技能:已录制、已学会、脚本、手写的 或 已安装。点击任意技能可以查看它的 步骤、注意事项 和 历史记录。参见带有已保存步骤的技能。
技能长什么样
技能就是一个包含SKILL.md 文件的文件夹,另外可以有脚本和参考资料。
SKILL.md 格式
SKILL.md 必须以一个包含 name 和 description 的 frontmatter 块开头:
使用技能
你可以按名称调用技能,也可以让 Enconvo 挑选一个与请求相符的技能。按名称调用技能
在 SmartBar 或聊天中输入/ 加技能名称:
$。
你安装的插件所带的技能也会出现在 / 和 $ 菜单中,采用与 Claude Code 相同的 plugin:skill 命名格式。
让 Enconvo 挑选
当你没有指定技能时,Enconvo 会根据description 把你的请求与最相关的技能匹配:
- 你输入:“把这些会议记录总结成待办事项”
- Enconvo 扫描所有可用技能的描述
meeting-notes技能匹配成功(“…format raw meeting transcripts into structured notes with action items…”)- 该技能被激活,它的指令引导回答
写出容易匹配的描述
匹配是否准确,取决于description 写得好不好:
好的描述包含三部分:
- 做什么:“审查代码中的 bug、安全问题和最佳实践”
- 何时触发:“当用户要求代码审查时使用”
- 何时不触发:“不要用于生成代码或编写新代码”
技能存放位置
Enconvo 从多个位置读取技能,每个位置有各自的作用范围:
每个智能体也可以带有自己的技能:在智能体设置的 技能 下添加即可。
如果不同位置的两个技能同名,它们都会保持可用,Enconvo 不会合并它们。设置 → 技能 会把这些技能列在 在多个文件夹中 下。
项目技能
项目技能位于你的项目文件夹内,只在该项目处于活动状态时可用:用户技能
~/.agents/skills/ 中的用户技能在所有项目中都可用。不属于某个具体项目的个人技能适合放在这里:
创建技能
使用技能创建器
创建技能最快的方式是使用内置的创建器:- 技能做什么
- 它何时触发
- 它只包含指令,还是也包含脚本
手动创建
创建一个包含SKILL.md 文件的文件夹:
1
创建技能目录
2
编写 SKILL.md
3
确认它已出现
Enconvo 会自动检测技能的变化。如果新技能没有出现,请重启 Enconvo。
编写指令
SKILL.md 中 frontmatter 下方的正文是 AI 要遵循的指令。把它们写成清晰的祈使句步骤:
写好技能的要点
- 让每个技能保持专注。 一个技能只做一件事。做太多事的技能更难正确触发,也更难维护。如果你写了 10 个以上的步骤、涵盖了多项任务,就把它拆成几个技能。
- 明确输入来源。 准确说明输入从哪里来:“读取选中的文本”、“解析附加的文件”、“使用用户消息中的 URL”。
- 定义输出格式。 给出输出应有样子的具体示例,让结果保持一致。
- 处理边界情况。 为常见的边界情况添加指令:“如果没有找到提交,说明该范围为空”或“如果输入不是有效的 JSON,请用户检查格式”。
- 写祈使句步骤。 明确写出输入、步骤和预期输出。模糊的指令会导致结果不一致。
- 优先用指令而不是脚本。 自然语言指令更容易编写、调试和修改。只有在需要确定性行为或外部工具时才使用脚本。
- 划清边界。 在描述中同时写明技能应该处理什么、不应该处理什么。
- 测试触发描述。 尝试不同的提示词,确认技能在该触发时触发、不该触发时不触发。
- 对技能进行版本管理。 把团队共享的技能放在版本控制(git)中,便于跟踪变更、回滚和协作。
添加脚本
需要可执行逻辑的技能,可以添加一个scripts/ 文件夹:
SKILL.md 中引用这些脚本:
何时使用脚本
添加参考资料
可以放入技能能查阅的文档或上下文文件:- 技能需要遵循的 API 文档
- 风格指南或品牌规范
- 代码示例和模板
- 特定领域的知识
安装技能
使用/skill-installer 从 Enconvo 技能商店或 GitHub 安装技能。它也可以从 Skills.sh、ClawHub 和 ZIP 直链安装。
从 Enconvo 技能商店安装
按名称搜索技能并安装:从 GitHub 安装
直接从 GitHub 仓库 URL 安装技能:从 Mac 上的文件夹安装
- 打开 设置 → 技能,点击 导入。
- 选择一个包含若干技能子文件夹的文件夹,每个子文件夹都有一个
SKILL.md。
带有已保存步骤的技能
每个已保存的工作流也都是一个带有自己SKILL.md 的技能,而且技能可以保存它以前执行过某项任务的步骤。运行这类技能时,它会先运行已保存的步骤,无需调用主模型,速度更快、成本更低。如果某个步骤不再适用(例如按钮移动了位置),系统会根据技能自己的说明和截图进行修复。只有当修复也失败时,智能体才会按照 SKILL.md 重新执行任务。
在 我的 Skill 中,标有 先跑保存的步骤 的技能包含步骤,标有 只有说明 的则没有。每个技能的 历史记录 会显示它的运行情况以及学到的内容,你还可以恢复到更早的版本。
将录制转为技能
你可以把自己完成某项任务的录制转为技能。录制的每一个操作都会成为一个受检查的步骤,其截图也会保留下来用于后续修复。在它成功运行一次之前,该技能会保持为 草稿 状态。将脚本作为步骤运行
技能可以在自己的scripts 文件夹中保存一个代码模式脚本,并将其作为一个步骤运行,让需要调用多次工具的任务合并为一步完成。
让技能学习你的工作方式
技能可以学习你喜欢如何完成任务,就像记忆学习事实一样。打开 设置 → 记忆 并开启 学习做法:- 当你纠正某项任务的完成方式,或者某个步骤需要修复时,技能会立刻学会它。聊天中会显示一条带 撤销 的 已学会 提示。
- 当某项任务第二次出现时,它会变成一个新技能。
- 记忆审查和记忆整理也会一起照看技能。
管理技能
查看你的技能
设置 → 技能 列出所有智能体共享的技能。在顶部选择一个视图:
可以搜索,按来源筛选(全部来源、内置、来自插件 或某个文件夹),或按 名称 A 到 Z 或 上次使用 排序。
更新技能
- 商店技能:再次运行
/skill-installer检查是否有新版本。 - GitHub 技能:用同一个 URL 再次运行安装器。
- 你自己的技能:直接编辑
SKILL.md文件。Enconvo 会自动检测到变化。
关闭技能
你可以关闭技能而不删除它:- 打开 设置 → 技能。
- 找到该技能。
- 关闭它的开关。
技能示例
代码审查
会议记录
Git 提交信息
API 文档生成器
相关内容
智能体
为智能体配备它自己的技能和工具。
MCP 集成
把技能与 MCP 工具结合使用。
Enconvo GitHub
浏览开源的扩展和技能。
社区 Discord
在社区中分享技能并获取帮助。