acli-jira 命令行工具：从终端高效管理 Jira Cloud 工单与项目

acli-jira by arjunmahishi/dotfiles

69 周安装量

11 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/arjunmahishi/dotfiles --skill acli-jira

项目管理自动化命令行工具

🇨🇳中文介绍

目的

当您需要与 Jira 交互时使用此技能：读取工单、创建新的工作项、更新现有项、使用 JQL 搜索、转换状态、分配任务、添加评论或浏览项目。acli jira 提供了从 CLI 全面管理 Jira Cloud 的功能。

何时使用何种命令

acli jira workitem view：通过键值查看特定工单。用于读取工单详情、描述、状态、负责人等。
acli jira workitem search：使用 JQL 查询查找工单。用于任何搜索、筛选或列出工作项。
acli jira workitem create：创建新工单。当用户想要提交错误、任务、故事或史诗时使用。
acli jira workitem edit：修改现有工单的摘要、描述、标签、类型或负责人。
acli jira workitem transition：将工单移动到新状态（例如，“进行中”、“已完成”）。
acli jira workitem assign：更改或移除工单的负责人。
acli jira workitem comment create：向工单添加评论。

广告位招租

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

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

联系我们

相关 Skills

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

4,000,000 周安装

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

142,000 周安装

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

47,200 周安装

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

46,900 周安装

acli jira workitem comment list：读取工单上的评论。

acli jira project list：列出可用项目。用于发现项目键值。

acli jira project view：查看特定项目的详细信息。

acli jira sprint list-workitems：列出冲刺中的工单（需要 --sprint 和 --board ID）。

acli jira board search：按名称或关键字查找看板。

在读取命令上始终使用 --json（view、search、comment list、project list 等）以获取机器可读的输出。
在变更命令上始终使用 --yes（edit、transition、assign）以跳过在非交互式 shell 中会挂起的交互式确认提示。
JQL（Jira 查询语言）用于搜索。通过 --jql "..." 传递。
@me 是已认证用户的简写（在 --assignee 中有效）。
标签是逗号分隔的：--label "bug,backend,urgent"。
工作项类型 使用 Jira 问题类型：Task、Bug、Story、Epic、Sub-task 等。通过 --type 传递。
键值是带项目前缀的 ID，如 PROJ-123。多个键值用逗号分隔：--key "PROJ-1,PROJ-2"。

发现项目：acli jira project list --json 以查找可用的项目键值。
搜索工单：acli jira workitem search --jql "project = PROJ AND ..." --json 以查找相关的工作项。
查看工单：acli jira workitem view PROJ-123 --json 以读取完整详情。
根据需要，使用以下命令进行创建/编辑/状态转换。

# 项目中所有未关闭的工单
--jql "project = PROJ AND status != Done"

# 分配给我的工单
--jql "assignee = currentUser()"

# 本周创建的 Bug
--jql "project = PROJ AND type = Bug AND created >= startOfWeek()"

# 带有特定标签的工单
--jql "project = PROJ AND labels = backend"

# 按摘要文本搜索
--jql "project = PROJ AND summary ~ \"search term\""

# 高优先级的未关闭项
--jql "project = PROJ AND priority in (High, Highest) AND status != Done"

# 最近更新的工单
--jql "project = PROJ AND updated >= -7d ORDER BY updated DESC"

acli jira workitem view PROJ-123 --json

# 仅查看特定字段
acli jira workitem view PROJ-123 --fields "summary,status,assignee,labels,comment" --json

# 使用 JQL 搜索，获取 JSON 输出
acli jira workitem search --jql "project = PROJ AND status = 'In Progress'" --json

# 使用特定字段和结果限制进行搜索
acli jira workitem search --jql "project = PROJ AND assignee = currentUser()" \
  --fields "key,summary,status,priority,labels" --limit 20 --json

# 获取匹配工单的数量
acli jira workitem search --jql "project = PROJ AND type = Bug" --count

# 基本创建
acli jira workitem create \
  --project "PROJ" \
  --type "Task" \
  --summary "实现功能 X" \
  --description "详细描述在此" \
  --label "backend,feature" \
  --assignee "@me" \
  --json

# 创建带有父项（子任务）的 Bug
acli jira workitem create \
  --project "PROJ" \
  --type "Bug" \
  --summary "修复登录超时" \
  --description "用户报告登录页面在 30 秒后超时" \
  --label "bug,auth" \
  --parent "PROJ-100" \
  --json

# 从文件创建描述
acli jira workitem create \
  --project "PROJ" \
  --type "Story" \
  --summary "用户引导流程" \
  --description-file description.txt \
  --json

# 编辑摘要和标签
acli jira workitem edit --key "PROJ-123" \
  --summary "更新后的摘要" \
  --labels "backend,urgent" \
  --yes --json

# 更改负责人
acli jira workitem edit --key "PROJ-123" \
  --assignee "user@company.com" \
  --yes --json

