用途:在开始处理 Jira 工单时,自动拉取工单信息、创建符合规范的功能分支并完成开发前的规划步骤。适用于启动 Jira 工单、为工单创建功能分支、获取工单详情与验收标准、为新开发工作搭建工作区,以及用户提到类似 SAM1-123 的工单编号或要求处理工单的场景。
主要能力:fetch-ticket.ts 可获取工单摘要与描述、状态与优先级、经办人与报告人、验收标准及标签,并支持 --json 输出;start-work.ts 会拉取工单详情、展示摘要与验收标准、按规范创建功能分支、将工单状态转为 In Progress,并添加“Started working on this ticket”评论。分支命名规范为 feature/sam1-123-short-description、bugfix/sam1-123-short-description、hotfix/sam1-123-short-description。
使用方式:先在 .github/skills 目录执行 npm install 安装依赖,再在项目根目录创建 .env 文件配置 JIRA_URL、JIRA_EMAIL、JIRA_API_TOKEN、JIRA_DEFAULT_PROJECT。拉取工单可运行 npx ts-node --esm .github/skills/skills/work-on-ticket/scripts/fetch-ticket.ts --ticket SAM1-123;开始工作可运行 npx ts-node --esm .github/skills/skills/work-on-ticket/scripts/start-work.ts --ticket SAM1-123,并可用 --no-branch 跳过分支创建、用 --no-transition 跳过状态转换。可用 test-connection.ts 验证 Jira 连通性。与 create-ticket 集成时,先创建工单再对其启动开发。
限制:需自行准备 Jira 凭据与 API Token,依赖 Node.js 与 ts-node 环境;具体错误处理、权限要求及更多配置项暂未提供。