文档 / 协作与集成

Jira、Jenkins、CloudBees 与我的任务

在 IDE 中查看你的工单、流水线和部署。智能体会读取所需信息,而每一次写入都要等你批准。

Yuli 把 IDE 与 Jira、Jenkins 和 CloudBees CD/RO 连接起来。你无需离开编辑器就能查看自己的工单、构建和部署,智能体则把它们当作工具使用:它可以自由读取,但任何会改变内容的操作都要等你批准。

在哪里配置

服务 位置
Jira MCP 服务器 中的一个条目。
Jenkins MCP 服务器 中供智能体使用的一个条目,以及用于查看流水线的 CI 连接。
CloudBees CD/RO CI 连接,使用 API 令牌或你的用户名和密码(仅用于读取)。
项目设置 .ai/devops.json:分支格式、Jenkins job 以及 CloudBees 的范围。

CI 连接 汇集了 Jenkins、GitLab CI、GitHub Actions 和 CloudBees。凭据保存在系统钥匙串中。

Jira

Yuli 支持 Jira Cloud(邮箱和 API 令牌)和 Data Center(Personal Access Token)。

工具 作用 需要批准
jira.search_issues 搜索工单。 否
jira.get_issue 读取工单。 否
jira.list_projects 列出项目。 否
jira.list_boards 列出看板。 否
jira.list_sprints 列出 sprint。 否
jira.list_transitions 列出工单可以转到的状态。 否
jira.create_issue 创建工单。 是
jira.update_issue 修改工单。 是
jira.transition_issue 更改工单状态。 是
jira.add_comment 评论工单。 是
jira.attach_branch 把分支关联到工单。 是

当智能体关联分支却没有指定项目时,Yuli 会使用智能体当前正在处理的项目。

从工单创建分支

在 Git 面板中,我的 Jira 工单 会列出你的工单。从工单创建分支 会按项目的格式创建分支,并提议把工单移到进行中状态。

格式在 .ai/devops.json 中定义,并随团队一起纳入版本控制:

json
{
  "branchFormat": "{prefix}/{key}-{slug}",
  "typePrefixes": { "bug": "bugfix", "hotfix": "hotfix" },
  "defaultPrefix": "feature",
  "maxSlugLength": 40
}
占位符 替换为
{prefix} 根据工单类型确定的前缀(bug 为 bugfix,事故为 hotfix,其余为 feature)。
{key} 工单的键,例如 PAY-214。
{slug} 工单标题,转为小写并用连字符连接。
{type} 工单类型。
{project} Jira 项目。

使用默认格式时,故事 PAY-214“Validar importe”会生成分支 feature/PAY-214-validar-importe。slug 会去掉重音和符号:“Añadir inicio de sesión con SSO (Azure)”会变成 anadir-inicio-de-sesion-con-sso-azure。

Jenkins

工具 作用 需要批准
jenkins.list_jobs 列出 job。 否
jenkins.get_job 读取 job。 否
jenkins.get_build 读取构建。 否
jenkins.get_console_log 读取构建的控制台输出。 否
jenkins.get_queue 读取队列。 否
jenkins.trigger_build 触发构建。 是

例如,你可以问智能体:“这个分支最近一次构建为什么失败?”。它会读取控制台输出并告诉你原因。

CloudBees CD/RO

智能体只有 一个只读工具:cloudbees。借助它,智能体可以查看流水线的运行及其阶段和任务、job(步骤、错误和日志)、配置(机密已遮蔽),以及项目 Kubernetes workload 的 pod。

范围就是你在 .ai/devops.json → cloudbees 中配置的内容:你项目的流水线、环境和 workload。智能体 不能触发、批准或更改任何东西:它只会告诉你该怎么做。

在 IDE 中,你可以在 部署(CloudBees) 中查看。

我的任务

我的任务 把你的 Jira 工单、代码托管平台上的 issue 以及你的 pull request 或 merge request(GitHub、GitLab、Bitbucket 和 Azure)汇集到一个列表中。通过命令 我的任务(Git 组)打开,或在状态栏的 分支任务: 处打开。

筛选 选项
范围 我在本 sprint 的、当前 sprint(团队)
来源 全部、Issues、Pull requests
操作 作用
开始 创建该任务的分支,并可选择移动工单。
切换到其分支 切换到该任务的分支。

如果你还没有连接任何服务,我的任务会提示你连接 Jira(在 MCP 服务器中)或 GitHub、GitLab 账户。

另请参阅 Git 与 CI/CD和作为 MCP 服务器的 Yuli。