atlassian-skills Skill 技能

技能简介

atlassian-skills 是一套面向 Atlassian 数据中心版（Server/DC）环境的命令行工具，把 Jira、Confluence、Bitbucket 的常用操作重新实现为轻量 CLI，同时把同一套能力包装成 Claude Code、Codex、GitHub Copilot 可以直接加载的 Agent Skill。它要解决的痛点很具体：社区常用的 mcp-atlassian 在云端版表现良好，但在私有部署环境里，MCP 协议的 schema 协商与冗长响应会快速吃掉上下文预算，而且 Confluence 页面经过 XHTML 重新序列化后会悄悄丢失格式。

核心能力

• 会话开销极低：每个会话的 schema 开销从 MCP 的约 15000 token 降到 400 token 以下
• 响应体积压缩：命令返回体积只有 MCP 方案的百分之七到三十四，端到端完整工作流实测降低约百分之九十一
• Jira 四十五条命令：二十二条读取、二十三条写入，覆盖议题查询、创建、状态流转与评论
• Bitbucket 三十三条命令：十一条读取、二十二条写入，支持拉取请求流程、评论、任务与构建状态
• Confluence 无损往返：以可移植的托管 Markdown 作为唯一本地基线，配合与源页面绑定的校验证明，避免编辑时改坏排版
• 一条向导打通三个客户端：初始化命令一次性写入地址、令牌并安装 Agent Skill，无需重启终端
• 令牌存入操作系统钥匙串，支持多 profile 与环境变量覆盖，旧版本实例可退回基础认证

安装配置

• 安装：用 uv 工具安装（uv tool install atlassian-skills），或改用 pipx、pip 安装
• 初始化：在真实终端里执行初始化向导，按提示填入 Jira、Confluence、Bitbucket 地址与个人访问令牌
• 校验：执行诊断命令检查配置与鉴权状态
• 手工方案：使用 ATLS 开头的一组环境变量配置地址，用 JIRA_PERSONAL_TOKEN 等变量提供令牌

使用步骤

1. 在 Claude Code、Codex 或 Copilot 中提出自然语言需求，例如把一段需求拆成 Jira 子任务
2. Agent 调用对应命令，默认使用紧凑输出格式以节省 token
3. 只有需要阅读正文时才切换到 Markdown 格式，需要程序化解析时改用 JSON 格式
4. 按退出码分支处理：零为成功、三为权限不足、五为版本过期、六为鉴权失败、七为校验或迁移问题、十为网络错误、十一为限流
5. Confluence 编辑采用先拉取后推送的流程：先拉成 Markdown 基线，改完再推送

适用场景

• 私有部署 Jira 的团队让 AI 批量建单、改状态、写评论
• 需求文档放在 Confluence，希望 Agent 读完直接改写而不破坏排版
• 代码评审挂在 Bitbucket Server，需要 Agent 参与拉取请求讨论
• 内网环境 token 预算紧张，之前的 MCP 方案跑不动

适用人群

使用 Atlassian 数据中心版的企业研发团队、DevOps 工程师，以及需要把 Jira 与 Confluence 接进 AI 编程助手的团队。

工作原理

工具直接调用 Atlassian 各产品的 REST 接口，不经过 MCP 的 JSON-RPC 层，因此省掉了 schema 协商与冗长信封；输出侧默认做紧凑裁剪，只保留决策所需字段；Confluence 侧用托管 Markdown 作为本地基线，并通过校验证明绑定源页面版本，改动前后可以比对，避免 MCP 方案里 XHTML 重排造成的静默损坏。

官方链接

• PyPI：https://pypi.org/project/atlassian-skills/
• GitHub：https://github.com/eunsanMountain/atlassian-skills