ov-skills

用途

ov-skills 是 OpenViking（OV）平台上的智能体技能管理工具，通过 ov skills 命令行组管理智能体技能。其目标是引导智能体正确调用 ov skills 各子命令完成技能生命周期操作，而无需猜测参数、来源类型或更新语义。

ov skills 命令组支持以下子命令：

list（别名 ls）：列出已安装技能。
find：搜索已安装技能，接受查询字符串。
add：从本地目录、本地文件、Git 仓库、GitHub URL 或原始 SKILL.md 内容安装技能。ov add-skill 与 ov skills add 为同一命令，参数一致。
show：查看技能内容、文件或来源，接受技能名称。
update：更新技能，接受技能名称。
remove（别名 rm、delete）：删除技能，接受技能名称。
validate：在本地校验 SKILL.md 或技能目录格式，接受本地路径。

subcommand（必填）：list（别名 ls）、find、add、show、update、remove（别名 rm、delete）、validate 之一。
argument（条件必填）：show/update/remove 为技能名称；find 为查询字符串；add 为来源路径/URL 或原始 SKILL.md 文本；validate 为本地路径。
root（可选）：通过 -p 传入技能根 URI，viking://~/skills（私有）或 viking://agent/skills（与账户共享）。add 默认使用私有根；list/find 搜索两个根；show/update/remove 先将名称解析到私有副本，再解析共享副本。
level（可选）：show/find 使用 -L/--level，0 为摘要，1 为概览，2 为完整 SKILL.md。

识别用户意图，映射到正确的 ov skills <subcommand>。
确定 add 的来源类型（本地目录、本地文件、Git URL、GitHub tree URL、原始内容）。当来源可能包含多个技能时，先运行 ov skills add <source> --list，再用 --skill 选择技能。
仅使用示例中给出的参数构造命令。-p 的长形式在 list/find/show 中为 --uri，在 add/update/remove 中为 --parent-auto-create。添加全局 -o json 可获得机器可读输出。
执行并报告结果。

CLI 输出直接返回给用户：默认表格，使用 -o json 输出 JSON（show 也接受 --format json）。错误会附带建议的修复方式。

add 之后，list 应包含新技能。除非传入 --wait，处理可能继续在后台进行，可用 ov task status <task_id> 检查。
remove 之后，list 不应再包含被删除的技能。
update 之后，show <name> --level 2 应显示最新的 SKILL.md，show <name> --source 显示记录的来源。

在以下情况加载本技能：

ov skills add 可能下载并安装外部代码；当用户提供不受信任的 URL 时，应验证来源。
ov skills update 和 ov skills remove 始终要求确认；当来源解析为多个技能时，ov skills add 也要求确认。没有终端时命令会以 requires confirmation 失败。可传入 --yes 跳过提示；应在对话中与用户确认后再用 --yes 重新运行。
ov skills remove --all 具有破坏性，执行前需与用户确认。
ov skills update 会原地替换技能内容，不保留旧版本。
不要编造技能名称或 URL，应使用用户提供的内容。
未经用户明确确认，不要执行 ov skills remove --all。
不要在智能体 shell 中不带技能名称运行 ov skills remove：它会打开需要终端的交互式选择器。
删除技能应使用 ov skills remove，而非 ov rm：只有 ov skills remove 会同时删除技能的隐私配置。