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

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

OperationRiskNotes
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:

OptionDescription
-o, --output [text|json]Output format: text (default) or json
--helpShow help message and exit

Available Commands

All commands support --help for full documentation.

CommandDescription
jira-as fields listList available fields (instance-wide, or scoped to a project's create screen)
jira-as fields check-projectCheck field availability for a specific project
jira-as fields configure-agileConfigure Agile fields for a company-managed project
jira-as fields createCreate 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:

TypeDescriptionExample Use Case
textSingle-line text inputShort identifiers, codes
textareaMulti-line text inputDetailed descriptions, notes
numberNumeric valueStory Points, Effort hours
阅读完整来源 ↗