用途:该技能用于在开始处理某个 Jira 工单时,自动拉取工单信息并进入实现准备流程。调用时需提供工单 ID($ARGUMENTS)。
主要能力:通过 acli jira workitem view $ARGUMENTS 获取工单详情,解析摘要、描述、验收标准、关联问题和附件;按命名规则创建或切换到对应分支;执行 acli jira workitem update $ARGUMENTS --status "In Progress" 更新状态;进入计划模式并生成实现计划。
分支命名:格式为 {TICKET-ID}-{slugified-summary}。工单 ID 保留大小写(如 PROJ-123);摘要转小写、空格与特殊字符替换为连字符、合并连续连字符;slug 最多 50 字符并在词边界截断;去除末尾连字符。示例:PROJ-123-add-user-login-page。
分支检查:先用 git branch --list '{TICKET-ID}' 查本地分支,再用 git branch -r --list '{TICKET-ID}' 查远程分支。匹配到则 git checkout {branch},若存在远程跟踪分支则拉取最新;无匹配则 git checkout -b {new-branch-name}。
计划内容:包含工单 ID 与摘要作为标题、工单中的验收标准(有则原文引用)、需创建或修改的文件及理由、测试方案、依赖或阻塞项。不包含工单范围外的工作、工单未提及的推测功能、与目标无关的重构。
错误处理:未找到 acli 时停止并提示安装 Atlassian CLI;工单 ID 无效时停止并报告;分支创建失败时检查命名冲突并报告;状态转换失败时记录警告并继续;未提供 $ARGUMENTS 时停止并提示输入工单 ID。
限制:依赖 Atlassian CLI(acli)与 Git 环境;具体安装方式、支持的 Jira 版本及权限要求暂未提供。