用途：该技能用于与 Jira 交互，进行工单跟踪、检索与工作流管理。适合被要求查找 Jira 工单、检查待办、创建或更新工单、添加评论以及执行状态流转的场景。
安装与验证：先安装 Python 依赖，命令为 pip install --user requests keyring pyyaml pyadf。SKILL_DIR 指包含已加载 SKILL.md 的目录，运行命令前需将其设为该绝对路径；路径含空格时需加引号。安装后可运行 $SKILL_DIR/scripts/jira.py check 检查依赖、认证配置、Jira 连通性与 API 版本兼容性。
认证：支持两种方式。环境变量方式设置 JIRA_BASE_URL、JIRA_EMAIL、JIRA_API_TOKEN，可写入 ~/.bashrc 或 ~/.zshrc 持久化；或用配置文件 ~/.config/agent-skills/jira.yaml，包含 url、email、token。API Token 需在 Atlassian 账户安全页创建。还可配置 JQL 范围、字段、自定义字段与项目默认值，命令行参数始终覆盖配置默认值。
主要命令：search 使用 JQL 检索工单，支持 --contributor、--project、--max-results、--fields；issue 子命令可 get、comments、create、update、comment，建单需 --project、--type、--summary，并支持 --description、--priority、--labels、--assignee、--parent、--set-field、--link、--from-file、--json 等；transitions 提供 list 查看可用流转、do 执行流转并可用 --comment 加评论、--security-level 发私有评论。另有 config、fields、statuses、user、collaboration、automations（仅 Cloud）、versions 等命令。
JQL 与部署差异：JQL 常用模式见 jql-reference.md；Data Center/Server 若装有 ScriptRunner 可用 linkedIssuesOf()、subtasksOf()、commentedByUser() 等高级函数，Jira Cloud 不可用这些函数，应使用 Cloud 原生替代方案。用 statusCategory（To Do、In Progress、Done）可编写跨项目查询。
网络与限制：远程操作需对配置的 Jira 主机进行出站 HTTPS 访问，需先经所在环境的批准或网络管控授权；本地帮助与文件处理不需联网。技能说明本身不授予网络权限。DNS、连接、超时失败应报为网络错误，不要为此重置凭据；若已获批准仍失败应停止并上报。认证与权限错误需用户处理。该技能进行需要结构化输入输出的 API 调用，推荐使用标准能力模型。资料未提供收费、价格等其它信息。