创建技能
将指令、脚本与资源封装为渐进加载的可复用流程。
技能如何工作
技能通过名称和 description 被发现;Lime 选中后读取 SKILL.md,再按任务需要访问参考材料或运行脚本。描述应明确适用任务、触发词和排除范围,避免每次启动都加载完整手册。
显式与隐式调用
在提示词中明确指定技能,或通过当前技能选择器添加技能。任务与 description 匹配时,智能体也可以选择它。技能不能自行扩大文件、工具或外部操作权限。
创建技能
从一项已经实际执行过的工作流开始。确定输入、输出、步骤、必要工具和验证方式;只有需要确定性执行或外部工具调用时才添加脚本。
text
release-check/
├── SKILL.md
├── scripts/
├── references/
└── assets/markdown
---
name: release-check
description: 检查已准备的发布材料、版本与验证记录;不执行发布或推送。
---
1. 读取仓库发布事实源与当前版本。
2. 检查产物和验证记录是否对应同一修订。
3. 列出通过项、缺口和所需证据。
4. 返回可审阅报告,保留所有敏感值。本地技能位置
| 范围 | 位置 | 用途 |
|---|---|---|
| 项目 | .agents/skills | 团队或模块工作流 |
| 用户 | ~/.agents/skills | 跨项目个人技能 |
| 其他已登记根目录 | 通过技能目录返回的实际位置 | 当前主机或已安装包提供的技能 |
用 skills/list 或 lime skills list 检查实际发现结果。重名技能不应依靠猜测选择;核对路径、来源、启用状态和加载错误。
通过插件分发
本地目录适合编写与试用。需要共享一项或多项技能、连接器与展示资源时,使用插件包并检查来源、依赖、权限和安装路径。第三方精选目录和托管权益不属于 Lime 的默认分发合同。
启用与禁用
skills.config 支持按绝对 path 或 name 选择技能并设置 enabled。多个匹配项按实际配置顺序处理;修改后重新读取目录确认生效。
yaml
skills:
config:
- name: release-check
enabled: false元数据与工具依赖
可选的界面名称、图标、默认提示和依赖说明帮助用户理解技能。只声明实际使用的工具;安装与连接后通过工具发现核对名称、Schema 和认证状态,不假定声明依赖即可授予访问。
验证技能
- 给出应触发、应不触发和缺输入的任务。
- 检查是否按步骤读取必要事实。
- 验证脚本参数、失败行为与敏感信息处理。
- 确认产物与验收要求一致,避免只验证有一段回答。