用途:该技能面向 Atlassian Cloud 的 Confluence 与 Jira,帮助通过 REST API 读写 wiki 文档、空间、页面、评论、博客文章、附件,以及 Jira 项目、工单、用户、评论、标签、附件、工作日志等。适合在提到 Confluence 页面、Atlassian 或 wiki/文档管理时使用。
主要能力:Jira 侧支持获取当前用户、搜索用户、列出/获取项目、用 JQL 搜索工单、获取/创建/更新/删除工单、分配工单、查看与执行状态流转、增改评论、加标签、加附件、查看与添加工作日志。Confluence 侧使用 v2 API 管理空间(列表、详情、标签、权限)、页面(列表、详情、创建、创建子页、更新、删除、子页、标签、版本、附件、祖先)、页脚评论、博客文章与标签。
必要用法:请求需带环境变量 ATLASSIAN_DOMAIN、ATLASSIAN_EMAIL、ATLASSIAN_TOKEN,并使用 Basic 认证。示例:curl -s "https://$ATLASSIAN_DOMAIN.atlassian.net/rest/api/3/myself" -u "$ATLASSIAN_EMAIL:$ATLASSIAN_TOKEN" --header "Accept: application/json"。排查连接可运行 zero doctor check-connector --env-name ATLASSIAN_TOKEN,或用 zero doctor check-connector --url https://your-domain.atlassian.net/rest/api/3/myself --method GET。
关键限制与约定:Jira v3 富文本字段使用 ADF,Confluence 页面正文使用 XHTML storage 格式。更新页面必须提供并递增当前版本号。修改工单状态前先获取可用 transitions。用户引用使用 accountId。Jira 分页用 startAt + maxResults,Confluence v2 用 cursor + limit。遇到 429 应退避重试。CQL 搜索与附件上传仅能使用 v1 端点,无 v2 等价接口。收费、价格等信息资料暂未提供。