atlassian-skills

LLM agent 的 Atlassian 轻量 CLI 替代方案

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:atlassian-skills。
它的用途是:LLM agent 的 Atlassian 轻量 CLI 替代方案
完整的 Skill 内容见:https://321skill.com/skills/atlassian-skills/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'使用 atlassian-skills 查询 Jira 项目 PROJ 中所有未完成的高优先级任务,以紧凑列表形式返回'。AI 会执行 atls jira issue list --project PROJ --status 'To Do,In Progress' --priority High 命令,并输出字段精简的任务列表,方便你快速了解项目阻塞点。

介绍

atlassian-skills 是一个专为 LLM 代理设计的命令行工具,用于高效操作 Atlassian Server/DC(Jira、Confluence、Bitbucket)。它解决了传统 MCP 协议在 Server/DC 环境下 Token 开销大、响应冗长的问题,并将 Confluence 的 XHTML 与 Markdown 双向转换做到无损,避免编辑时内容被静默篡改。

使用非常简单:通过 uv tool install atlassian-skills 安装后,运行 atls setup 交互式向导,即可一次性配置 URL、Token 以及 Claude Code、Codex、GitHub Copilot 的自动加载 Skill。配置完成后,你可以直接对 AI 说“查询 Jira 项目 XXX 的未完成任务”,AI 会自动调用 atls 命令输出紧凑结果。

适合需要频繁与 Atlassian 系统交互的团队,尤其是运维工程师、项目经理和全栈开发。如果你是 Atlassian Server/DC 用户,并且在使用 AI 辅助开发时希望大幅降低 Token 消耗、保持 Confluence 内容完整性,这个工具是理想选择。

注意:不支持 Atlassian Cloud 环境;安装依赖 Python 和 uv/pipx 包管理器。首次配置务必在终端中手动运行 atls setup,不要通过 AI 代理执行,否则可能泄露 Token。

核心特点

相比 mcp-atlassian,atlassian-skills 采用 CLI 而非 MCP 协议,端到端 Token 消耗降低 91%,且原生支持 Confluence 无损 Markdown 双向转换,避免编辑时内容被静默修改。

注意事项

仅适用于 Atlassian Server/DC(自托管),不支持 Atlassian Cloud 环境。

常见问题

如何安装 atlassian-skills?

推荐使用 uv tool install atlassian-skills,或 pipx install atlassian-skills / pip install atlassian-skills,之后运行 atls setup 完成配置。

与 mcp-atlassian 相比有什么优势?

Token 消耗降低 91%,Confluence 内容无损双向转换,支持 Bitbucket Server,且一键集成 Claude Code、Codex、GitHub Copilot。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/atlassian-skills/raw/index.md 读取 atlassian-skills 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。