SuperAPI AI 工具集

managing-youtrack

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:本技能原用于通过手写 curl 配方管理 youtrack.jetbrains.com,现已被标记为废弃,所有操作改由 youtrack 技能覆盖,该技能通过仓库固定的 Bun 包装器驱动 .agents/skills/youtrack/scripts/youtrack.ts,使用时应阅读其 SKILL.md 并改用其命令。

替换原因:CLI 从 YOUTRACK_TOKEN 或操作系统原生凭据存储解析令牌,令牌无需导出到 shell 环境;请求体经 stdin 传递而非写入 mktemp 临时文件,因此无需额外写入审批、也无需清理临时文件;两个可复用的审批前缀(… youtrack.ts read 与 … youtrack.ts write)覆盖全部操作面,读写分离使变更成为显式决定;ID、链接方向、标签名和自定义字段 $types 均由 CLI 解析,无需每次调用手工拼装。

命令映射(旧配方→替代命令):获取工单 read issue get <ID>;搜索 read issue search --query <query> [--top n];列出已保存查询 read saved-query list;创建 write issue create --project <SHORT_NAME> --summary <text> [--description-file -];更新摘要或描述 write issue update <ID> [--summary <text>] [--description-file -];应用命令(状态、优先级、经办人)write issue state <ID> --value <state>、write issue set-field <ID> --name <field> --value <value>;列评论 read issue comments <ID>;加评论 write issue comment <ID> --text-file -;更新或删除评论 write comment update <ID> --comment <CID> --text-file -、write comment delete <ID> --comment <CID>;列出或搜索标签 read issue tags <ID>、read tag list --query <text>;加或删标签 write issue tag <ID> --name <tag>、write issue untag <ID> --name <tag>;读链接 read issue links <ID>;建或删链接 write issue link <ID> --type <phrase> --target <ID>、write issue unlink …;列出链接类型 read link-type list;列出或添加工时 read issue work-items <ID>、write issue log-work <ID> --duration '2h 30m';查找用户 read user me、read user search --query <query>;查看项目自定义字段 read project fields <SHORT_NAME>;列出项目 read project list;读取附件 read issue attachments <ID>、read issue attachment <ID> --name <name> [--out <path>]。

限制:CLI 未覆盖上传附件、组查找、敏捷看板和项目管理工作,这些需另行审批的 API 调用。旧建议中把 project.id 作为内部数字 ID(如 JEWEL 的 22-1758)已过时,CLI 使用项目简称创建工单。JEWEL 项目要求创建时提供 Type 与 State 自定义字段,Priority 也是必填,但仅 Jewel 团队成员可设置。关于工单状态流转与发布,参见 pr-guide.md(提交信息中引用 YouTrack 工单的 PR 约定)和 releasing-guide.md(涉及 YouTrack 工单跟踪的发布流程)。