Atlassian REST API 技能：Jira 与 Confluence 自动化操作指南

atlassian by boazy/skills

1 周安装量

GitHub

安装命令

npx skills add https://github.com/boazy/skills --skill atlassian

项目管理自动化 API

🇨🇳中文介绍

Atlassian 技能

通过 REST API 直接访问 Jira 和 Confluence。此技能为问题单和页面提供了完整的 CRUD 操作，无需 MCP 服务器。

身份验证

需要在 ~/.local/secrets/atlassian.env 文件中设置环境变量：

ATLASSIAN_SITE - 您的 Atlassian 站点（例如：yourcompany.atlassian.net）
ATLASSIAN_EMAIL - 您的 Atlassian 账户邮箱
ATLASSIAN_API_TOKEN - 来自 https://id.atlassian.com/manage-profile/security/api-tokens 的 API 令牌

可用脚本

Jira

搜索问题单

npx tsx scripts/jira-search.ts "<JQL 查询语句>" [maxResults] [nextPageToken]

示例：

npx tsx scripts/jira-search.ts "assignee = currentUser() AND status != Done"

🇺🇸English

Atlassian Skill

Access Jira and Confluence directly via REST APIs. This skill provides full CRUD operations for issues and pages without requiring the MCP server.

Authentication

Requires environment variables in ~/.local/secrets/atlassian.env:

ATLASSIAN_SITE - Your Atlassian site (e.g., yourcompany.atlassian.net)
ATLASSIAN_EMAIL - Your Atlassian account email
ATLASSIAN_API_TOKEN - API token from https://id.atlassian.com/manage-profile/security/api-tokens

Available Scripts

Jira

Search Issues

npx tsx scripts/jira-search.ts "<JQL query>" [maxResults] [nextPageToken]

Examples:

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

117,000 周安装

GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题

30,000 周安装

开源项目教练指南 - 诊断问题、制定行动计划、优化开源项目运营

29,800 周安装

npx tsx scripts/jira-search.ts "project = PROJ AND type = Bug" 50

npx tsx scripts/jira-search.ts "project = PROJ" 50 "token..." (分页)

有关 JQL 语法参考，请参阅 docs/jql-guide.md。

获取问题单详情

npx tsx scripts/jira-get.ts <issueKey>

示例：npx tsx scripts/jira-get.ts PROJ-123

npx tsx scripts/jira-create.ts '<JSON>'

创建单个问题单：

npx tsx scripts/jira-create.ts '{"project": "PROJ", "type": "Story", "summary": "新功能", "description": "详情在此"}'

批量创建（数组）：

npx tsx scripts/jira-create.ts '[{"project": "PROJ", "type": "Bug", "summary": "Bug 1"}, {"project": "PROJ", "type": "Bug", "summary": "Bug 2"}]'

npx tsx scripts/jira-update.ts <issueKey> '<JSON updates>'

示例：npx tsx scripts/jira-update.ts PROJ-123 '{"status": "In Progress", "assignee": "user@example.com"}'

# 获取评论
npx tsx scripts/jira-comment.ts <issueKey> get

# 添加评论
npx tsx scripts/jira-comment.ts <issueKey> add "<comment text>"

npx tsx scripts/jira-attachment.ts <issueKey> <filePath> [fileName]

npx tsx scripts/jira-attachment.ts PROJ-123 ./diagram.png
npx tsx scripts/jira-attachment.ts PROJ-123 ./image.png architecture.png

图片嵌入说明：

对于 Markdown 图片语法（![alt](url)），转换器仅对 Atlassian 托管的 URL 使用 mediaSingle。
外部图片 URL 会回退为可点击的链接，以避免 Jira 的 INVALID_INPUT 错误。
如果您想要嵌入图片，请先使用 jira-attachment.ts 上传文件，然后在您的 Markdown 图片 URL 中使用返回的 Atlassian contentUrl。

npx tsx scripts/confluence-search.ts "<CQL 查询语句>" [maxResults]

npx tsx scripts/confluence-search.ts "title ~ 'Roadmap'"
npx tsx scripts/confluence-search.ts "space = DEV AND type = page" 25

