SuperAPI AI 工具集

youtrack

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:指导智能体在 YouTrack 上安全读写。核心前提是项目配置不可猜测:字段名、类型、允许值、必填项、状态可接受的流转、链接类型、标签在问题解决时的行为,均按项目或实例设置,API 文档只给形状,值只有实例知道。首次写入前先读项目配置,改动影响其他字段的字段后要重读。

主要能力与用法:写入不等于成功。不请求字段投影的命令请求按设计返回 200 空响应体;创建可能部分失败,问题已建但自定义字段写入被静默丢弃;受规则管控的字段写入可能被拒。每次写入后回读问题,并在端点支持时请求投影。空结果不能证明不存在:MCP 响应会过滤对 AI 隐藏的项目与问题,集合读取在未设显式上限时按实例上限截断,未指定排序的查询返回最近更新而非最相关。

工具范围:YouTrack 内置 MCP 服务器(2025.3 起位于 https://<instance>/mcp)的工具列表受连接 URL 影响,tools/list 中缺失的操作可能只是被过滤;附件、任意命令、删除、移除链接没有对应工具,仍需 REST 调用。工具名、参数与输出形状以 tools/list 及各工具描述为准,不要凭记忆。

查询:整个查询值需 URL 编码,构造 URL 中不得出现字面 #。搜索仅支持 GET。始终设置显式分页并翻页至返回短页。单个问题用 issue ID: PROJ-142 定位,不要用裸 ID 或加引号。花括号是松散 OR,引号是短语。时间单位仅 y M w d h,窗口要写成范围。

状态与工时:状态通过流转名而非目标值修改,流转名来自规则、按项目而定,需读取问题当前可用流转。终态无出向流转,可能不可逆。已用时间不是字段,而是工作项合计,通过添加工作项记录;状态变更可能以调用者身份计时。

链接:链接类型名称与方向名不同,添加链接会写入双向,手工写反向无效;链接与层级是问题的只读属性,只能在链接中设置。

限制:命令语法与查询语法不同;批量静默通知需在每个受影响项目有权限,且不会静默工作流规则发出的通知;标签可能自行移除,不是持久标记。资料未提供收费、价格与平台信息。