Jira Access — Jira 访问权限

Jira Access Skill 概述 本技能为 Jira 的 REST API 提供了一个薄包装。它使助手能够： 列出带有 JQL 过滤器的问题 创建新问题 在状态之间转换问题 添加评论或附件 所有操作都使用通过环境变量提供的凭据执行，以避免在源代码控制中存储机密。

设置 在技能运行的运行时环境中设置环境变量。 对于 PowerShell（推荐）： $env:JIRA_DOMAIN = "omeshkshatriya.atlassian.net" $env:JIRA_EMAIL = "omeshkshatriya@gmail.com" $env:JIRA_API_TOKEN = "ATATT3xFfGF0cks7fxnFIDe..." #完整令牌（不要截断） 对于命令提示符（cmd.exe）： set JIRA_DOMAIN=omeshkshatriya.atlassian.net set JIRA_EMAIL=omeshkshatriya@gmail.com set JIRA_API_TOKEN=ATATT3xFfGF0cks7fxnFIDe... #完整令牌（不要截断） 安全注意事项：不要将这些值提交到存储库。将它们保存在安全配置文件、.env 文件或 CI 密钥存储中。 确保在 Windows 上安装 Python 3.9+ 并安装所需的依赖项： pip install requests

使用 该技能通过 jira 命令（一个简单的批处理包装器）调用，后面跟着子命令： jira list "project = OMESH" – 列出匹配 JQL 查询的问题。 jira create "Bug" "Summary" "Description" – 创建一个新问题类型为 Bug。 jira transition – 将问题移动到新状态。 jira comment "Your comment" – 添加评论。 示例 在 jira-access 文件夹中创建一个小批处理包装器 jira.bat，将参数转发到 Python 脚本： @echo off python "%~dp0scripts\jira_cli.py" %* jira list "assignee = currentUser() AND status = Open" 将输出一个表格，显示分配给当前用户的开放问题。

实现细节 核心逻辑位于 scripts/jira_cli.py。它读取环境变量，构建 HTTP 请求，并以 JSON 格式打印结果。 该脚本故意保持最小，以保持技能的轻量级。

扩展技能 在 jira_cli.py 中为批量操作添加更多子命令。 在 references/ 下为高级 JQL 模式创建参考文件。 如果需要，在 assets/ 中存储可重用的有效负载模板。

何时不使用 如果用户要求在 Jira 之外执行操作（例如 Confluence、Bitbucket），则不应触发此技能。

参考 Jira REST API 文档 GitHub CLI API