跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
数据与分析

jira-search-jql

Find issues by criteria (status, assignee, priority, etc.) using JQL. Create filters, export results to CSV/JSON, bulk update. Ideal for reporting and automation.

jira-assistant-skills · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add grandcamel/JIRA-Assistant-Skills --skill jira-search-jql

技能说明


name: "jira-search-jql" description: "Find issues by criteria (status, assignee, priority, etc.) using JQL. Create filters, export results to CSV/JSON, bulk update. Ideal for reporting and automation." version: "1.0.0" author: "jira-assistant-skills" license: "MIT" allowed-tools: ["Bash", "Read", "Glob", "Grep"]

jira-search

Query and discovery operations for JIRA issues using JQL (JIRA Query Language).

Risk Levels

OperationRiskNotes
Query/search-Read-only
Validate JQL-Read-only
Export results-Read-only (local file)
List filters-Read-only
Create filter-Easily reversible (can delete)
Update filter!Can be reverted
Share filter!Can be unshared
Delete filter!!Filter lost, but can recreate
Bulk update!!Use --dry-run first; changes reversible but tedious

Risk Legend: - Safe, read-only | ! Caution, modifiable | !! Warning, destructive but recoverable | !!! Danger, irreversible

When to use this skill

Perfect for:

  • Search by criteria: "Find all bugs assigned to me in the current sprint"
  • Reporting: Export sprint results or metrics to CSV/JSON
  • Bulk operations: Update labels, priority, or assignee on 50+ issues at once
  • Automation: Create saved filters for monitoring or dashboards

Not ideal for:

  • Single issue operations - Use jira-issue skill
  • Workflow transitions on many issues - Use jira-lifecycle skill
  • Complex issue relationships - Use jira-relationships skill
  • Sprint/board management - Use jira-agile skill

Quick Start

# Find your open issues
jira-as search query "assignee = currentUser() AND status != Done"

# Find bugs in a project
jira-as search query "project = PROJ AND type = Bug AND status = Open"

# Export results to CSV
jira-as search export "project = PROJ" --output report.csv

# Save a filter for reuse
jira-as search filter create -n "My Bugs" -j "type = Bug AND assignee = currentUser()" -f

For detailed setup, see docs/QUICK_START.md.

Available Commands

IMPORTANT: Always use the jira-as CLI. Never run Python scripts directly.

CommandPurposeExample
jira-as search queryExecute JQL queriesjira-as search query "project = PROJ"
jira-as search exportExport to CSV/JSONjira-as search export "JQL" -o report.csv
jira-as search validateCheck JQL syntaxjira-as search validate "your query"
jira-as search buildBuild JQL from clausesjira-as search build --clause "project = PROJ" --clause "status = Open"
jira-as search bulk-updateBulk update issues from searchjira-as search bulk-update "JQL" --add-labels bug --dry-run
jira-as search suggestGet field value suggestionsjira-as search suggest --field status --no-cache
jira-as search fieldsList available JQL fieldsjira-as search fields --custom-only
jira-as search functionsList available JQL functionsjira-as search functions --with-examples
jira-as search filter listList saved filtersjira-as search filter list --favourites
jira-as search filter createSave a reusable filterjira-as search filter create --name "Name" --jql "JQL"
jira-as search filter updateUpdate an existing filterjira-as search filter update 10042 --name "New Name"
jira-as search filter runRun a saved filterjira-as search filter run --id 10042
jira-as search filter favouriteToggle favourite statusjira-as search filter favourite 10042 --add
jira-as search filter shareShare filter with users/groupsjira-as search filter share 10042 --project PROJ
jira-as search filter deleteDelete a saved filterjira-as search filter delete 10042 --yes

All commands support --help for full documentation.

What this skill does

  1. JQL Search: Execute custom queries with sorting, pagination, field selection
  2. JQL Builder: Build and validate queries interactively
  3. Save Searches: Turn a query into a saved filter with --save-as
  4. Saved Filters: Full CRUD on JIRA filters with sharing and favourites
  5. Export Results: CSV or JSON files with auto-pagination (JSON keeps nested field objects)
  6. Bulk Updates: Update multiple issues from search results

Common Options

OptionDescription
--helpShow help message and usage
--output, -oOutput format: text (default), json
--max-results, -mMaximum results (query default: 50, export default: 1000); values over 100 auto-paginate
--fieldsComma-separated list of fields
--show-links, -lShow issue links in output
--show-time, -tShow time tracking info
--show-agile, -aShow agile fields (story points, sprint)
--page-token, -pPagination token for manual paging (query only)

Note: For search export, -o/--output is the output file path (required) and -f/--format selects csv or json.

Examples by Category

Search

# Basic search
jira-as search query "project = PROJ AND status = Open"

# With field selection
jira-as search query "project = PROJ" --fields key,summary,status,assignee

# With result limit
jira-as search query "project = PROJ" --max-results 50

# Large result sets: --max-results over 100 auto-paginates across API pages
jira-as search query "project = PROJ" --max-results 250

# Manual paging: --page-token fetches exactly one page (disables auto-pagination);
# the token is printed with the previous page's results
jira-as search query "project = PROJ" --page-token "TOKEN"

JQL Building

# Validate syntax (--show-structure shows parse tree, --output for format)
jira-as search validate "project = PROJ AND status = Open"
jira-as search validate "project
阅读完整来源 ↗