数据与分析
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
| Operation | Risk | Notes |
|---|---|---|
| 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.
| Command | Purpose | Example |
|---|---|---|
jira-as search query | Execute JQL queries | jira-as search query "project = PROJ" |
jira-as search export | Export to CSV/JSON | jira-as search export "JQL" -o report.csv |
jira-as search validate | Check JQL syntax | jira-as search validate "your query" |
jira-as search build | Build JQL from clauses | jira-as search build --clause "project = PROJ" --clause "status = Open" |
jira-as search bulk-update | Bulk update issues from search | jira-as search bulk-update "JQL" --add-labels bug --dry-run |
jira-as search suggest | Get field value suggestions | jira-as search suggest --field status --no-cache |
jira-as search fields | List available JQL fields | jira-as search fields --custom-only |
jira-as search functions | List available JQL functions | jira-as search functions --with-examples |
jira-as search filter list | List saved filters | jira-as search filter list --favourites |
jira-as search filter create | Save a reusable filter | jira-as search filter create --name "Name" --jql "JQL" |
jira-as search filter update | Update an existing filter | jira-as search filter update 10042 --name "New Name" |
jira-as search filter run | Run a saved filter | jira-as search filter run --id 10042 |
jira-as search filter favourite | Toggle favourite status | jira-as search filter favourite 10042 --add |
jira-as search filter share | Share filter with users/groups | jira-as search filter share 10042 --project PROJ |
jira-as search filter delete | Delete a saved filter | jira-as search filter delete 10042 --yes |
All commands support --help for full documentation.
What this skill does
- JQL Search: Execute custom queries with sorting, pagination, field selection
- JQL Builder: Build and validate queries interactively
- Save Searches: Turn a query into a saved filter with
--save-as - Saved Filters: Full CRUD on JIRA filters with sharing and favourites
- Export Results: CSV or JSON files with auto-pagination (JSON keeps nested field objects)
- Bulk Updates: Update multiple issues from search results
Common Options
| Option | Description |
|---|---|
--help | Show help message and usage |
--output, -o | Output format: text (default), json |
--max-results, -m | Maximum results (query default: 50, export default: 1000); values over 100 auto-paginate |
--fields | Comma-separated list of fields |
--show-links, -l | Show issue links in output |
--show-time, -t | Show time tracking info |
--show-agile, -a | Show agile fields (story points, sprint) |
--page-token, -p | Pagination 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
阅读完整来源 ↗