SuperAPI AI 工具集

work-on-ticket

编程与开发

查看项目

更新于 10-15 22:17

技能介绍

用途:在开始处理 Jira 工单时使用,自动拉取工单详情、创建符合命名规范的功能分支并完成规划步骤。适用于用户提到类似 PROJ-123 的工单编号或要求处理工单的场景。

主要能力:通过脚本获取工单摘要、描述、状态、优先级、经办人、验收标准、相关工单、评论与附件;按约定生成并检出分支;可选将工单状态更新为 In Progress;添加评论与记录工时;提供一键完整流程。

使用方式:需先配置 Jira API 认证,编辑 work-on-ticket/.jira-config 填入 url、email、token,token 可在 https://id.atlassian.com/manage-profile/security/api-tokens 创建;并配置 git 用户信息。常用命令:python scripts/fetch-ticket.py --ticket PROJ-123;python scripts/create-branch.py --ticket PROJ-123;python scripts/update-ticket.py --ticket PROJ-123 --status "In Progress";python scripts/start-work.py --ticket PROJ-123。分支命名格式为 <type>/<ticket-id>-<short-description>,类型包括 feature、bugfix、hotfix、refactor、docs、test。

适用场景:Jira 驱动的开发流程中快速启动工单、统一分支命名、同步工单状态与工时。

限制:需具备 Jira API 访问权限与有效 token;工单编号需符合格式;状态转换需使用实例中可用的转换名称;API token 不应提交到版本控制。