UiPath CLI 用户指南
技能是指令包,可教 AI 编码智能体如何使用uip构建 UiPath 自动化。它们不是工具。工具为 CLI 扩展了新命令;技能扩展了编码智能体的 UiPath 专属知识。开发者输入uip or jobs start ;安装了技能的编码智能体知道何时到达该命令、它需要什么输入,以及如何与uip solution pack 、 uip or packages upload等输入进行排序。
什么是技能
技能是一组 Markdown 文件(说明、示例、决策规则),智能体可以将其与您的对话一起读取,以决定如何完成 UiPath 任务。该捆绑包涵盖“如何打包和部署 Studio 项目”、“如何在 CI 中运行测试集”或“如何通过命令行配置 Orchestrator 触发器”等模式。智能体使用技能的方式与开发者使用文档相同,不同之处在于该技能仅涵盖技能作者认为相关的任务。
UiPath 在 GitHub 上发布技能目录。uip skills install会下载整个目录,并将其安装到您选择的智能体中。
支持的智能体
目前支持以下编码智能体:
| 代理 | 标志值 | 安装位置 |
|---|---|---|
| Claude 代码(插件) | claude | 由 Claude Code 插件系统管理 — 仅限全局 |
| 光标 | cursor | ~/.cursor/skills/<skill>/ (全局)或./.cursor/skills/<skill>/ (本地) |
| GitHub Copilot | copilot | ~/.github/skills/<skill>/ (全局)或./.github/skills/<skill>/ (本地) |
| Gemini CLI | gemini | ~/.gemini/skills/<skill>/ (全局)或./.gemini/skills/<skill>/ (本地) |
| 抄送 | codex | ~/.agents/skills/<skill>/ (全局)或./.agents/skills/<skill>/ (本地)— 打开的智能体技能标准目录 |
| 打开代码 | opencode | ~/.config/opencode/skills/<skill>/ (全局)或./.opencode/skills/<skill>/ (本地) |
在写入任何文件之前, uip skills install --agent <name>会打印确切的目标位置。运行uip skills --help以查看安装的实时表。
粒度:智能体,而非技能
uip skills install在技能目录中是“要么全有,要么全无” 。您选择一个或多个智能体,然后 CLI 会将 UiPath 当前发布的每项技能安装到这些智能体中。您无需选取个人技能。
原因:技能集太小,挑选技能会产生更多的不一致之处,而非收益,智能体本身会根据自己的推理决定将哪种技能应用于给定任务——技能目录实际上是智能体在执行任务时会查阅的参考与 UiPath 相关。为智能体提供它不会使用的额外技能,开销较低。
您选择的内容:
- 哪些智能体(通过
--agent <name>指定,或在省略标志时以交互方式从复选框中选择多选)。 - 全局或局部作用域(在智能体支持的情况下,通过
--local)。
全局安装与本地安装
两个作用域:
- 全局(默认)— 在用户的智能体配置文件上为每个用户安装一次技能。可用于该计算机上的每个项目。
- 本地(
--local) — 技能安装到当前目录中。与项目一起跟踪;仅当智能体在该目录中运行时可用。
对于将技能固定到特定 UiPath CLI 版本的项目,或对于应向每个参与者提供特定技能集的存储库,请使用“本地”。
并非每个智能体都支持--local 。Claude Code仅在全局范围内(Claude Code 插件系统为用户作用域);运行uip skills install --agent claude --local会生成ValidationError 。其他五个智能体支持这两个作用域。
运行uip skills install --local时,CLI 还会将磁盘存储( .uipath/.skills/ ,在临时根目录下)添加到.gitignore ,因此不会提交缓存的技能捆绑包。
安装、更新、卸载
以下三个命令用于管理生命周期:
uip skills install --agent claude # install globally for Claude Code
uip skills install --agent cursor --local # install into this project for Cursor
uip skills install # interactive: pick agents from a checkbox
uip skills update --agent claude # re-fetch and reinstall
uip skills uninstall --agent claude # remove skills for Claude Code only
uip skills install --agent claude # install globally for Claude Code
uip skills install --agent cursor --local # install into this project for Cursor
uip skills install # interactive: pick agents from a checkbox
uip skills update --agent claude # re-fetch and reinstall
uip skills uninstall --agent claude # remove skills for Claude Code only
当省略--agent时,所有这三种模式都会以交互方式提示输入目标智能体,这在工作站上很方便,但在 CI 中则存在问题——始终在管道中传递标志。
update还会删除自上次安装后从远程目录中删除的技能,因此安装的智能体会随着目录的变化而跟踪目录。在安装和更新时会写入或覆盖每个智能体的技能文件。
智能体如何使用技能
安装后,每个智能体都将通过自己的机制读取技能文件:
- Claude Code通过插件系统加载技能——它们变成了智能体可以调用的工具使用插件。
- Cursor 、 Gemini CLI 、 Codex 、 OpenCode将技能 Markdown 作为上下文规则附加到每个对话。
- GitHub Copilot从其 user-rules 目录中读取技能。
从开发者的角度来看,差异是不可见的。您要求智能体“打包并部署此项目”,如果一项技能涵盖该技能,则智能体将按照制定的准则进行操作 — 按顺序调用uip solution pack 、 uip solution publish 、 uip solution deploy run ,处理标志选择,然后返回报告。
哪些技能不存在
- 技能不会取代文档。他们提炼出面向任务的方法;完整的参考位于
uip文档(此站点)中。拥有技能的智能体仍然可以通过阅读每个命令的参考页面来受益。 - 技能不会授予智能体访问 UiPath 租户的权限。它们指导智能体如何使用
uip;实际的身份验证通过在您的计算机上进行uip login与您自己运行命令时相同。 - 技能不是工具。
uip tools和uip skills是不同的命令组。工具交付命令;技能会指导智能体如何使用。 - 技能不是模型上下文协议 (MCP) 服务器。
uip mcp为 MCP 感知客户端公开了单独的 MCP 界面。技能系统是 1.x 中的主要 AI 集成路径; MCP 可用于专门设置,但不是主要集成。
后续内容
- 将 UiPath CLI 与编码智能体结合使用— 设置每个智能体、验证安装以及以端到端的方式运行任务的演练。
- uip 技能参考— 标志、退出代码和完整示例。
- 管理工具和技能— 日常生命周期、固定、审核已安装的内容。
- 工具(插件) — 其他扩展机制;解释了“工具”和“技能”之间的区别。