有关 CQL 语法参考，请参阅 docs/cql-guide.md。

npx tsx scripts/confluence-get.ts <pageId>
# 或通过标题获取
npx tsx scripts/confluence-get.ts "<page title>" <spaceKey>

npx tsx scripts/confluence-create.ts '<JSON>'

npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "新页面", "body": "<p>内容在此</p>"}'

npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "子页面", "body": "<p>内容</p>", "parentId": "123456"}'

npx tsx scripts/confluence-update.ts <pageId> '<JSON updates>'

示例：npx tsx scripts/confluence-update.ts 123456 '{"title": "更新后的标题", "body": "<p>新内容</p>"}'

# 列出属性
npx tsx scripts/confluence-properties.ts <pageId> get

# 获取单个属性
npx tsx scripts/confluence-properties.ts <pageId> get <propertyKey>

# 设置属性
npx tsx scripts/confluence-properties.ts <pageId> set '<JSON>'

# 删除属性
npx tsx scripts/confluence-properties.ts <pageId> delete <propertyKey>

# 获取页面表情符号
npx tsx scripts/confluence-properties.ts <pageId> get-emoji

# 设置页面表情符号（同时更新 emoji-title-published 和 emoji-title-draft）
npx tsx scripts/confluence-properties.ts <pageId> set-emoji "🚀"

# 移除页面表情符号
npx tsx scripts/confluence-properties.ts <pageId> remove-emoji

属性负载示例：

'{"key": "my-property", "value": {"foo": "bar"}}'
'{"properties": [{"key": "one", "value": 1}, {"key": "two", "value": "two"}]}'

注意：页面的 CRUD 操作使用 Confluence REST API v2。CQL 搜索仍使用旧版端点，因为 v2 API 未公开 CQL 搜索功能。

用于生成正确的查询语句：

Jira : 阅读 docs/jql-guide.md 了解 JQL 语法、字段、运算符和函数
Confluence : 阅读 docs/cql-guide.md 了解 CQL 语法和字段

查找并更新我的未完成任务单

搜索：npx tsx scripts/jira-search.ts "assignee = currentUser() AND status != Done"
更新：npx tsx scripts/jira-update.ts PROJ-123 '{"status": "Done"}'

从列表创建问题单

批量创建：npx tsx scripts/jira-create.ts '[{...}, {...}, {...}]'

查找并阅读文档

搜索：npx tsx scripts/confluence-search.ts "title ~ 'API Documentation'"
获取内容：npx tsx scripts/confluence-get.ts 123456

创建新的文档页面

创建：npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "API 指南", "body": "<h1>API 指南</h1><p>...</p>"}'

npx tsx scripts/jira-search.ts "assignee = currentUser() AND status != Done"
npx tsx scripts/jira-search.ts "project = PROJ AND type = Bug" 50
npx tsx scripts/jira-search.ts "project = PROJ" 50 "token..." (pagination)

See docs/jql-guide.md for JQL syntax reference.

npx tsx scripts/jira-get.ts <issueKey>

Example: npx tsx scripts/jira-get.ts PROJ-123

npx tsx scripts/jira-create.ts '<JSON>'

npx tsx scripts/jira-create.ts '{"project": "PROJ", "type": "Story", "summary": "New feature", "description": "Details here"}'

Bulk create (array):

npx tsx scripts/jira-create.ts '[{"project": "PROJ", "type": "Bug", "summary": "Bug 1"}, {"project": "PROJ", "type": "Bug", "summary": "Bug 2"}]'

npx tsx scripts/jira-update.ts <issueKey> '<JSON updates>'

Example: npx tsx scripts/jira-update.ts PROJ-123 '{"status": "In Progress", "assignee": "user@example.com"}'

# Get comments
npx tsx scripts/jira-comment.ts <issueKey> get

# Add comment
npx tsx scripts/jira-comment.ts <issueKey> add "<comment text>"

npx tsx scripts/jira-attachment.ts <issueKey> <filePath> [fileName]

npx tsx scripts/jira-attachment.ts PROJ-123 ./diagram.png
npx tsx scripts/jira-attachment.ts PROJ-123 ./image.png architecture.png

