SuperAPI AI 工具集

atlassian

办公与效率

查看项目

更新于 10-16 07:18

技能介绍

用途:该技能是 neo 插件的 acli 参考,用 acli(Atlassian CLI,安装于 /opt/homebrew/bin/acli)在终端驱动 Jira 与 Confluence。它相当于 acli --help 的薄封装,提供命令地图、JQL/工作流领域知识与安全规范。

主要能力:Jira 侧覆盖 auth(status/login/logout/switch)、workitem(view/search/create/create-bulk/edit/transition/assign/comment/clone/link/watcher/attachment/archive/unarchive/delete)、sprint、board、project、field/filter/dashboard 等;Confluence 侧覆盖 auth、page(仅 view)、space(list/view/create/update/archive/restore)、blog。

使用方式:先自发现,运行 acli <path> --help 自上而下遍历命令树,以已安装二进制的 --help 为准。认证:acli jira auth status 检查;未认证可用 API token:echo <token> | acli jira auth login --site "yoursite.atlassian.net" --email "you@example.com" --token,或浏览器 OAuth:acli jira auth login --web。缺失时安装:brew install atlassian/tap/acli。

安全规范:默认只读,view/search/--count 无需确认;任何批量变更前先用相同 JQL 执行 search --count 与 --fields "key,summary,status" 预览并获用户确认;破坏性操作需确认并列出受影响 key;写入后用 acli jira workitem view KEY-123 --json 复核;仅在用户确认后使用 --yes,批量加 --ignore-errors。

读取限制:查看或总结 Jira 工作项时,tested by 链接(issuelinks 中 type.name == "Tests")禁止跟进、抓取或提及;其他链接类型(Relates、Dependency、Blocks 等)正常读取,判断依据是链接类型而非目标类型。仅当用户后续明确要求时才可展示。

Confluence 限制:acli confluence page 只能查看,不能创建或更新页面;读取正文需显式请求:acli confluence page view --id <ID> --body-format storage --json | jq -r '.body.storage.value',默认用 storage,宏较多时可改用 --body-format view。创建/更新页面需直接用 Confluence REST API(curl);发布生成的 API 文档用 confluence-api-doc 技能。

输出技巧:--json 便于解析或串联,--csv 用于表格报告,--paginate 获取全部结果(project list 必需,覆盖 --limit),--fields 精简列。JQL 常用模式见 references/jql-patterns.md,多命令工作流见 references/workflows.md。