Back to Details

jira-communication

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Jira Communication

Jira 操作脚本

CLI scripts for Jira operations using 
uv run
. All scripts support 
--help
, 
--json
, 
--quiet
, 
--debug
.
使用
uv run
执行的Jira操作CLI脚本。所有脚本均支持
--help
、
--json
、
--quiet
、
--debug
参数。

Auto-Trigger

自动触发

Trigger when user mentions:
  • Jira URLs: 
    https://jira.*/browse/*
    , 
    https://*.atlassian.net/browse/*
  • Issue keys: 
    PROJ-123
    , 
    NRS-4167
When triggered by URL → extract issue key → run 
jira-issue.py get PROJ-123
当用户提及以下内容时触发：
  • Jira URL：
    https://jira.*/browse/*
    、
    https://*.atlassian.net/browse/*
  • 问题键：
    PROJ-123
    、
    NRS-4167
通过URL触发时 → 提取问题键 → 执行
jira-issue.py get PROJ-123

Auth Failure Handling

认证失败处理

When auth fails, offer: 
uv run scripts/core/jira-setup.py
(interactive credential setup)
当认证失败时，提供：
uv run scripts/core/jira-setup.py
（交互式凭证设置）

Scripts

脚本列表

ScriptPurpose
scripts/core/jira-setup.py
Interactive credential config
scripts/core/jira-validate.py
Verify connection
scripts/core/jira-issue.py
Get/update issue details
scripts/core/jira-search.py
Search with JQL
scripts/core/jira-worklog.py
Time tracking
scripts/core/jira-attachment.py
Download attachments
scripts/workflow/jira-create.py
Create issues
scripts/workflow/jira-transition.py
Change status
scripts/workflow/jira-comment.py
Add comments
scripts/workflow/jira-sprint.py
List sprints
scripts/workflow/jira-board.py
List boards
scripts/utility/jira-user.py
User info
scripts/utility/jira-fields.py
Search fields
scripts/utility/jira-link.py
Issue links
脚本用途
scripts/core/jira-setup.py
交互式凭证配置
scripts/core/jira-validate.py
验证连接
scripts/core/jira-issue.py
获取/更新问题详情
scripts/core/jira-search.py
使用JQL搜索
scripts/core/jira-worklog.py
工作时长记录
scripts/core/jira-attachment.py
下载附件
scripts/workflow/jira-create.py
创建问题
scripts/workflow/jira-transition.py
变更问题状态
scripts/workflow/jira-comment.py
添加评论
scripts/workflow/jira-sprint.py
列出迭代（sprint）
scripts/workflow/jira-board.py
列出看板
scripts/utility/jira-user.py
获取用户信息
scripts/utility/jira-fields.py
搜索字段
scripts/utility/jira-link.py
问题链接管理

Critical: Flag Ordering

重要提示：参数顺序

Global flags MUST come before subcommand:
bash
undefined
全局参数必须放在子命令之前：
bash
undefined

Correct: uv run scripts/core/jira-issue.py --json get PROJ-123

正确写法： uv run scripts/core/jira-issue.py --json get PROJ-123

Wrong: uv run scripts/core/jira-issue.py get PROJ-123 --json

错误写法： uv run scripts/core/jira-issue.py get PROJ-123 --json

undefined
undefined

Quick Examples

快速示例

bash
uv run scripts/core/jira-validate.py --verbose
uv run scripts/core/jira-search.py query "assignee = currentUser()"
uv run scripts/core/jira-issue.py get PROJ-123
uv run scripts/core/jira-worklog.py add PROJ-123 2h --comment "Work done"
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run
bash
uv run scripts/core/jira-validate.py --verbose
uv run scripts/core/jira-search.py query "assignee = currentUser()"
uv run scripts/core/jira-issue.py get PROJ-123
uv run scripts/core/jira-worklog.py add PROJ-123 2h --comment "Work done"
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run

Related Skills

相关技能

jira-syntax: For descriptions/comments. Jira uses wiki markup, NOT Markdown.
jira-syntax：用于编写描述/评论。Jira使用wiki标记语言，而非Markdown。

References

参考资料

  • references/jql-quick-reference.md
    - JQL syntax
  • references/troubleshooting.md
    - Setup and auth issues
  • references/jql-quick-reference.md
    - JQL语法参考
  • references/troubleshooting.md
    - 安装与认证问题排查

Authentication

认证方式

Cloud: 
JIRA_URL
+ 
JIRA_USERNAME
+ 
JIRA_API_TOKEN
Server/DC: 
JIRA_URL
+ 
JIRA_PERSONAL_TOKEN
Config via 
~/.env.jira
or env vars. Run 
jira-validate.py --verbose
to verify.
Cloud版：
JIRA_URL
+ 
JIRA_USERNAME
+ 
JIRA_API_TOKEN
Server/数据中心版：
JIRA_URL
+ 
JIRA_PERSONAL_TOKEN
可通过
~/.env.jira
文件或环境变量配置。执行
jira-validate.py --verbose
验证配置。