章节 01
jr:为AI代理和开发者设计的Jira命令行工具
jr是一款专为AI代理和开发者打造的Jira CLI工具,旨在解决传统Jira客户端对自动化和可编程性支持不足的痛点。其核心特性包括纯JSON输出、结构化错误、语义化退出码、600多个从OpenAPI规范自动生成的命令,以及AI友好的工作流封装、批量操作、jq过滤等功能,为机器交互提供可靠支持。
正文
jr是一款专为AI代理和开发者打造的Jira CLI工具,提供纯JSON输出、结构化错误、语义化退出码和600多个从OpenAPI规范自动生成的命令,支持批量操作、工作流自动化和jq过滤。
章节 01
jr是一款专为AI代理和开发者打造的Jira CLI工具,旨在解决传统Jira客户端对自动化和可编程性支持不足的痛点。其核心特性包括纯JSON输出、结构化错误、语义化退出码、600多个从OpenAPI规范自动生成的命令,以及AI友好的工作流封装、批量操作、jq过滤等功能,为机器交互提供可靠支持。
章节 02
传统Jira客户端面向人类交互设计,存在交互式提示、格式化输出(表格、颜色)等特性,这些对追求自动化的开发者和AI代理来说是负担。jr的设计理念完全相反:优先考虑机器可解析性,stdout始终输出纯JSON,stderr提供结构化错误信息,退出码具有明确语义,确保AI代理能可靠调用并处理结果。
章节 03
{"error_type":"rate_limited","status":429,"retry_after":30})。章节 04
jr提供封装命令,让AI代理无需了解Jira内部ID即可操作:
jr workflow move --issue PROJ-123 --to "In Progress" --assign me(用可读状态名)jr workflow comment --issue PROJ-123 --text "Fixed in latest deploy"jr workflow create --project PROJ --type Bug --summary "Login broken" --priority High2h 30m)、冲刺管理(用名称而非ID)等。章节 05
echo '[{"command":"issue get",...}]' | jr batch),支持jq过滤。--jq参数提取所需字段(如jr issue get --issueIdOrKey PROJ-123 --jq '{key: .key, summary: .fields.summary}'),减少token消耗。jr watch --jql "project = PROJ" --interval 30s实时跟踪变化。jr diff --issue PROJ-123 --since 2h --field status监控字段变化。章节 06
{"allowed_operations": ["issue get", "search *", "workflow *"]})。jr raw GET /rest/api/3/myself处理边缘用例。章节 07
skill/jira-cli到Claude Code配置目录(cp -r skill/jira-cli ~/.claude/skills/)。