UiPath Documentation
uipath-cli
latest
false
UiPath CLI 用户指南
重要 :
请注意,此内容已使用机器翻译进行了本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。

UIP 技能

"uipkills" 的语法和选项,用于安装、更新和删除 UiPath 编码智能体技能包。

uip skills可以为受支持的 AI 编码智能体安装、更新和删除 UiPath技能。技能是精心策划的提示包,用于教智能体如何使用 UiPath 的 CLI 工具构建自动化、智能体、流和编排。请参阅技能,了解其概念、安装模式以及各个智能体的安装位置。

此页面记录了这些命令。有关什么是技能以及为什么要安装技能,请先阅读概念页面。

大纲​

uip skills list      [--local] [--repo <url>] [--branch <name>]
uip skills search    <query> [--local] [--limit <n>] [--repo <url>] [--branch <name>]
uip skills show      <name> [--local] [--repo <url>] [--branch <name>]
uip skills install   [--agent <agent>] [--skip-if-no-agent] [--local] [--path <dir>] [--repo <url>] [--branch <name>] [--force]
uip skills update    [--agent <agent>] [--local]
uip skills uninstall [--agent <agent>] [--local]
uip skills list      [--local] [--repo <url>] [--branch <name>]
uip skills search    <query> [--local] [--limit <n>] [--repo <url>] [--branch <name>]
uip skills show      <name> [--local] [--repo <url>] [--branch <name>]
uip skills install   [--agent <agent>] [--skip-if-no-agent] [--local] [--path <dir>] [--repo <url>] [--branch <name>] [--force]
uip skills update    [--agent <agent>] [--local]
uip skills uninstall [--agent <agent>] [--local]

所有uip skills子命令均采用全局选项( --output 、 --output-filter 、 --log-level 、 --log-file )。退出代码遵循标准合同。

支持的智能体: claude 、 cursor 、 copilot 、 codex 、 opencode 、 autopilot 、 kiro 、 windsurf 、 antigravity 、 devin 。部分智能体只有全局安装路径;其他人则支持本地(每个项目)和全局。对从实时注册表生成的每个智能体的目标表运行 uip skills install --help。

UIP 技能列表​

列出已配置目录中的可用技能(默认为 UiPath 技能存储库,或通过 --repo 生成另一个技能存储库)。只读— 不安装任何内容或修改智能体配置。

参数​

无。

选项​

  • --local — 读取当前项目的本地技能存储库,而非全局技能存储库。
  • --repo <url> — 改为列出来自其他存储库的技能:GitHub owner/repo、https/git URL 或本地目录,例如 ./skills。默认为 UiPath 技能存储库。
  • --branch <name> — 从 --repo 获取的分支。

示例​

uip skills list
uip skills list

数据形状 ( --output json ) ​

