jira-reader

通过 Node.js 脚本以只读方式访问 Jira Cloud：查询当前用户、项目元数据、单个工单、JQL 搜索、最近活动、已分配的未完成工作，并可按项目与状态输出 JSON 任务目录。使用前需配置 Atlassian API Token 等环境变量，全部操作仅读取，不修改任何工单。

amaury95

热度 17.57

最近更新 2026-08-03 22:09:44

分类：协作依赖：代码执行 / 第三方 API / 读写文件应用场景：任务管理 / API 集成 / 工作流

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add jira-reader

Metadata

name: jira-reader
description: Read-only Jira lookup commands, including JSON task-directory output.
metadata: {"version":"0.4.0","tags":["jira","atlassian","readonly","issues","javascript","reader"],"openclaw":{"primaryEnv":"JIRA_ACCESS_TOKEN"}}
allowed-tools: ["exec"]

Jira Reader

Use for read-only Jira Cloud lookups with scoped Atlassian API tokens: issue details, JQL searches, project metadata, recent activity, assigned open work, and current-user task directories.

Requirements

Node.js 18+.
Scoped Atlassian API token with Jira read scopes.
Environment: JIRA_BASE_URL, JIRA_EMAIL, JIRA_ACCESS_TOKEN; optional JIRA_PROJECT and JIRA_CLOUD_ID.
The helper loads .env; set JIRA_ENV_FILE for another file. Existing process values win.

Never print or commit tokens. Keep every operation read-only.

Commands

node scripts/jira-reader.mjs me
node scripts/jira-reader.mjs project
node scripts/jira-reader.mjs issue PROJ-123
node scripts/jira-reader.mjs search --jql 'project = PROJ ORDER BY updated DESC' --max 10
node scripts/jira-reader.mjs recent --max 10
node scripts/jira-reader.mjs my-open --max 20
node scripts/jira-reader.mjs my-tasks-directory --max 100
node scripts/jira-reader.mjs my-tasks-directory --project PROJ --max 50

my-tasks-directory queries all open tasks assigned to currentUser() unless --project is supplied. It emits JSON grouped as directory[projectKey][statusName], with compact issue summaries at the leaves. A truncated flag reports when --max omits results.

Treat open work as statusCategory != Done.

Validation

node scripts/jira-reader.mjs --version
node scripts/jira-reader.mjs me
node scripts/jira-reader.mjs my-tasks-directory --max 10