mcpField
A
atlassian-cli

atlassian-cli

github.com/onnokh生产力2218 次安装39 周前更新
代码仓库

关于 atlassian-cli

atlassian-cli 是一项技能，指导通过终端中的 `acli` 操作 Atlassian Cloud 工作流，涵盖 Jira、Admin 和 Rovo Dev，并说明命令发现、身份验证与机器可读自动化。

主要功能

  1. 01发现命令与参数
  2. 02Token、OAuth 和管理员 API 密钥指引
  3. 03JSON 与 CSV 自动化模式
  4. 04批量操作错误处理
  5. 05Shell 补全与故障排查

适用场景

  1. 01自动执行 Jira Cloud 任务
  2. 02在 CI 中运行 Atlassian 命令
  3. 03使用 jq 处理命令输出
  4. 04处理批量操作的部分成功

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/onnokh/atlassian-cli --skill atlassian-cli

安装后在 Claude Code 中输入/atlassian-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
.gitignore
references/
troubleshooting.md
auth.md
shell-completion.md
install.md
automation.md

详细介绍

Atlassian CLI (acli)

使用 acli，可在终端中自动化并操作 Atlassian Cloud 工作流（Jira、Admin 和 Rovo Dev）。

工作流

  1. 安装或升级 acli（选择适用于操作系统的方式）。
  2. 进行身份验证（选择令牌、OAuth 或管理员 API 密钥）。
  3. 使用 acli help ... 和 --help 查找准确的命令和标志。
  4. 自动化时优先使用机器可读的输出（--json）；使用 jq 解析。
  5. 在适当情况下，使用 --ignore-errors 处理批量操作；出现意外错误时，记录跟踪 ID。

决策树

安装 / 升级
Which OS?
  macOS:
    - Preferred: Homebrew
    - Fallback: download binary + put on PATH
  Linux:
    - Preferred: apt (Debian/Ubuntu) or yum (RHEL/CentOS)
    - Fallback: download binary to /usr/local/bin or ~/.local/bin
  Windows:
    - Download acli.exe via PowerShell (Invoke-WebRequest)
Upgrade:
  - Homebrew: brew upgrade acli
  - apt/yum: upgrade package
  - binary installs: re-download and replace

请阅读 references/install.md，了解准确的命令。

身份验证
What are you trying to access?
  Jira Cloud:
    - API token (non-interactive, CI-friendly)
    - OAuth (interactive): acli jira auth login --web
  Atlassian Admin (org admin):
    - API key (admin commands)
  Rovo Dev:
    - API token login, then: acli rovodev run

请阅读 references/auth.md，了解准确的登录命令。

密钥处理（默认执行）

  • 避免直接在命令行中填写令牌或密钥。
  • 优先使用来自密钥存储或 CI 密钥变量的标准输入。
  • 切勿将令牌或密钥输出到日志、差异或聊天记录中。

命令查找方式

  • 查看顶层帮助：acli --help
  • 查看产品帮助：acli jira --help、acli admin --help、acli rovodev --help
  • 查看深入帮助：acli jira workitem create --help
  • 不确定命令的位置时，使用 acli help [path]。

自动化模式

  • 后续步骤必须在成功后才运行时，使用 && 链接命令。
  • 将表格输出（--csv）重定向到文件。
  • 使用 --json | jq ... 提取特定字段。

请阅读 references/automation.md。

Shell 补全

为 bash/zsh/fish/powershell 启用补全。

请阅读 references/shell-completion.md。

故障排除

  • 出现意外错误时，记录跟踪 ID，以便提交支持工单。
  • 对于可接受部分成功的批量操作，使用 --ignore-errors。
  • 对于支持 JSON 驱动工作流的命令，使用 --generate-input-json / --generate-json。

请阅读 references/troubleshooting.md。

参考资料

  • references/install.md
  • references/auth.md
  • references/automation.md
  • references/shell-completion.md
  • references/troubleshooting.md

评论

支持 Markdown