Back to Details

atlassian

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Atlassian Skill

Atlassian 技能

Jira operations via 
acli
, Confluence operations via REST API script.
借助
acli
进行Jira操作，借助REST API脚本进行Confluence操作。

1. Environment Setup

1. 环境设置

1.1. Required Environment Variables

1.1. 所需环境变量

sh
ATLASSIAN_SITE=https://your-instance.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_TOKEN=your-api-token
sh
ATLASSIAN_SITE=https://your-instance.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_TOKEN=your-api-token

1.2. API Token Creation

1.2. API令牌创建

  1. Access https://id.atlassian.com/manage-profile/security/api-tokens
  2. Click "Create API token"
  3. Select "Create classic API token" (NOT scoped)
Classic tokens work with both acli and REST API scripts.
  1. 访问 https://id.atlassian.com/manage-profile/security/api-tokens
  2. 点击「创建API令牌」
  3. 选择「创建经典API令牌」（不要选择范围限定的）
经典令牌可同时用于acli和REST API脚本。

2. Jira Operations (acli)

2. Jira操作（acli）

2.1. Authentication

2.1. 认证

sh
undefined
sh
undefined

Check status

检查状态

acli jira auth status
acli jira auth status

Login (if needed)

登录（如需）

acli jira auth login
undefined
acli jira auth login
undefined

2.2. Work Items

2.2. 工作项

sh
undefined
sh
undefined

View issue

查看问题

acli jira workitem view <ISSUE-KEY>
acli jira workitem view <ISSUE-KEY>

Search issues (JQL)

搜索问题（JQL）

acli jira workitem search --jql "assignee = currentUser() AND status = 'In Progress'"
acli jira workitem search --jql "assignee = currentUser() AND status = 'In Progress'"

Create issue

创建问题

acli jira workitem create --project <PROJECT> --type Task --summary "Title"
acli jira workitem create --project <PROJECT> --type Task --summary "Title"

Transition issue

流转问题状态

acli jira workitem transition <ISSUE-KEY> --transition "Done"
acli jira workitem transition <ISSUE-KEY> --transition "Done"

Add comment

添加评论

acli jira workitem comment add <ISSUE-KEY> --body "Comment text"
undefined
acli jira workitem comment add <ISSUE-KEY> --body "Comment text"
undefined

2.3. Boards and Sprints

2.3. 看板与迭代

sh
undefined
sh
undefined

List boards

列出看板

acli jira board list
acli jira board list

List sprints

列出迭代

acli jira sprint list --board <BOARD-ID>
undefined
acli jira sprint list --board <BOARD-ID>
undefined

2.4. Common JQL Patterns

2.4. 常用JQL模式

text
undefined
text
undefined

Recently updated (last 7 days)

最近更新（过去7天）

updated >= -7d AND assignee = currentUser()
updated >= -7d AND assignee = currentUser()

In progress issues

进行中的问题

status = "In Progress" AND project = <PROJECT>
status = "In Progress" AND project = <PROJECT>

Created this week

本周创建的问题

created >= startOfWeek() AND project = <PROJECT>
undefined
created >= startOfWeek() AND project = <PROJECT>
undefined

2.5. Date Range Search

2.5. 日期范围搜索

sh
undefined
sh
undefined

Today's activities

今日活动

acli jira workitem search
--jql "updated >= startOfDay() AND (assignee = currentUser() OR reporter = currentUser()) ORDER BY updated DESC"
--fields "key,summary,status"
acli jira workitem search
--jql "updated >= startOfDay() AND (assignee = currentUser() OR reporter = currentUser()) ORDER BY updated DESC"
--fields "key,summary,status"

Specific date range (YYYY-MM-DD)

指定日期范围（YYYY-MM-DD）

acli jira workitem search
--jql "updated >= '2026-01-20' AND updated < '2026-01-21' AND (assignee = currentUser() OR reporter = currentUser()) ORDER BY updated DESC"
--fields "key,summary,status"
acli jira workitem search
--jql "updated >= '2026-01-20' AND updated < '2026-01-21' AND (assignee = currentUser() OR reporter = currentUser()) ORDER BY updated DESC"
--fields "key,summary,status"

Relative days

相对天数

acli jira workitem search
--jql "updated >= -7d AND assignee = currentUser() ORDER BY updated DESC"
--fields "key,summary,status"

JQL date functions:

| Function      | Description        |
| ------------- | ------------------ |
| startOfDay()  | Today 00:00        |
| startOfWeek() | This week's Monday |
| -1d, -7d      | Relative days      |
| 'YYYY-MM-DD'  | Specific date      |
acli jira workitem search
--jql "updated >= -7d AND assignee = currentUser() ORDER BY updated DESC"
--fields "key,summary,status"

JQL日期函数：

| 函数          | 描述                |
| ------------- | ------------------- |
| startOfDay()  | 今日00:00           |
| startOfWeek() | 本周一              |
| -1d, -7d      | 相对天数            |
| 'YYYY-MM-DD'  | 指定日期            |

3. Confluence Operations (Script)

3. Confluence操作（脚本）

3.1. Convert Page to Markdown

3.1. 将页面转换为Markdown

sh
uvx --with requests --with beautifulsoup4 --with html2text \
    python ~/ghq/github.com/i9wa4/dotfiles/config/agents/skills/atlassian/scripts/confluence-to-md.py <confluence_url>
Output: 
~/Downloads/{timestamp}-confluence-{title}.md
sh
uvx --with requests --with beautifulsoup4 --with html2text \
    python ~/ghq/github.com/i9wa4/dotfiles/config/agents/skills/atlassian/scripts/confluence-to-md.py <confluence_url>
输出文件：
~/Downloads/{timestamp}-confluence-{title}.md

3.2. URL Format

3.2. URL格式

text
https://your-instance.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title
text
https://your-instance.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title

3.3. Features

3.3. 功能特性

  • Preserves bullet list structure
  • Converts draw.io diagrams to full URL
  • Maintains code blocks
  • Aligns table columns
  • 保留项目符号列表结构
  • 将draw.io图表转换为完整URL
  • 保留代码块
  • 对齐表格列