{
  "Code": "SkillsList",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Count": 2,
    "Skills": [
      {
        "Name": "uipath-agents",
        "Description": "Build and deploy UiPath agents",
        "SkillPath": "uipath-agents/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-agents/SKILL.md"
      },
      {
        "Name": "uipath-rpa",
        "Description": "Build UiPath automations",
        "SkillPath": "uipath-rpa/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}
{
  "Code": "SkillsList",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Count": 2,
    "Skills": [
      {
        "Name": "uipath-agents",
        "Description": "Build and deploy UiPath agents",
        "SkillPath": "uipath-agents/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-agents/SKILL.md"
      },
      {
        "Name": "uipath-rpa",
        "Description": "Build UiPath automations",
        "SkillPath": "uipath-rpa/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}

Shadowed 列出了在发现过程中丢弃的技能,因为同一来源中的另一项技能使用了相同的名称,该技能在此处可见,而不是静默消失。

按目标或关键字搜索技能目录,并返回最接近的匹配项。只读。

参数​

名称必填用途
<query>是自由文本搜索查询。

选项​

  • --local — 查看list 。
  • --limit <n> — 的最大结果数量。默认为 10。
  • --repo <url> — 查看list 。
  • --branch <name> — 查看list 。

示例​

uip skills search "create a queue and deploy a process"
uip skills search "create a queue and deploy a process"

数据形状 ( --output json ) ​

{
  "Code": "SkillsSearch",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Query": "create a queue and deploy a process",
    "Count": 1,
    "Skills": [
      {
        "Name": "uipath-platform",
        "Description": "UiPath platform and Orchestrator ops",
        "SkillPath": "uipath-platform/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-platform/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}
{
  "Code": "SkillsSearch",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Query": "create a queue and deploy a process",
    "Count": 1,
    "Skills": [
      {
        "Name": "uipath-platform",
        "Description": "UiPath platform and Orchestrator ops",
        "SkillPath": "uipath-platform/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-platform/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}

UIP 技能显示​

完整显示一项技能的目录条目。只读。

参数​

名称必填用途
<name>是技能名称,介于 list 或 search 中。匹配不区分大小写。

选项​

  • --local — 查看list 。
  • --repo <url> — 查看list 。
  • --branch <name> — 查看list 。

未知名称失败,显示 ValidationError,指向 list/search 才能查找有效的名称。

示例​

uip skills show uipath-rpa
uip skills show uipath-rpa

数据形状 ( --output json ) ​

{
  "Code": "SkillsShow",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Skill": {
      "Name": "uipath-rpa",
      "Description": "Build UiPath automations",
      "SkillPath": "uipath-rpa/SKILL.md",
      "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
    }
  }
}
{
  "Code": "SkillsShow",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Skill": {
      "Name": "uipath-rpa",
      "Description": "Build UiPath automations",
      "SkillPath": "uipath-rpa/SKILL.md",
      "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
    }
  }
}

UIP 技能安装​

从 UiPath 下载技能,并将其安装到所选智能体的配置中。默认情况下,写入用户的主目录;传递 --local,以安装在当前项目下。传递 --repo 以从另一个 GitHub/git 存储库或本地目录安装,而不是从 UiPath 技能存储库安装。

参数​

无。

选项​

  • --agent <agent> — 以单个智能体为目标(claude、cursor、copilot、codex、opencode、autopilot、kiro、windsurf、antigravity、devin)。否则,CLI 会使用复选框选取器以交互方式提示。系统已在选取器中隐藏当前作用域不支持的智能体。
  • --skip-if-no-agent — 当计算机上未检测到受支持的智能体时,成功退出(无错误,Installed: 0),而不是提示或失败。
  • --local — 安装到当前项目目录,而不是用户主目录。智能体仅支持全局路径,已被拒绝。
  • --path <dir> — 安装到特定项目目录中。隐式 --local。
  • --repo <url> — 从其他技能存储库安装:GitHub owner/repo、https/git URL 或本地目录,例如 ./skills。默认为 UiPath 技能存储库。
  • --branch <name> — 从 --repo 获取的分支。默认为该存储库的默认分支。
  • --force — 从全新状态重新安装 — 在重新安装之前重置 Claude Code 市场注册和插件缓存。

示例​

# Install for Claude Code (global)
uip skills install --agent claude

# Install for Cursor, scoped to the current project
uip skills install --agent cursor --local

# Install from another repo for Cursor
uip skills install --repo my-org/my-skills --agent cursor

# Install into a specific project directory (implies --local)
uip skills install --agent autopilot --path ./my-project --repo mattpocock/skills

# Interactive picker
uip skills install
# Install for Claude Code (global)
uip skills install --agent claude

# Install for Cursor, scoped to the current project
uip skills install --agent cursor --local

# Install from another repo for Cursor
uip skills install --repo my-org/my-skills --agent cursor

# Install into a specific project directory (implies --local)
uip skills install --agent autopilot --path ./my-project --repo mattpocock/skills

# Interactive picker
uip skills install

数据形状 ( --output json ) ​

{
  "Code": "SkillsInstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Installed": 2
  }
}
{
  "Code": "SkillsInstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Installed": 2
  }
}
  • RootDir — 编写技能时的基本目录(用户主目录表示全局,项目目录表示--local/--path)。
  • Skills — 从配置的来源获取的技能缩略名。
  • Agents — 此运行的目标智能体。
  • Installed — 成功安装的(智能体,技能)对数量。
  • Shadowed(非空时)— 在发现期间丢弃的同名技能,如 {Name, IgnoredPath}。
  • Conflicts(非空时)— 已跳过每个智能体的技能,因为另一个来源已经安装了同名的技能 {Agent, Name, OwnedBy}。

当 --skip-if-no-agent 触发时,响应会改为报告 Skipped: true,Reason 和 Message 以及 Skills/Agents 为空。

备注:

--agent autopilot安装次数多于技能项。Autopilot 会镜像 Claude Code 的磁盘布局,因此其安装还会将目录的 hooks/ 文件夹复制为 skills/ 的同级文件夹(例如~/.autopilot/hooks/)。其他所有受支持的智能体仅安装 skills/。这不会反映在上面的 Skills/Installed 字段中 — 这些字段计算技能,而不计算额外文件夹。

先决条件​

网络访问权限以及git 。在 Windows 上,可以使用 PowerShell 解压缩技能;在 macOS/Linux 上,它使用unzip 。如果缺少这些内容,命令将失败,并显示Failure结果,指向违规的先决条件。

UIP 技能更新​

从 UiPath 重新获取技能并重新安装。安装新的技能集后,CLI 会修剪不再存在于注册表中的所有技能,因此update还会清理磁盘上已弃用的技能。

参数​

无。

选项​

  • --agent <agent> — 查看install 。
  • --local — 查看install 。

示例​

uip skills update --agent claude
uip skills update --agent claude

数据形状 ( --output json ) ​

{
  "Code": "SkillsUpdate",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Updated": 2
  }
}
{
  "Code": "SkillsUpdate",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Updated": 2
  }
}

Updated是重新安装的(智能体,技能)对数量;过时的条目将被单独静默删除。

卸载 UIP 技能​

从智能体配置中删除先前安装的技能,并更新本地清单文件。uninstall不执行任何网络调用 — 它依赖于install / update编写的清单文件来了解存在哪些技能。

参数​

无。

选项​

  • --agent <agent> — 查看install 。如无此设置,CLI 会以交互方式提示。传递未知智能体失败,显示ValidationError 。
  • --local — 从当前项目中删除而不是用户主页中删除。

示例​

uip skills uninstall --agent claude
uip skills uninstall --agent claude

数据形状 ( --output json ) ​

{
  "Code": "SkillsUninstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Uninstalled": 2
  }
}
{
  "Code": "SkillsUninstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Uninstalled": 2
  }
}

故障模式​

  • 未找到清单文件(从未安装任何内容,或已手动删除): ConfigError ,以及运行uip skills install的说明。
  • 对智能体配置目录的写入权限: Failure ,包含文件权限提示。CLI 将退出,并显示代码 1。
  • 用户取消交互式智能体选取器:根据标准合同,CLI 退出并显示代码 130 (SIGINT)。
  • 技能— 什么是技能、智能体支持矩阵以及它们与工具的区别。
  • 身份验证— 对于skills不是必需的;注册表已公开。
  • uip mcp — 不支持技能的 MCP 感知智能体的辅助路径。

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新