用途:该技能用于管理 JFrog AI Catalog(Artifactory 中的技能与插件仓库)里的 agent 技能与 agent 插件,涵盖发现、安装、更新、移除与发布,通过 JFrog CLI(jf skills、jf agent plugins)和 JFrog Agent Guard 完成。
主要能力:按意图分派的参考文件包括:发现技能(浏览目录、列版本、按名称搜索)、安装/更新技能(显式解析版本与仓库、处理被阻止的下载)、查看与移除已安装技能、发布技能、发现插件、安装/更新插件、查看与移除已安装插件、发布插件。目录发现与仓库开通通过 npx --yes @jfrog/agent-guard 进行;<REGISTRY_URL> 默认取 JFROG_AGENT_GUARD_REPO,否则为 https://releases.jfrog.io/artifactory/api/npm/coding-agents-npm/,并向 Agent Guard 传 --server "<SID>"。
使用方式与前置条件:需先阅读基础 jfrog 技能(../jfrog/SKILL.md)以获取共享防护规则:首次 jf 调用前确认 jf 已安装、解析默认 <SID> 并在每次调用子命令后传 --server-id <SID>、单请求单服务器、出错即停止。可用 jf config show 解析默认服务器。禁止 cat 或解析 ~/.jfrog/jfrog-cli.conf.v6(可能含访问令牌)。项目 <PROJECT> 仅在 --list-skills、--list-skill-versions、--provision-skills-repository、--list-agent-plugins、--list-agent-plugin-versions、--provision-agent-plugins-repository 时需要,解析优先顺序为 ~/.jfrog/setup.json 的 .servers["<SID>"].currentActiveProject、再是 $JF_PROJECT,仍为空则询问用户。技能包需根目录含 SKILL.md,插件包需 plugin.json。
适用场景:需要浏览/搜索 JFrog AI Catalog 中的技能与插件、按版本安装或更新、查看与移除已安装项,以及向目录发布自有技能或插件时。
限制:安装、更新、移除通常在下一个 agent 会话启动时才生效,需提示用户重启。安装与列表偏读取,移除、registry 删除与发布为变更操作。技能发现始终受策略范围限制,不得弱化列举路径;每个 locations[] 条目带自身 allowStatus。插件不支持 Xray,插件操作需跳过所有 Xray 处理。不应向用户暴露 npx/Agent Guard 命令、--registry、标志或游标。回复模板需逐字使用。未提供具体命令细节处遵循上述参考文件。