SuperAPI AI 工具集

jira-implement-task

通用与其它

查看项目

更新于 10-15 20:14

技能介绍

用途:这是一个面向软件工程师的技能,输入 Jira 工单键(如 FEC-123),读取工单描述并端到端完成实现,包括创建分支、修改代码、提交、推送和创建 PR。

主要能力与流程:

  1. 解析 $ARGUMENTS 提取工单键(必填)。
  2. 通过 /agent-restore-context 做上下文恢复检查,防止实现中途被 /compact 或 /clear 打断;创建实现计划后写入,完成后删除。
  3. 读取项目 CLAUDE.md 或 AGENTS.md 获取项目配置,包括测试命令(单文件与全量)、分支命名、基础分支、提交格式、组件工作流和可用智能体;缺失时询问用户或使用回退默认值(如 pnpm test、<TICKET-KEY>-<slug>、main、Conventional commits)。
  4. 使用 Atlassian MCP 工具获取工单:先调用 mcp__atlassian__getAccessibleAtlassianResources 获取 cloud ID,再调用 mcp__atlassian__getJiraIssue 获取摘要、描述、验收标准和问题类型;找不到工单则报错停止。写入 Jira 时始终用 Markdown。
  5. 从基础分支创建特性分支:git checkout <base-branch>、git pull、git checkout -b <branch-name>;分支已存在时询问用户。
  6. 制定实现计划并保存到 <skills-dir>/jira-implement-task/plans/<TICKET-KEY>-plan.md,按红/绿 TDD 逐任务实现:先写测试(红),再写最小实现(绿),运行测试并提交。单个任务尝试 3 次仍卡住则停止询问用户。
  7. 完成后运行全量测试,删除恢复上下文,询问是否保留计划文件。
  8. 推送与创建 PR:先运行 gh repo view --json viewerPermission --jq '.viewerPermission',若为 READ 则跳过并打印命令供手动执行;否则执行 git push -u origin <branch-name> 和 gh pr create,返回 PR URL。

适用场景:需要将 Jira 工单自动转化为代码变更和 PR 的开发流程。

限制:依赖 Atlassian MCP 工具、gh CLI 和项目配置文件;工单不明确时需用户澄清;具体收费、价格、平台支持等信息暂未提供。