# 移除标签
acli jira workitem edit --key "PROJ-123" \
  --remove-labels "stale" \
  --yes --json

# 移动到“进行中”
acli jira workitem transition --key "PROJ-123" --status "In Progress" --yes --json

# 标记为“已完成”
acli jira workitem transition --key "PROJ-123" --status "Done" --yes --json

# 转换多个工单
acli jira workitem transition --key "PROJ-1,PROJ-2,PROJ-3" --status "Done" --yes --json

# 分配给自己
acli jira workitem assign --key "PROJ-123" --assignee "@me" --yes --json

# 分配给其他人
acli jira workitem assign --key "PROJ-123" --assignee "user@company.com" --yes --json

# 移除负责人
acli jira workitem assign --key "PROJ-123" --remove-assignee --yes --json

# 添加评论
acli jira workitem comment create --key "PROJ-123" --body "此任务已准备好进行评审"

# 列出评论
acli jira workitem comment list --key "PROJ-123" --json

# 列出所有项目
acli jira project list --json

# 查看特定项目
acli jira project view --key "PROJ" --json

# 列出最近查看的项目
acli jira project list --recent --json

# 查找看板
acli jira board search --name "我的团队" --json

# 列出看板上的冲刺
acli jira board list-sprints --id 42 --json

# 列出冲刺中的工单
acli jira sprint list-workitems --sprint 101 --board 42 --json

创建工单时，如果尚未知晓，请务必向用户询问项目键值。使用 acli jira project list --json 来发现可用项目。
创建工单时，根据上下文推断适当的标签（例如，代码库的区域、工作类型）。标签有助于可发现性。
对于所有读取操作，优先使用 --json 输出，以便您可以解析并为用户总结结果。
在所有写入操作上使用 --yes 以避免交互式提示。
对于大型结果集，使用 --limit 来限制结果，或使用 --paginate 来获取所有内容。
用于状态转换的状态名称是项目特定的。如果转换失败，错误消息将列出有效的状态。
要设置自定义字段（未作为 CLI 标志公开），请使用带有 additionalAttributes 的 --from-json。使用 acli jira workitem create --generate-json 生成模板。

对于项目特定的看板约定（必填字段、自定义字段映射、标签、模板），请阅读文件 ~/.config/opencode/skills/acli-jira/boards.md（如果存在）。它包含在已知看板上创建或管理工单之前所需的看板特定约定。

这使得看板约定可以保持私有（不签入版本控制），而核心技能保持公开。

🇺🇸English

Purpose

Use this skill when you need to interact with Jira: reading tickets, creating new work items, updating existing ones, searching with JQL, transitioning status, assigning, commenting, or browsing projects. acli jira provides full Jira Cloud management from the CLI.

When to use what

acli jira workitem view: View a specific ticket by key. Use to read ticket details, description, status, assignee, etc.
acli jira workitem search: Find tickets using JQL queries. Use for any search, filtering, or listing of work items.
acli jira workitem create: Create a new ticket. Use when the user wants to file a bug, task, story, or epic.
acli jira workitem edit: Modify an existing ticket's summary, description, labels, type, or assignee.
acli jira workitem transition: Move a ticket to a new status (e.g., "In Progress", "Done").
acli jira workitem assign: Change or remove a ticket's assignee.
acli jira workitem comment create: Add a comment to a ticket.
acli jira workitem comment list: Read comments on a ticket.
acli jira project list: List available projects. Use to discover project keys.
acli jira project view: View details of a specific project.
acli jira sprint list-workitems: List tickets in a sprint (requires --sprint and --board IDs).
acli jira board search: Find boards by name or keyword.

Core concepts

Always use--json on read commands (view, search, comment list, project list, etc.) to get machine-readable output.
Always use--yes on mutation commands (edit, transition, assign) to skip interactive confirmation prompts that would hang in a non-interactive shell.
JQL (Jira Query Language) is used for searching. Pass it via --jql "...".

Recommended workflow

Discover projects : acli jira project list --json to find available project keys.
Search for tickets : acli jira workitem search --jql "project = PROJ AND ..." --json to find relevant work items.
View a ticket : acli jira workitem view PROJ-123 --json to read full details.
Create/edit/transition as needed using the commands below.

Common JQL patterns

# All open tickets in a project
--jql "project = PROJ AND status != Done"

# Tickets assigned to me
--jql "assignee = currentUser()"

# Bugs created this week
--jql "project = PROJ AND type = Bug AND created >= startOfWeek()"

# Tickets with a specific label
--jql "project = PROJ AND labels = backend"

# Search by summary text
--jql "project = PROJ AND summary ~ \"search term\""

# High priority open items
--jql "project = PROJ AND priority in (High, Highest) AND status != Done"

# Recently updated
--jql "project = PROJ AND updated >= -7d ORDER BY updated DESC"

Examples

View a ticket

