用途:驱动 JIRA 问题在各类工作流中流转,管理负责人、解决状态、版本与组件,覆盖从创建到发布的完整生命周期。不负责创建/编辑问题内容(用 jira-issue)或查找问题(用 jira-search)。
主要能力:七类命令。Transitions 列出并执行状态流转;Assignments 分配、改派或取消分配;Resolution 解决与重开问题;Versions 创建、列出、发布、归档版本;Components 创建、更新、删除组件;Discovery 查看可用选项。支持标准、自定义、JSM 及简化工作流,脚本自动适配。
使用方式:始终使用 jira-as CLI,不要直接运行 Python 脚本。示例:jira-as lifecycle transitions PROJ-123;jira-as lifecycle transition PROJ-123 --to "In Progress";jira-as lifecycle assign PROJ-123 --self;jira-as lifecycle resolve PROJ-123 --resolution Fixed;jira-as lifecycle reopen PROJ-123;jira-as lifecycle version create PROJ --name "v2.0.0";jira-as lifecycle component create PROJ --name "API"。所有命令支持 --help。仅列表类命令支持 -o/--output(transitions 支持 text/json,version list 与 component list 支持 table/json)。transition、assign、version create、component create/update/delete 支持 --dry-run(transition 与 assign 可用 -n);resolve、reopen、version release、version archive 不支持。退出码 0 成功、1 失败。
适用场景:开发与团队负责人日常推进问题状态、分配归属、规划发布与组件划分;JIRA 管理员设计工作流。
限制与风险:需通过环境变量 JIRA_SITE_URL、JIRA_EMAIL、JIRA_API_TOKEN 配置凭据。组件更新与删除需组件 ID 而非名称,--lead 需账户 ID 而非邮箱。删除组件会使问题失去组件关联,属破坏性但可恢复;流转、分配、解决、重开、版本发布/归档等操作可回退但需谨慎。常见问题:无可用流转时先列出;流转需字段时用 --fields;用户找不到时核对邮箱与项目权限。详细示例、故障排查与最佳实践见随附文档。