用途:让 JIRA 工单描述与当前分支的实际代码改动保持一致。技能会对比工单描述与分支变更,提出补充描述或添加评论的建议,供开发者审阅后更新。
主要能力:检查 Atlassian CLI(acli)前置条件;从分支名提取 JIRA ID(如 PROJ-123);用 acli jira workitem view <JIRA-ID> --fields '*all' --json 抓取工单;按 .agent 文件中的 baseBranch 或默认 main 对比 git log 与 git diff;将变更归类为“描述缺失则改描述”“与工单无关则加评论”“实现决策则两者皆做”,并跳过已准确记录或琐碎细节;生成编号的更新提案与摘要;通过 AskUserQuestion 获取确认。
使用方式:命令为 /update-jira-ticket。更新描述时用 acli jira workitem edit --from-json <temp-file.json> --yes,JIRA 不渲染 Markdown,描述须用 ADF JSON;加评论用 acli jira workitem comment create --key <JIRA-ID> --body "<comment text>"。依赖安装:brew tap atlassian/acli && brew install acli;认证:acli auth login。
限制:需已安装并认证 acli,否则停止;分支名须含 JIRA ID,否则停止;无提交或差异过大时有相应处理;仅处理与分支名匹配的工单。费用、价格、平台、实际效果等资料暂未提供。