acli jira workitem view PROJ-123 --json

# View specific fields only
acli jira workitem view PROJ-123 --fields "summary,status,assignee,labels,comment" --json

Search for tickets

# Search with JQL, get JSON output
acli jira workitem search --jql "project = PROJ AND status = 'In Progress'" --json

# Search with specific fields and a result limit
acli jira workitem search --jql "project = PROJ AND assignee = currentUser()" \
  --fields "key,summary,status,priority,labels" --limit 20 --json

# Get count of matching tickets
acli jira workitem search --jql "project = PROJ AND type = Bug" --count

Create a ticket

# Basic creation
acli jira workitem create \
  --project "PROJ" \
  --type "Task" \
  --summary "Implement feature X" \
  --description "Detailed description here" \
  --label "backend,feature" \
  --assignee "@me" \
  --json

# Create a bug with a parent (sub-task)
acli jira workitem create \
  --project "PROJ" \
  --type "Bug" \
  --summary "Fix login timeout" \
  --description "Users report timeout after 30s on the login page" \
  --label "bug,auth" \
  --parent "PROJ-100" \
  --json

# Create with description from a file
acli jira workitem create \
  --project "PROJ" \
  --type "Story" \
  --summary "User onboarding flow" \
  --description-file description.txt \
  --json

Edit a ticket

# Edit summary and labels
acli jira workitem edit --key "PROJ-123" \
  --summary "Updated summary" \
  --labels "backend,urgent" \
  --yes --json

# Change assignee
acli jira workitem edit --key "PROJ-123" \
  --assignee "user@company.com" \
  --yes --json

# Remove labels
acli jira workitem edit --key "PROJ-123" \
  --remove-labels "stale" \
  --yes --json

Transition a ticket

# Move to In Progress
acli jira workitem transition --key "PROJ-123" --status "In Progress" --yes --json

# Mark as Done
acli jira workitem transition --key "PROJ-123" --status "Done" --yes --json

# Transition multiple tickets
acli jira workitem transition --key "PROJ-1,PROJ-2,PROJ-3" --status "Done" --yes --json

Assign a ticket

# Assign to self
acli jira workitem assign --key "PROJ-123" --assignee "@me" --yes --json

# Assign to someone else
acli jira workitem assign --key "PROJ-123" --assignee "user@company.com" --yes --json

# Remove assignee
acli jira workitem assign --key "PROJ-123" --remove-assignee --yes --json

Comments

# Add a comment
acli jira workitem comment create --key "PROJ-123" --body "This is ready for review"

# List comments
acli jira workitem comment list --key "PROJ-123" --json

Projects

# List all projects
acli jira project list --json

# View a specific project
acli jira project view --key "PROJ" --json

# List recently viewed projects
acli jira project list --recent --json

Sprints and boards

# Find a board
acli jira board search --name "My Team" --json

# List sprints on a board
acli jira board list-sprints --id 42 --json

# List tickets in a sprint
acli jira sprint list-workitems --sprint 101 --board 42 --json

Important tips

When creating tickets, always ask the user for the project key if not already known. Use acli jira project list --json to discover available projects.
When creating tickets, infer appropriate labels from context (e.g., the area of the codebase, the type of work). Labels help with discoverability.
Prefer --json output for all read operations so you can parse and summarize results for the user.
Use --yes on all write operations to avoid interactive prompts.
For large result sets, use --limit to cap results or --paginate to fetch everything.
Status names for transitions are project-specific. If a transition fails, the error message will list valid statuses.
To set custom fields (not exposed as CLI flags), use --from-json with additionalAttributes. Generate a template with acli jira workitem create --generate-json.

Board-specific conventions

For project-specific board conventions (required fields, custom field mappings, labels, templates), read the file ~/.config/opencode/skills/acli-jira/boards.md if it exists. It contains board-specific conventions needed before creating or managing tickets on known boards.

This allows board conventions to be kept private (not checked into version control) while the core skill remains public.

Weekly Installs

Repository

arjunmahishi/dotfiles

GitHub Stars

First Seen

Feb 13, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex37

github-copilot36

opencode35

gemini-cli34

amp34

kimi-cli34

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

46,800 周安装

@me is a shorthand for the authenticated user (works in --assignee).

Labels are comma-separated: --label "bug,backend,urgent".

Work item types use Jira issue types: Task, Bug, Story, Epic, Sub-task, etc. Pass via --type.

Keys are project-prefixed IDs like PROJ-123. Multiple keys are comma-separated: --key "PROJ-1,PROJ-2".

acli-jira 命令行工具：从终端高效管理 Jira Cloud 工单与项目

🇨🇳中文介绍

目的

何时使用何种命令

相关 Skills

核心概念

推荐工作流

常见 JQL 模式

示例

查看工单

搜索工单

创建工单

编辑工单

转换工单状态

分配工单

评论

项目

冲刺和看板

重要提示

看板特定约定