SuperAPI AI 工具集

acli

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:用一条命令在终端驱动 Jira Cloud、Confluence Cloud 与 org admin 操作,取代过去依赖原始 REST 调用完成的 Jira 自动化,适合作一次性命令、批量变更、脚本化流水线与 CI 任务。

主要能力:命令结构为 acli <product> [<feature>] <action> [flags]。产品面包括 jira(work item 的创建、搜索、转换、分配、评论、链接、附件列表/删除、归档等,以及 project、board、sprint、filter、dashboard、自定义字段定义)、confluence(space 完整 CRUD、blog 创建/列表/查看、page 只读查看)、admin(API key 认证、用户生命周期)、auth(全局 OAuth)、rovodev、feedback、config、completion。列表/搜索/查看命令支持默认表格、--json、--csv 三种输出。批量操作常用选择器 --key、--jql、--filter、--from-file,并配合 -y/--yes 跳过确认、--ignore-errors 不因单项失败中止。

用法:先用 API token 登录,例如 echo "$ATLASSIAN_API_TOKEN" | acli jira auth login --site "<your-site>.atlassian.net" --email "you@example.com" --token,再用 acli jira auth status 验证。搜索务必显式加 --paginate 或 --limit,否则仅返回第一页且无提示。富文本(描述、评论及富文本字段)以 ADF JSON 传入;acli 不转换 Markdown,需先用随附的 md-to-adf.ts(Bun 运行)把 Markdown 转为 ADF,例如 bun .agents/skills/acli/scripts/md-to-adf.ts input.md output.adf.json,转换默认带校验门禁,可用 --check 校验已组装的 ADF。

限制:认证按产品隔离,acli jira auth login 不会认证 admin、confluence 或 rovodev。未知子命令会静默回退到父级帮助并返回 0,不能以“无报错”判断命令存在。acli 无法列出自定义字段、无法编辑既有工作项的自定义字段值,也无法管理 workflow、issue type、project 版本/组件,不支持上传附件、添加关注者、把工作项加入 sprint。create 支持自定义字段富文本,edit 则硬性拒绝 additionalAttributes、fields 及 customfield_* 等自定义字段形状;更新既有工作项上的富文本自定义字段需改用 REST PUT。管理用户删除/取消删除不支持 --yes,应使用 --ignore-errors。媒体(图片/视频)不是 Markdown,需用 jira-attach-media.ts 先上传取得 UUID。分类:办公与效率。