SuperAPI AI 工具集

jira-custom-fields

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:管理 JIRA 自定义字段与屏幕配置,适用于 Agile 及其他工作流。可列出实例自定义字段、查找敏捷专用字段、检查某项目可用字段、创建自定义字段、为公司管理型项目配置敏捷字段,并诊断字段不可见等问题。

主要能力:字段发现(列出全部自定义字段、按名称过滤、仅显示敏捷字段、按项目及问题类型限定范围);字段管理(创建自定义字段,需管理员权限;屏幕配置需在 JIRA 管理界面完成);项目类型检测(区分团队管理型与公司管理型项目并给出配置建议)。

使用方式:始终使用 jira-as CLI,不要直接运行 Python 脚本。常用命令:jira-as fields list(可加 --filter、--agile、--all、--project、--issue-type);jira-as fields check-project PROJ(可加 --type、--check-agile、--output json);jira-as fields configure-agile PROJ(可加 --dry-run、--story-points、--epic-link、--sprint);jira-as fields create --name "Story Points" --type number。通用选项 -o/--output 支持 text 或 json,--help 查看帮助。

适用场景:排查“字段未找到”、敏捷板提示 Story Points 未配置、创建问题屏幕缺少字段、搭建 Scrum/Kanban 板、从团队管理型迁移到公司管理型项目、审计或清理自定义字段。

限制:创建字段需 JIRA 管理员权限,列出字段需浏览项目权限;团队管理型项目 API 支持有限,多数配置需在 UI 完成;字段 ID 因实例而异,不可假设默认值;屏幕配置需管理员 UI。认证需正确设置 JIRA_API_TOKEN 与 JIRA_EMAIL。退出码 0 成功,1 错误。