← 返回 Skills 市场
kyjus25

Jira

作者 kyjus25 · GitHub ↗ · v1.0.2
cross-platform ✓ 安全检测通过
2825
总下载
5
收藏
4
当前安装
3
版本数
在 OpenClaw 中安装
/install clawdbot-jira-skill
功能描述
Manage Jira issues, transitions, and worklogs via the Jira Cloud REST API.
使用说明 (SKILL.md)

Jira Skill

Work with Jira issues and worklogs from Clawdbot (search, status, create, log work, worklog summaries).

Setup

  1. Get your API key: https://id.atlassian.com/manage-profile/security/api-tokens
  2. Click "Create API Token"
  3. Set environment variables:
    export JIRA_EMAIL="[email protected]"
    export JIRA_API_TOKEN="your-api-token"
    export JIRA_URL="https://your-domain.atlassian.net"
    # Optional project scope (comma-separated). Empty = search all.
    export JIRA_BOARD="ABC"
    

Requires curl, jq, bc, and python3.

Quick Commands

All commands live in {baseDir}/scripts/jira.sh.

  • {baseDir}/scripts/jira.sh search "timeout" [max] — fuzzy search by summary or key inside JIRA_BOARD
  • {baseDir}/scripts/jira.sh link ABC-123 — browser link for an issue
  • {baseDir}/scripts/jira.sh issue ABC-123 — quick issue details
  • {baseDir}/scripts/jira.sh status ABC-123 "In Progress" — move an issue (validates available transitions)
  • {baseDir}/scripts/jira.sh transitions ABC-123 — list allowed transitions
  • {baseDir}/scripts/jira.sh assign ABC-123 "name or email" — assign by user search
  • {baseDir}/scripts/jira.sh assign-me ABC-123 — assign to yourself
  • {baseDir}/scripts/jira.sh comment ABC-123 "text" — add a comment
  • {baseDir}/scripts/jira.sh create "Title" ["Description"] — create a Task in JIRA_BOARD
  • {baseDir}/scripts/jira.sh log ABC-123 2.5 [YYYY-MM-DD] — log hours (defaults to today UTC)
  • {baseDir}/scripts/jira.sh my [max] — open issues assigned to you
  • {baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-07 — your logged hours by issue (JSON)
  • {baseDir}/scripts/jira.sh hours-day 2025-01-07 [name|email] — logged hours for a day grouped by user/issue; optional filter (name/email; also resolves to accountId)
  • {baseDir}/scripts/jira.sh hours-issue ABC-123 [name|email] — logged hours for an issue; optional filter (name/email; also resolves to accountId)

Command Reference

  • Search issues

    {baseDir}/scripts/jira.sh search "payment failure" [maxResults]
    
  • Issue link

    {baseDir}/scripts/jira.sh link ABC-321
    
  • Issue details

    {baseDir}/scripts/jira.sh issue ABC-321
    
  • Update status

    {baseDir}/scripts/jira.sh status ABC-321 "Done"
    
  • List transitions

    {baseDir}/scripts/jira.sh transitions ABC-321
    
  • Assign issue

    {baseDir}/scripts/jira.sh assign ABC-321 "Jane Doe"
    
  • Assign to yourself

    {baseDir}/scripts/jira.sh assign-me ABC-321
    
  • Add comment

    {baseDir}/scripts/jira.sh comment ABC-321 "Deployed to staging"
    
  • Create issue

    {baseDir}/scripts/jira.sh create "Fix auth timeout" "Users being logged out after 5m"
    
  • Log hours

    {baseDir}/scripts/jira.sh log PB-321 1.5 2025-01-18
    
  • My open issues

    {baseDir}/scripts/jira.sh my [maxResults]
    
  • Logged hours by issue (me)

    {baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-05
    
  • Logged hours for a day (everyone)

    {baseDir}/scripts/jira.sh hours-day 2025-01-05
    
  • Logged hours for a day (user filter)

    {baseDir}/scripts/jira.sh hours-day 2025-01-05 "jane"
    
  • Logged hours for an issue

    {baseDir}/scripts/jira.sh hours-issue ABC-321 "jane"
    

Notes

  • Worklog commands use Jira's worklog/updated + worklog/list combo and may take a few seconds on large projects.
  • hours filters by JIRA_EMAIL; hours-day returns all users with totals per issue and user.
  • Outputs for hours commands are JSON for reuse in other tools.
  • Status transitions are validated against the server-provided transition list before applying.
安全使用建议
This skill is a straightforward Jira CLI wrapper and appears to do only Jira API operations. Before installing: (1) Verify you trust the skill source and the included script (scripts/jira.sh) since it will send JIRA_EMAIL and JIRA_API_TOKEN to whatever JIRA_URL you set; use a token with minimal necessary permissions. (2) Confirm network access to the intended Atlassian domain and avoid pointing JIRA_URL to unknown endpoints. (3) Note the script uses standard tools (curl, jq, bc, python3) and also calls base64 (not declared) and common coreutils; ensure those exist in your environment. (4) If you do not want autonomous agent invocation of skills, change agent settings — autonomous invocation is the platform default. (5) If you have any doubt after review, consider creating a dedicated Jira API token with limited scope and rotate it if you remove the skill.
功能分析
Type: OpenClaw Skill Name: clawdbot-jira-skill Version: 1.0.2 The OpenClaw AgentSkills skill bundle for Jira appears benign. It provides a set of shell commands to interact with the Jira Cloud REST API, requiring `JIRA_URL`, `JIRA_EMAIL`, and `JIRA_API_TOKEN` as environment variables for authentication. All network calls are directed to the configured Jira instance. The `scripts/jira.sh` file uses standard tools (`curl`, `jq`, `bc`, `python3`) and includes embedded Python scripts for data processing, which are well-defined and do not exhibit any malicious behavior. There is no evidence of data exfiltration, unauthorized execution, persistence mechanisms, or prompt injection attempts in `SKILL.md`.
能力评估
Purpose & Capability
Name/description (Jira issue/worklog management) match the required env vars (JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN) and the included script's API calls. The requested credentials are exactly those needed for Jira Cloud REST API access.
Instruction Scope
SKILL.md and scripts instruct only Jira-related operations (search, transitions, comments, worklogs) and tell the agent to use the included script. The script only calls endpoints under the user-supplied JIRA_URL and does not reference unrelated system files, other services, or unexpected external endpoints.
Install Mechanism
There is no install spec (instruction-only skill with an included script). Nothing is downloaded from remote URLs or written to unusual locations. This is the lower-risk installation pattern for skills.
Credentials
Requested env vars (JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN, optional JIRA_BOARD) are appropriate and proportionate. Note: the script constructs a Basic auth header using JIRA_EMAIL and JIRA_API_TOKEN and will send these to the configured JIRA_URL — that is expected behaviour but worth being aware of. Minor mismatch: the script uses the base64 utility but base64 is not listed in the SKILL.md required binaries; python3 is declared as required in metadata but its use is not visible in the shown snippet (it may be used elsewhere).
Persistence & Privilege
always:false (default) and the skill does not request persistent system-wide privileges or modify other skills. Autonomous invocation is allowed (platform default) but this skill does not request elevated persistence.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install clawdbot-jira-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /clawdbot-jira-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
- Minor formatting changes in SKILL.md for improved readability. - No changes to functionality or commands.
v1.0.1
Add ability to log hours for issue
v1.0.0
Initial release of the Jira skill for Clawdbot. - Manage Jira issues, transitions, and worklogs using Jira Cloud REST API. - Provides shell commands for searching, creating, updating, and logging work on Jira issues. - Supports issue assignment, status transitions, and commenting from the command line. - Offers commands to view and summarize logged work hours by issue and user. - Requires setup with Jira Cloud credentials and environment variables.
元数据
Slug clawdbot-jira-skill
版本 1.0.2
许可证
累计安装 5
当前安装数 4
历史版本数 3
常见问题

Jira 是什么?

Manage Jira issues, transitions, and worklogs via the Jira Cloud REST API. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2825 次。

如何安装 Jira?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawdbot-jira-skill」即可一键安装,无需额外配置。

Jira 是免费的吗?

是的,Jira 完全免费(开源免费),可自由下载、安装和使用。

Jira 支持哪些平台?

Jira 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Jira?

由 kyjus25(@kyjus25)开发并维护,当前版本 v1.0.2。

💬 留言讨论