360 Secure SkillHub
360 安全技能中心

Jira Access

封装 Jira REST API 的轻量 Skill，凭环境变量中的域名、邮箱与令牌，借助 Python 脚本以命令行子命令执行 JQL 查询、创建 issue、流转状态和添加评论，结果以 JSON 或表格文本输出；需 Python 3.9+ 与 requests，示例面向 Windows。

brajesh9373
brajesh9373
热度 78.46
最近更新 2026-05-20 03:37:05
分类：协作依赖：代码执行 / 第三方 API应用场景：任务管理 / API 集成 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add jira-access
Metadata
name
jira-access
description
Access a Jira workspace (omeshkshatriya.atlassian.net) using provided email and API token to list, create, and transition issues. Use when the user wants to interact with their Jira instance via commands like "list open bugs" or "create a task". Trigger on any request that mentions Jira operations.

Jira Access Skill

Overview

This skill provides a thin wrapper around Jira's REST API. It enables the assistant to:

  • List issues with JQL filters
  • Create new issues
  • Transition issues between statuses
  • Add comments or attachments

All operations are performed using the credentials supplied via environment variables to avoid storing secrets in source control.

Setup

  1. Set environment variables in the runtime where the skill runs. For PowerShell (recommended):

    $env:JIRA_DOMAIN = "omeshkshatriya.atlassian.net"
$env:JIRA_EMAIL = "omeshkshatriya@gmail.com"
$env:JIRA_API_TOKEN = "ATATT3xFfGF0cks7fxnFIDe..."   # full token (do not truncate)

    For Command Prompt (cmd.exe):

    set JIRA_DOMAIN=omeshkshatriya.atlassian.net
set JIRA_EMAIL=omeshkshatriya@gmail.com
set JIRA_API_TOKEN=ATATT3xFfGF0cks7fxnFIDe...   # full token (do not truncate)

    Security note: Do not commit these values to the repository. Keep them in a secure profile, a .env file, or a CI secret store.

  2. Ensure Python 3.9+ is installed on Windows and install the required dependency:

    pip install requests

Usage

The skill is invoked through the jira command (a simple batch wrapper) followed by a sub‑command:

  • jira list "project = OMESH" – List issues matching a JQL query.
  • jira create "Bug" "Summary" "Description" – Create a new issue of type Bug.
  • jira transition <ISSUE-KEY> <STATUS> – Move an issue to a new status.
  • jira comment <ISSUE-KEY> "Your comment" – Add a comment.

Example

Create a small batch wrapper jira.bat in the jira-access folder to forward arguments to the Python script:

@echo off
python "%~dp0scripts\jira_cli.py" %*

jira list "assignee = currentUser() AND status = Open"

Will output a table of open issues assigned to the current user.

Implementation Details

The core logic lives in scripts/jira_cli.py. It reads the environment variables, builds HTTP requests, and prints JSON‑formatted results. The script is deliberately minimal to keep the skill lightweight.

Extending the Skill

  • Add more sub‑commands in jira_cli.py for bulk operations.
  • Create reference files under references/ for advanced JQL patterns.
  • Store reusable payload templates in assets/ if needed.

When Not to Use

If the user asks for actions outside Jira (e.g., Confluence, Bitbucket) this skill should not be triggered.

References