SuperAPI AI 工具集

orca-jira

办公与效率

查看项目

更新于 10-16 04:07

技能介绍

Orca Jira 是 stablyai/orca 提供的一个技能,用于通过 Orca 的 CLI 处理 Jira 事务。根据资料,它适用于以下场景:从已关联的 Jira 事务开展工作、以 PR/MR 链接和完成评论收尾工作、移动事务状态等。

该技能是一个发现入口(discovery stub),其作用是加载与当前会话所用 Orca 可执行文件版本匹配的指南。

使用方式:

首先需要确定本次会话应使用的 CLI 可执行文件,并在此后的所有命令中复用同一个可执行文件。选择规则如下:

  1. 如果设置了 ORCA_CLI_COMMAND 环境变量,则使用其值。Orca 会为受管理的 WSL 会话导出该变量。
  2. 否则,在会话暴露 ORCA_DEV_REPO_ROOT 的开发检出(dev checkout)中,使用 orca-dev。
  3. 否则,在 Orca 管理的终端之外的 Linux 上,使用 orca-ide。资料特别提示:在那里绝不要运行裸 orca,因为在 Orca 的终端之外,它通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca),并会在用户机器上启动语音。
  4. 否则,使用 orca。

资料中 ORCA 是所选可执行文件的占位符,运行任何命令前需先替换它,不要创建 shell 变量,也不要字面运行 ORCA。该方式在 POSIX shell、PowerShell 和 cmd.exe 中同样适用。

如果所选可执行文件无法运行,应报告其确切错误并停止,不要回退到另一个可执行文件,否则可能静默地指向不同的 Orca 构建。

在运行 Orca 命令前,先加载版本匹配的指南:

ORCA skills get orca-jira

优先使用 --json。对于指南未覆盖的命令或标志,使用所选可执行文件的 --help。如果命令报告 Orca 未运行,则用 ORCA open --json 启动它并重试。如果失败并返回 runtime_access_denied,说明沙箱阻止了连接:应以提升的权限重新运行,且不要运行 ORCA open 或重启 Orca。如果 skills get 未知,应说明更新 Orca 可恢复该指南;使用 --help 进行只读发现,不要猜测不受支持的命令。

限制与注意事项:

  • 该技能依赖 Orca 可执行文件及其版本匹配的指南。
  • 需注意在 Linux 非 Orca 管理终端中不要运行裸 orca,以免误启动 GNOME Orca 屏幕阅读器。
  • 所选可执行文件无法运行时不应回退到其他可执行文件。
  • 遇到 runtime_access_denied 时不应运行 ORCA open 或重启 Orca。
  • 关于收费、价格、平台支持范围、具体效果等信息,资料暂未提供。