Jira事务管理

技能简介

该技能通过Jira Cloud REST API，在终端环境中完成事务搜索、状态变更、人员指派、评论添加、任务创建及工时登记等操作，适合需要快速处理Jira事务的开发与项目管理人员。

能做什么

• 模糊搜索事务摘要或编号
• 查看事务详情并生成浏览器链接
• 变更事务状态（自动校验可用流转）
• 指派事务给指定人员或自己
• 添加事务评论
• 创建新任务
• 登记工时并查询个人或团队工时统计

使用说明

安装依赖

确保系统已安装以下工具：

curl jq bc python3

配置环境变量

1. 访问 Atlassian API Token页面 创建令牌
2. 设置环境变量：

   export JIRA_EMAIL="you@example.com"
   export JIRA_API_TOKEN="your-api-token"
   export JIRA_URL="https://your-domain.atlassian.net"
   # 可选：限定项目范围
   export JIRA_BOARD="ABC"

常用命令示例

# 搜索事务
{baseDir}/scripts/jira.sh search "timeout" 10

# 变更状态
{baseDir}/scripts/jira.sh status ABC-123 "In Progress"

# 登记2.5小时工时
{baseDir}/scripts/jira.sh log ABC-123 2.5

# 查询某日期工时
{baseDir}/scripts/jira.sh hours-day 2025-01-07

输入与输出

见下方输入与输出表格。

风险提示

• 状态变更前会校验服务器提供的可用流转列表，但操作仍会影响实际项目数据
• 工时统计命令在大规模项目中可能耗时数秒
• API Token需妥善保管，避免泄露
• 删除或修改操作不可逆，建议先在测试环境验证

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/kyjus25/clawdbot-jira-skill/SKILL.md
来源类型：GitHub仓库