SuperAPI AI 工具集

tapd-openapi

办公与效率

查看项目

更新于 10-16 08:05

技能介绍

用途:该技能用于通过 TAPD 开放接口对 TAPD 平台数据进行操作,涵盖需求(story)、缺陷(bug)、任务(task)、迭代(iteration/sprint)、Wiki、评论(comment)、工时(timesheet)、附件、用户信息等。当用户提到 TAPD、需求、缺陷、任务、迭代、工时、Wiki、评论、附件等关键词时可使用。

环境变量:TAPD_API_ENDPOINT 为 API 地址,若已配置则优先替换文档中的 ${TAPD_API_ENDPOINT};TAPD_WORKSPACE_IDS 为项目 ID 列表(逗号分隔),优先级高于 TAPD_WORKSPACE_ID;TAPD_WORKSPACE_ID 为单个项目 ID(兼容旧配置);TAPD_TOKEN 为 Bearer 认证 Token。

Workspace 规则:优先取 TAPD_WORKSPACE_IDS,回退到 TAPD_WORKSPACE_ID,需先确定实际 workspace 列表。若只有一个 ID,按单 workspace 请求;若有多个 ID,需对每个 ID 分别调用 API 再按用户意图汇总。curl 时 workspace_id 不能直接用逗号拼接,需拆分为多个独立调用。

请求方式:GET 使用 curl -s -H "Authorization: Bearer $TAPD_TOKEN" "${TAPD_API_ENDPOINT}/${path}?workspace_id=${ws_id}";POST 在此基础上加 -X POST、-H "Content-Type: application/json" 并在请求体传入 workspace_id 与参数。workspace_id 为必传。

文档查询:API 文档位于 ~/.codebuddy/skills/tapd-openapi/references/。可用 ls 列出服务或服务下的 API,用 cat 查看具体 API 详情获取请求方法、路径与参数。常用服务及 API 包括:stories(liststories、countstories、addstory、updatestory、getrelatedbugs、getstoryfieldsinfo)、bugs(listbugs、countbugs、addbug、updatebug、getbugfieldsinfo)、iterations(listiterations)、tasks(listtasks、counttasks、addtask、updatetask)、comments(listcomments、countcomments、addcomment)、wikis(listwikis、countwikis、addwiki、updatewiki、searchwiki)、timesheets(listtimesheets、counttimesheets、addtimesheet、updatetimesheet)、attachments(listattachments、downloadattachment、getimage、downloaddocument)、users(getuserinfo、listworkspaces)。

调用流程:确定服务→查找 API→读取 API 文档→按模板构造 curl 请求执行。

限制:TAPD API 不支持 Wiki 全文搜索,该功能通过本地脚本实现,详见 references/wikis/searchwiki.md。其他未在资料中说明的收费、平台与效果等信息暂未提供。