SuperAPI AI 工具集

youtrack-apps-skill

测试与质量

查看项目

更新于 10-15 23:31

技能介绍

用途:该技能用于指导构建、调试、扩展和管理 JetBrains YouTrack 应用与工作流,适用于脚手架搭建、修改、验证、上传等任务。

环境要求:需 Node.js >= 20.18.0、npm、npx,以及 create-youtrack-app CLI(npx @jetbrains/create-youtrack-app@latest --help)和 youtrack-app CLI(youtrack-app --help)。连接 YouTrack 需配置 YOUTRACK_HOST 与 YOUTRACK_TOKEN(或 YOUTRACK_API_TOKEN),不得打印令牌值。

主要能力:create-youtrack-app 用于创建应用源码和添加模块(app init、rule add、http-handler add、settings、extension-property add、widget add);youtrack-app 用于已安装应用与实例操作(upload、download、validate、list、info、scripts、settings、enablement、logs、requirement errors,以及 project、field、tag、group、user 探索和 rest request)。

应用类型:TypeScript 应用(--type ts)支持增强 DX,如基于文件的后端路由、生成 API 类型、类型化 widget 客户端代码、开发验证、watch 上传、前端热重载;JavaScript 应用(--type js)为基本 JavaScript 应用。新应用需先询问类型,已有应用遵循现有结构。

脚本类型:包括 On-Change Rule、Action Rule、On-Schedule Rule、State-Machine Rule、SLA Rule、HTTP Handler、MCP Tool,需在代码生成前加载对应 references/script-types.md 章节。

API 与规范:以 references/api/ 为事实依据,模块通过 require('@jetbrains/youtrack-scripting-api/...') 导入,涵盖 date-time、entities、http、license、notifications、search、strings、workflow。代码需验证每个属性与方法,不比较整个对象,按 name、login、key、id 比较。JS API 使用 Issue.id(如 DEMO-123),REST API 使用原始 ID(如 2-123)及 idReadable。

部署与发布:部署指验证并上传本地构建到目标实例,不发布到 Marketplace;发布为独立步骤,Marketplace 发布为可选后续步骤,需加载 references/release-and-publish.md。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;若工具缺失且无法安装,需询问用户后再继续。