该技能用于对接 Atlassian 生态(Jira、Confluence、Bitbucket),覆盖项目管理自动化、文档工作流与源代码控制操作,并支持跨产品自动化。
认证方式:使用 API Token。需设置环境变量 ATLASSIAN_DOMAIN、ATLASSIAN_EMAIL、ATLASSIAN_API_TOKEN;令牌在 id.atlassian.com 的 API tokens 页面创建。可用 curl 调用 /rest/api/3/myself 验证认证。
Jira 能力:获取、创建、更新问题;按 JQL 搜索(服务端过滤,建议加 project/assignee/sprint 约束);添加评论;查询与执行问题状态流转;Sprint 管理(需 Jira Software,含获取看板活动 Sprint、把问题移入 Sprint);Epic 与故事层级查询、问题链接(如 Blocks)。注意 v3 API 的描述字段使用 Atlassian Document Format(ADF)。
Confluence 能力:按空间获取页面、创建页面(storage 表示格式)、更新页面(需当前版本号)、用 CQL 搜索内容;支持宏与模板(如 info 宏、指定父页面)。
Bitbucket 能力:列出仓库、创建拉取请求(含目标分支与审查者)、查看 PR 状态。
MCP 配置:在 mcpServers 中注册 atlassian,命令为 npx -y @atlassian/mcp-atlassian,并传入上述环境变量;可加入 .claude/settings.json。配置后提供 jira_get_issue、jira_create_issue、jira_update_issue、jira_search_issues、jira_transition_issue、confluence_get_page、confluence_create_page、confluence_update_page、confluence_search 等工具。
跨产品工作流:可从 git 分支名提取 Jira 问题键并流转状态;可由 Sprint 问题生成 Confluence 报告页。
限制与注意:Jira 与 Confluence Cloud 约每秒 10 次请求,遇到 429 需指数退避重试;自定义字段需用 customfield_ 编号并通过字段接口查询;实时更新建议用 Webhook 而非轮询;自动化宜用专用服务账号令牌。脚本中未提供具体价格、平台版本或效果数据。