在当前工作区使用自定义 Skill
下面做一个“交接单”技能。完成后,你可以在技能页看到它,点开新对话,让 Agent 按你的格式整理一条笔记。示例只需要文本编辑器。
选对工作区
- 在工作台选择要使用技能的对话或新对话的工作位置。
- 在侧栏打开 智能体。如果侧栏没有这个入口,在 更多 菜单里找。进入 技能 页签,在 自定义 区域确认工作区路径和运行位置。使用 SSH 时,将文件保存在远程机器上显示的目录中。
- 确认账号有 Plus、Pro、Lab 或 Enterprise 权益,运行端已登录并取得有效订阅凭据。官方技能按当前领域和内容等级授权,自定义 Agent 需要 Lab 或 Enterprise。
如果页面提示需要更新 Core,请使用含工作区重扫功能的 Core 和 UI。仅通过云进程连接的会话目前无法从这个面板扫描远端技能。
创建第一个技能
在刚才确认的工作区中,创建 skills/handoff-note/SKILL.md。把以下内容保存为 UTF-8 文本。
---
name: handoff-note
description: 把用户给出的工作笔记整理成简短的交接单。
---
第一行单独写 HANDOFF-NOTE。
接着写“已完成”和“待确认”两项,只使用用户提供的信息。
若没有待确认事项,写“无”。
回到技能页,点 重新扫描工作区。在自定义列表中找到 handoff-note。选中它,点 在新对话里用它,在草稿中补充下面的任务并发送。也可以在同一工作区的已有对话里直接输入这句话。
请调用 handoff-note 整理这条笔记:图表已经导出,标题需要确认。
展开这次回复的工具步骤,查找调用 skill、参数 name 为 handoff-note 的记录。回复应以 HANDOFF-NOTE 开头,并把“图表已经导出”和“标题需要确认”分别放入两项。列表中的条目说明 Core 已发现文件,工具步骤能确认这次对话是否实际加载了正文。
如果先看到 call_agent,展开接手任务的 Agent 的工具步骤,在那里查看 skill。添加参考文件后,还可以查看 skill_resource 读取的是哪个文件。
带参考文件的技能包
如需附带资源,可以继续在技能自己的目录中添加文件。例如,把一条检查规则写入 skills/handoff-note/references/checklist.md,在 SKILL.md 正文中加上“先用 skill_resource 读取 references/checklist.md,再检查交接单”。保存、重扫,在下一次请求中让 Agent 应用这条规则。
skills/
└── handoff-note/
├── SKILL.md
└── references/
└── checklist.md
只有指令时,也可直接保存为 skills/handoff-note.md。单文件技能没有随包资源。两种写法任选一种,保留一个 handoff-note 即可。旧工作区的 .omicos/skills/ 仍可使用。
使用别人发来的技能
OmicOS 可以直接读取工作区里的技能文件。收到 handoff-note.md 时,把文件复制到当前工作区的 skills/ 下。收到 handoff-note/ 目录时,复制整个目录,让入口位于 skills/handoff-note/SKILL.md,并保留里面所有的参考文件、脚本及其他资源。回到技能页,点 重新扫描工作区,选中技能即可使用。整个过程无需安装 Harness Kit 或运行命令。
如果收到的目录顶层是 agent-harness/ 和 harness-manifest.json,这是作者的开发包。请作者按下方步骤提供整理好的技能目录,再按上一步复制。
排查“自定义 0”
| 看到的情况 | 检查方法 |
|---|---|
| 扫描成功,数量为 0 | 核对页面中的机器和工作区。目录名是复数 skills/。目录包的入口必须直接位于 skills/<名称>/SKILL.md。 |
| 保存后仍看不到 | 点 重新扫描工作区 并展开扫描诊断。检查文件权限、未闭合的 ---、多套一层的目录或符号链接。使用实际文件和目录。 |
| 提示重名 | 修改 name 后重扫。同一根目录中目录包优先于单文件;普通工作区条目与官方条目重名时,官方条目优先。 |
| 提示订阅、凭据或设备限制 | 按面板提示登录、刷新凭据或处理设备限制,然后重扫。降级后,原文件仍留在工作区。 |
| 云端要求刷新凭据,本地仍能加载技能 | 同一账号续签暂时失败时,Core 默认有 24 小时宽限,云端会要求有效凭据。恢复连接后刷新凭据,再重新扫描。收到降级或设备限制结果后,Core 会按新权益检查。 |
| 官方目录刷新失败 | 直接点 重新扫描工作区。在已连接的运行端上,此按钮读取磁盘文件。 |
供技能作者使用的 Harness Kit(可选)
如果你用 Harness Kit 开发技能,可以在自己的机器上准备交付目录。选择一个已存在的空目录作为临时工作区,用支持工作区安装的 Kit 版本运行下面的命令。把两个路径换成自己的开发包和临时工作区。工作区安装命令说明
ohf install ./my-harness --workspace ./staging-workspace
把生成的 staging-workspace/skills/<名称>/ 整个目录发给使用者。里面的 SKILL.md、harness-manifest.json、脚本和参考文件可以一起复制到对方的工作区。重复使用同一临时工作区时,安装器遇到同名技能会停止。需要备份并替换旧版时,加 --replace。如果骨架仍标为 dry_run,请在目标环境另行验证真实算法的依赖和输出。