用途:ov-resources 是 OpenViking(OV)中面向资源管理的技能,用于指导智能体正确调用 ov 命令组,避免猜测参数、URI 语义或处理行为。覆盖添加外部知识、文件系统操作、定时刷新(watch 任务)以及 ovpack 导入、导出、备份、恢复。
主要能力:资源命令包括 add-resource、task watch、export、import、backup、restore;文件系统命令包括 ls、tree、read、write、mkdir、rm、mv、grep、glob;搜索命令包括 find、search。输入包含子命令(必填)、目标(路径、URL、Viking URI 或查询字符串,视情况必填)以及命令专属参数,如 --wait、--to、--parent、--recursive、--watch-interval。
使用方式:先识别用户意图并映射到正确的 ov 子命令,再解析目标,构造带合适参数的命令并执行,最后报告结果。验证方式包括:add-resource 后用 ov ls 或 ov tree 确认新资源出现在预期 URI;rm 后 ov ls 不再列出该路径;write 后 ov read 反映新内容;import 或 restore 后 ov tree 显示导入结构。
适用场景:用户明确要求资源操作(ov add-resource、ov task watch、ov export、ov import、ov backup、ov restore);浏览、读写、创建、移动或删除 viking://resources/ 下的文件;搜索上下文(ov find、ov search、ov grep、ov glob);列出、检查或搜索资源树以查找上下文。
限制与权限:从外部 URL 执行 add-resource 可能下载不可信内容,需核实来源;ov rm --recursive 具有破坏性,对大目录执行前须与用户确认;export、import、backup、restore 需要 ROOT 或 ADMIN 权限;ov write 会原地替换文件内容,旧版本不保留。不得虚构路径或 URL,只能使用用户提供的内容;不得在未获明确确认时对 viking://resources/ 等宽泛路径执行 ov rm --recursive;ov add-skill、ov skills 属于技能管理,ov add-memory 属于记忆管理,均不在本技能范围内。运行时资源包括 docs/add-resource.md、docs/filesystem.md、docs/search.md、docs/watch-management.md、docs/ovpack.md 和 examples/commands.md。