jira-custom-fields
Custom field discovery and configuration. TRIGGERS: 'field ID for', 'what's the field ID', 'what is the field ID', 'list custom fields', 'what fields are available', 'what custom fields', 'show custom fields', 'customfield_', 'find field', 'agile fields', 'configure agile fields', 'story points field'. Use for JIRA field metadata and discovery. NOT FOR: setting field values on issues (use jira-issue), setting story points (use jira-agile), searching by field values (use jira-search).
jira-assistant-skills · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add grandcamel/JIRA-Assistant-Skills --skill jira-custom-fields技能说明
name: "jira-custom-fields" description: "Custom field discovery and configuration. TRIGGERS: 'field ID for', 'what's the field ID', 'what is the field ID', 'list custom fields', 'what fields are available', 'what custom fields', 'show custom fields', 'customfield_', 'find field', 'agile fields', 'configure agile fields', 'story points field'. Use for JIRA field metadata and discovery. NOT FOR: setting field values on issues (use jira-issue), setting story points (use jira-agile), searching by field values (use jira-search)." version: "1.0.0" author: "jira-assistant-skills" license: "MIT" allowed-tools: ["Bash", "Read", "Glob", "Grep"]
jira-fields: JIRA Custom Field Management
Manage custom fields and screen configurations in JIRA for Agile and other workflows.
Risk Levels
| Operation | Risk | Notes |
|---|---|---|
| List fields | - | Read-only |
| Check project fields | - | Read-only |
| Configure agile (dry-run) | - | Preview only |
| Configure agile | ! | Can be reconfigured |
| Create field | ! | Requires admin; can be deleted |
Risk Legend: - Safe, read-only | ! Caution, modifiable | !! Warning, destructive but recoverable | !!! Danger, irreversible
When to use this skill
Use when you need to:
- List available custom fields in a JIRA instance
- Check Agile field availability for a specific project
- Create custom fields (requires admin permissions)
- Configure projects for Agile workflows (Story Points, Epic Link, Sprint)
- Diagnose field configuration issues when fields aren't visible
Use when troubleshooting:
- "Field not found" or "field not available" errors
- Agile board shows "Story Points field not configured"
- Missing fields on issue create screen
- Setting up Scrum in a company-managed project
- Understanding why team-managed projects behave differently
Use when planning:
- Migrating from team-managed to company-managed projects
- Setting up a new Scrum/Kanban board
- Discovering instance field configuration
- Auditing or cleaning up custom fields
What this skill does
IMPORTANT: Always use the jira-as CLI. Never run Python scripts directly.
Field Discovery
- List all custom fields in the JIRA instance
- Find Agile-specific fields (Story Points, Epic Link, Sprint, Rank)
- Check which fields are available for a specific project
- Identify field IDs for use in other scripts
Field Management (Admin)
- Create new custom fields
- Configure field contexts for projects
- Note: Screen configuration requires JIRA admin UI
Project Type Detection
- Detect if a project is team-managed (next-gen) or company-managed (classic)
- Provide guidance on field configuration approach based on project type
Common Options
All scripts support these common options:
| Option | Description |
|---|---|
-o, --output [text|json] | Output format: text (default) or json |
--help | Show help message and exit |
Available Commands
All commands support --help for full documentation.
| Command | Description |
|---|---|
jira-as fields list | List available fields (instance-wide, or scoped to a project's create screen) |
jira-as fields check-project | Check field availability for a specific project |
jira-as fields configure-agile | Configure Agile fields for a company-managed project |
jira-as fields create | Create a new custom field (requires admin) |
List Fields
# List all custom fields
jira-as fields list
# Filter by name pattern
jira-as fields list -f "story"
jira-as fields list --filter "story"
# Show only Agile-related fields
jira-as fields list --agile
# Show all fields (including system fields)
jira-as fields list --all
# Scope to the fields on a project's create screen (-p is short for --project)
jira-as fields list --project PROJ
jira-as fields list -p PROJ
# Scope further to one issue type (-t is short for --issue-type; requires --project)
jira-as fields list --project PROJ --issue-type Bug
jira-as fields list -p PROJ -t Bug
Without --project, fields list shows the whole instance field catalogue.
With --project (and optionally --issue-type), it lists only the fields you
can actually set when creating an issue there.
Check Project Fields
# Check what fields are available for issue creation
jira-as fields check-project PROJ
# Check fields for a specific issue type
jira-as fields check-project PROJ --type Story
# Check Agile field availability (-a is short for --check-agile)
jira-as fields check-project PROJ -a
jira-as fields check-project PROJ --check-agile
# Output as JSON (-o is short for --output)
jira-as fields check-project PROJ -o json
jira-as fields check-project PROJ --output json
Configure Agile Fields
# Configure default Agile fields for a project
jira-as fields configure-agile PROJ
# Preview changes without applying (dry run)
jira-as fields configure-agile PROJ -n
jira-as fields configure-agile PROJ --dry-run
# Specify custom field IDs
jira-as fields configure-agile PROJ --story-points customfield_10016 --epic-link customfield_10014
# Configure all Agile field IDs
jira-as fields configure-agile PROJ --story-points customfield_10016 --epic-link customfield_10014 --sprint customfield_10020
Create Field
# Create Story Points field
jira-as fields create --name "Story Points" --type number
# Create Epic Link field
jira-as fields create --name "Epic Link" --type select
# Create with description
jira-as fields create --name "Effort" --type number --description "Effort in hours"
Supported Field Types
The fields create command supports the following 12 field types:
| Type | Description | Example Use Case |
|---|---|---|
text | Single-line text input | Short identifiers, codes |
textarea | Multi-line text input | Detailed descriptions, notes |
number | Numeric value | Story Points, Effort hours |