mcpField
O
ov-skills

ov-skills

github.com/volcengineAgent 工作流41.1k69 次安装今天更新
代码仓库

关于 ov-skills

面向 Agent 的 OpenViking 技能管理命令指南，覆盖本地目录、Git 仓库、GitHub URL 和原始内容等来源。它指导技能的安装、搜索、查看、更新、删除及本地格式验证，并强调需确认的操作。

主要功能

  1. 01从多种来源安装技能
  2. 02列出、搜索和查看技能
  3. 03更新或删除已安装技能
  4. 04本地验证技能格式
  5. 05支持私有与共享技能范围

适用场景

  1. 01安装本地或远程技能
  2. 02查找可用技能以供选择
  3. 03检查 SKILL.md 内容或来源
  4. 04验证技能目录格式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/volcengine/openviking --skill ov-skills

安装后在 Claude Code 中输入/ov-skills确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

docs/
source-types.md
upgrade-guide.md
examples/
commands.md

详细介绍

OpenViking (OV) 技能管理

ov skills 命令组用于管理 OpenViking 上的 Agent 技能——包括从本地目录、Git 仓库、GitHub URL 或原始内容安装；列出、搜索、查看、更新和删除技能；以及在本地校验技能格式。ov add-skill 与 ov skills add 是同一个命令，接受的参数也相同。

目标

引导 Agent 正确调用 ov skills 子命令来完成技能生命周期操作，避免猜测参数、来源类型或更新语义。

加载时机

  • 用户明确要求进行技能管理：ov skills ...、install skill、update skill、delete skill、remove skill。
  • 用户要求校验 SKILL.md 或技能目录。
  • 用户要求查找或搜索已安装的技能。
  • 用户要求查看某个技能的内容、文件或来源。
  • Agent 需要在选择技能之前发现可用的技能。

输入

名称必需描述
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）

工作流

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

权限

  • ov skills add 可能会下载并安装外部代码；当用户提供不受信任的 URL 时，请核实来源。
  • ov skills update 和 ov skills remove 总是会请求确认；当来源解析为多个技能时，ov skills add 也会如此。没有终端时，命令会失败并提示 requires confirmation. Pass --yes to skip the prompt.；请在对话中与用户确认，然后使用 --yes 重新运行。
  • ov skills remove --all 具有破坏性；执行前请与用户确认。
  • ov skills update 会就地替换技能内容；旧版本不会被保留。

输出

  • 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 应显示记录的来源。

边界

  • 不要编造技能名称或 URL。使用用户提供的内容。
  • 未经用户明确确认，不要执行 ov skills remove --all。
  • 不要在 Agent shell 中不带技能名称就运行 ov skills remove：它会打开一个需要终端的交互式选择器。
  • 使用 ov skills remove 删除技能，而不是 ov rm：只有 ov skills remove 会同时删除技能的隐私配置。

运行时资源

  • docs/upgrade-guide.md — 从通用文件系统命令迁移到 ov skills。
  • examples/commands.md — 按场景划分的常用命令模式。
  • docs/source-types.md — 深入介绍支持的源格式和 URL 模式。

评论

支持 Markdown