jira-communication

jira-communication 技能为 Atlassian Jira 环境（包含云端版与服务器/Data Center 版）提供了强大的 CLI 接口。此技能专为偏好在终端作业的开发者与项目经理所设计，通过 uv 管理的专用 Python 脚本执行各项操作。当 MCP 工具无法使用或需要对 Jira API 进行更精细的控制时，它可作为强大的替代方案。通过针对 Jira 网址与项目工单编号（如 PROJ-123）的自动触发机制，它能实现无缝且具备情境感知的工作流程，减少手动切换任务的需求。

• 完整支持核心工单管理作业，包含创建、更新、移动、转换状态与删除工单。

• 先进的搜索能力，利用 Jira 查询语言 (JQL) 根据状态、指派对象或自定义标准来筛选工单。

• 整合工时追踪功能，可直接在 CLI 中新增与查询工时记录。

• 全面的敏捷管理工具，用于查询冲刺 (Sprint) 数据、看板内容与版本发布。

• 附件处理功能，支持与工单关联之文件的安全上传与下载。

• 公用程序功能，可管理工单链接、观察者、用户信息与自定义字段查询。

• 情境感知验证与设置脚本，确保环境变量与 API 凭证设置正确。

• 此技能依赖 uv 管理依赖项并执行脚本，执行环境需具备 Python 3.10+。

• 验证支持 JIRA_URL、JIRA_USERNAME 与 API Token，配置文件统一使用 .env.jira 或 profiles.json。

• 执行更新或删除等破坏性操作时，应搭配 --dry-run 标志以预览变更，避免意外操作。

• 输出格式可使用 --json 进行切换，以便与后续的数据处理工具或脚本进行整合。

• 本工具针对 Jira Wiki 标记语法设计，若涉及复杂格式内容，建议搭配 jira-syntax 技能使用。

• 实施安全性最佳实践，包含附件下载的 SSRF 防护以及通过 --debug 模式进行标准化错误报告。