Image embedding note:

For markdown image syntax (![alt](url)), the converter uses mediaSingle only for Atlassian-hosted URLs.
External image URLs fall back to a clickable link to avoid Jira INVALID_INPUT errors.
If you want embedded images, upload the file first with jira-attachment.ts, then use the returned Atlassian contentUrl in your markdown image URL.

npx tsx scripts/confluence-search.ts "<CQL query>" [maxResults]

npx tsx scripts/confluence-search.ts "title ~ 'Roadmap'"
npx tsx scripts/confluence-search.ts "space = DEV AND type = page" 25

See docs/cql-guide.md for CQL syntax reference.

npx tsx scripts/confluence-get.ts <pageId>
# or by title
npx tsx scripts/confluence-get.ts "<page title>" <spaceKey>

npx tsx scripts/confluence-create.ts '<JSON>'

npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "New Page", "body": "<p>Content here</p>"}'

Optional parent page:

npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "Child Page", "body": "<p>Content</p>", "parentId": "123456"}'

npx tsx scripts/confluence-update.ts <pageId> '<JSON updates>'

Example: npx tsx scripts/confluence-update.ts 123456 '{"title": "Updated Title", "body": "<p>New content</p>"}'

Page Properties (v2)

# List properties
npx tsx scripts/confluence-properties.ts <pageId> get

# Get a single property
npx tsx scripts/confluence-properties.ts <pageId> get <propertyKey>

# Set a property
npx tsx scripts/confluence-properties.ts <pageId> set '<JSON>'

# Delete a property
npx tsx scripts/confluence-properties.ts <pageId> delete <propertyKey>

# Get page emoji
npx tsx scripts/confluence-properties.ts <pageId> get-emoji

# Set page emoji (updates both emoji-title-published and emoji-title-draft)
npx tsx scripts/confluence-properties.ts <pageId> set-emoji "🚀"

# Remove page emoji
npx tsx scripts/confluence-properties.ts <pageId> remove-emoji

Example property payloads:

'{"key": "my-property", "value": {"foo": "bar"}}'
'{"properties": [{"key": "one", "value": 1}, {"key": "two", "value": "two"}]}'

Note: Page CRUD uses the Confluence REST API v2. CQL search still uses the legacy endpoint because the v2 API does not expose CQL search.

Query Language References

For generating correct queries:

Jira : Read docs/jql-guide.md for JQL syntax, fields, operators, and functions
Confluence : Read docs/cql-guide.md for CQL syntax and fields

Find and update my open issues

Search: npx tsx scripts/jira-search.ts "assignee = currentUser() AND status != Done"
Update: npx tsx scripts/jira-update.ts PROJ-123 '{"status": "Done"}'

Create issues from a list

Bulk create: npx tsx scripts/jira-create.ts '[{...}, {...}, {...}]'

Find and read documentation

Search: npx tsx scripts/confluence-search.ts "title ~ 'API Documentation'"
Get content: npx tsx scripts/confluence-get.ts 123456

Create a new documentation page

Create: npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "API Guide", "body": "<h1>API Guide</h1><p>...</p>"}'

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

29,800 周安装

Atlassian REST API 技能：Jira 与 Confluence 自动化操作指南

🇨🇳中文介绍

Atlassian 技能

身份验证

可用脚本

Jira

搜索问题单

🇺🇸English

Atlassian Skill

Authentication

Available Scripts

Jira

Search Issues

相关 Skills

获取问题单详情

创建问题单

更新问题单

评论

上传附件

Confluence

搜索页面

获取页面内容

创建页面

更新页面

页面属性 (v2)

查询语言参考

常见工作流

查找并更新我的未完成任务单

从列表创建问题单

查找并阅读文档

创建新的文档页面

Get Issue Details

Create Issue

Update Issue

Comments

Upload Attachment

Confluence

Search Pages

Get Page Content

Create Page

Update Page

Page Properties (v2)

Query Language References

Common Workflows

Find and update my open issues

Create issues from a list

Find and read documentation

Create a new documentation page

最新 Skills