点击开火
- 作者仓库星标 1
- 作者仓库 workbuddy
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 92 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @zhizhunbao · v1.0 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# TAPD OpenAPI
## 环境变量(已预置)
- `TAPD_API_ENDPOINT` - API 地址, 如果 `TAPD_API_ENDPOINT` 已配置,则优先使用 `TAPD_API_ENDPOINT` 的替换文档中的 `${TAPD_API_ENDPOINT}`
- `TAPD_WORKSPACE_IDS` - 项目 ID 列表,逗号分隔,**优先级高于** `TAPD_WORKSPACE_ID`
- `TAPD_WORKSPACE_ID` - 单个项目 ID(兼容旧配置)
- `TAPD_TOKEN` - 认证 Token(Bearer 方式)
## Workspace 处理规则
**调用前必须先确定实际使用的 workspace 列表:**
```bash
# 优先取 TAPD_WORKSPACE_IDS,回退到 TAPD_WORKSPACE_ID
if [ -n "$TAPD_WORKSPACE_IDS" ]; then
WS_LIST=$(echo "$TAPD_WORKSPACE_IDS" | tr ',' ' ')
else
WS_LIST="$TAPD_WORKSPACE_ID"
fi
```
- 若 `WS_LIST` 只有一个 ID,按单 workspace 正常请求即可
- 若有多个 ID,需对每个 ID 分别调用 API,再汇总结果(求和、合并列表等,根据用户意图决定)
- 注意 curl 的时候 workspace_id 用逗号分隔后的,例如 $TAPD_WORKSPACE_IDS 是 "31372104,68119668",则 curl 的时候需要分别调用 `workspace_id=31372104` 和 `workspace_id=68119668`
## 请求模板
```bash
# GET
curl -s -H "Authorization: Bearer $TAPD_TOKEN" \
"${TAPD_API_ENDPOINT}/${path}?workspace_id=${ws_id}"
# POST
curl -s -X POST -H "Authorization: Bearer $TAPD_TOKEN" \
-H "Content-Type: application/json" \
"${TAPD_API_ENDPOINT}/${path}" \
-d '{"workspace_id":"'"${ws_id}"'","key":"value"}'
```
## 查询 API 文档
API 文档位于 `~/.codebuddy/skills/tapd-openapi/references/` 目录。
**1. 列出所有服务**:
```bash
ls ~/.codebuddy/skills/tapd-openapi/references/
```
**2. 列出服务下的 API**:
```bash
ls ~/.codebuddy/skills/tapd-openapi/references/stories/
```
**3. 查看 API 详情**:
```bash
cat ~/.codebuddy/skills/tapd-openapi/references/stories/liststories.md
```
## 常用服务
| 服务 | 说明 | 常用 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 | Wiki 管理 | listwikis, countwikis, addwiki, updatewiki, **searchwiki**(见下方) |
| timesheets | 工时花费 | listtimesheets, counttimesheets, addtimesheet, updatetimesheet |
| attachments | 附件管理 | listattachments, downloadattachment, getimage, downloaddocument |
| users | 用户信息 | getuserinfo, listworkspaces |
## 调用流程
1. **确定服务**:根据需求从常用服务中选择,或用 `ls` 查看全部
2. **查找 API**:用 `ls ~/.codebuddy/skills/tapd-openapi/references/{服务}/` 找到具体操作
3. **获取详情**:用 `cat` 读取 API 文档,获取请求方法、路径、参数
4. **执行请求**:按模板构造 curl 命令,`workspace_id` 必传
## Wiki 搜索
TAPD API 不支持 Wiki 全文搜索,通过本地脚本实现。详见:
```bash
cat ~/.codebuddy/skills/tapd-openapi/references/wikis/searchwiki.md
```
章节与文件索引
按说明文件中的顺序排列。
环境变量(已预置)
Workspace 处理规则
查询 API 文档
常用服务
调用流程
文件/命令 -> TAPD_API_ENDPOINT · ${TAPD_API_ENDPOINT} · TAPD_WORKSPACE_IDS · TAPD_WORKSPACE_ID · TAPD_TOKEN · WS_LIST · workspace_id=31372104 · workspace_id=68119668
内容校验值 -> 884d6cfe1801
当前原文的自动摘译,尚未人工审校。
环境变量(已预置)
TAPD_API_ENDPOINT- API 地址, 如果TAPD_API_ENDPOINT已配置,则优先使用TAPD_API_ENDPOINT的替换文档中的${TAPD_API_ENDPOINT}TAPD_WORKSPACE_IDS- 项目 ID 列表,逗号分隔,优先级高于TAPD_WORKSPACE_IDTAPD_WORKSPACE_ID- 单个项目 ID(兼容旧配置)TAPD_TOKEN- 认证 Token(Bearer 方式)Workspace 处理规则
调用前必须先确定实际使用的 workspace 列表: 若
WS_LIST只有一个 ID,按单 workspace 正常请求即可 若有多个 ID,需对每个 ID 分别调用 API,再汇总结果(求和、合并列表等,根据用户意图决定) 注意 curl 的时候 workspace_id 用逗号分隔后的,例如 $TAPD_WORKSPACE_IDS 是 "31372104,68119668",则 curl 的时候需要分别调用workspace_id=31372104和workspace_id=68119668查询 API 文档
API 文档位于
~/.codebuddy/skills/tapd-openapi/references/目录。 1. 列出所有服务: 2. 列出服务下的 API: 3. 查看 API 详情:常用服务
服务 · 说明 · 常用 API 文件 stories · 需求管理 · liststories, countstories, addstory, updatestory, getrelatedbugs, getstoryfieldsinfo bugs · 缺陷管理 · listbugs, countbugs, addbug, updatebug, getbugfieldsinfo iterations · 迭代管理 · listiterations tasks · 任务管理 · listtasks, counttasks, addtask, updatetask
调用流程
确定服务:根据需求从常用服务中选择,或用
ls查看全部 查找 API:用ls ~/.codebuddy/skills/tapd-openapi/references/{服务}/找到具体操作 获取详情:用cat读取 API 文档,获取请求方法、路径、参数 执行请求:按模板构造 curl 命令,workspace_id必传