Loading...
Loading...
TAPD 敏捷研发管理平台集成。使用脚本调用 TAPD API，实现需求、缺陷、任务、迭代、测试用例、Wiki 等实体管理。使用场景包括：(1) 查询/创建/更新需求、缺陷、任务、迭代 (2) 管理测试用例和 Wiki (3) 管理评论和工时 (4) 关联需求与缺陷 (5) 获取源码提交关键字
npx skill4agent add abcfed/claude-marketplace tapdtapd.pyexport TAPD_ACCESS_TOKEN="你的个人访问令牌" # 推荐
# 或
export TAPD_API_USER="API账号"
export TAPD_API_PASSWORD="API密钥"
export TAPD_API_BASE_URL="https://api.tapd.cn" # 可选，默认
export TAPD_BASE_URL="https://www.tapd.cn" # 可选，默认
export CURRENT_USER_NICK="你的昵称" # 可选python scripts/tapd.py <command> [参数]| 命令 | 说明 |
|---|---|
| 获取用户参与的项目列表 |
| 获取项目信息 |
| 获取需求类别 |
| 命令 | 说明 |
|---|---|
| 查询需求/任务 |
| 创建需求/任务 |
| 更新需求/任务 |
| 获取数量 |
| 字段中英文对照 |
| 字段及候选值 |
| 命令 | 说明 |
|---|---|
| 查询缺陷 |
| 创建缺陷 |
| 更新缺陷 |
| 获取数量 |
| 命令 | 说明 |
|---|---|
| 查询迭代 |
| 创建迭代 |
| 更新迭代 |
| 命令 | 说明 |
|---|---|
| 查询评论 |
| 创建评论 |
| 更新评论 |
| 命令 | 说明 |
|---|---|
| 获取附件 |
| 获取图片下载链接 |
| 命令 | 说明 |
|---|---|
| 获取自定义字段配置 |
| 命令 | 说明 |
|---|---|
| 状态映射 |
| 状态流转 |
| 结束状态 |
| 命令 | 说明 |
|---|---|
| 查询测试用例 |
| 创建/更新测试用例 |
| 批量创建测试用例 |
| 命令 | 说明 |
|---|---|
| 查询 Wiki |
| 创建 Wiki |
| 更新 Wiki |
| 命令 | 说明 |
|---|---|
| 查询工时 |
| 填写工时 |
| 更新工时 |
| 命令 | 说明 |
|---|---|
| 获取待办 |
| 命令 | 说明 |
|---|---|
| 获取关联缺陷 |
| 创建关联关系 |
| 命令 | 说明 |
|---|---|
| 获取发布计划 |
| 命令 | 说明 |
|---|---|
| 获取提交关键字 |
| 命令 | 说明 |
|---|---|
| 发送企业微信消息 |
# 查询指定需求
python scripts/tapd.py get_stories_or_tasks --workspace_id 123 --entity_type stories --id 1167459320001114969
# 模糊搜索需求
python scripts/tapd.py get_stories_or_tasks --workspace_id 123 --entity_type stories --name "%登录%" --limit 20
# 查询指定状态的需求
python scripts/tapd.py get_stories_or_tasks --workspace_id 123 --entity_type stories --v_status "已验收"python scripts/tapd.py create_story_or_task --workspace_id 123 \
--name "用户登录功能" \
--description "## 需求描述\n用户可以通过账号密码登录系统" \
--priority_label "高" \
--owner "zhangsan" \
--iteration_name "Sprint 1"python scripts/tapd.py update_story_or_task --workspace_id 123 \
--id 1167459320001114969 \
--v_status "实现中"python scripts/tapd.py get_bug --workspace_id 123 --title "%登录失败%" --priority_label "高"python scripts/tapd.py create_bug --workspace_id 123 \
--title "登录页面显示异常" \
--description "输入正确密码后提示错误" \
--priority_label "高" \
--severity "严重"# 查询迭代
python scripts/tapd.py get_iterations --workspace_id 123
# 创建迭代
python scripts/tapd.py create_iteration --workspace_id 123 \
--name "Sprint 1" \
--startdate "2024-01-01" \
--enddate "2024-01-14" \
--creator "zhangsan"# 查询工时
python scripts/tapd.py get_timesheets --workspace_id 123 --entity_type story --entity_id 1167459320001114969
# 填写工时
python scripts/tapd.py add_timesheets --workspace_id 123 \
--entity_type story \
--entity_id 1167459320001114969 \
--timespent "4" \
--spentdate "2024-01-08" \
--memo "开发登录功能"# 查询评论
python scripts/tapd.py get_comments --workspace_id 123 \
--entry_type stories \
--entry_id 1167459320001114969
# 创建评论
python scripts/tapd.py create_comments --workspace_id 123 \
--entry_type stories \
--entry_id 1167459320001114969 \
--description "看起来不错，可以继续完善"# 查询需求关联的缺陷
python scripts/tapd.py get_related_bugs --workspace_id 123 --story_id 1167459320001114969
# 创建关联
python scripts/tapd.py entity_relations --workspace_id 123 \
--source_type story \
--target_type bug \
--source_id 1167459320001114969 \
--target_id 1167459320001114970# 获取状态映射
python scripts/tapd.py get_workflows_status_map --workspace_id 123 --system story
# 获取可流转状态
python scripts/tapd.py get_workflows_all_transitions --workspace_id 123 --system story# 需求
python scripts/tapd.py get_stories_or_tasks --workspace_id $WS_ID --entity_type stories
python scripts/tapd.py create_story_or_task --workspace_id $WS_ID --name "标题"
python scripts/tapd.py update_story_or_task --workspace_id $WS_ID --id $ID --v_status "状态"
# 缺陷
python scripts/tapd.py get_bug --workspace_id $WS_ID
python scripts/tapd.py create_bug --workspace_id $WS_ID --title "标题"
# 迭代
python scripts/tapd.py get_iterations --workspace_id $WS_ID
python scripts/tapd.py create_iteration --workspace_id $WS_ID --name "Sprint X" --startdate "2024-01-01" --enddate "2024-01-14"
# 工时
python scripts/tapd.py add_timesheets --workspace_id $WS_ID --entity_type story --entity_id $ID --timespent 4 --spentdate "2024-01-08"
# 评论
python scripts/tapd.py create_comments --workspace_id $WS_ID --entry_type stories --entry_id $ID --description "评论内容"| 类型 | 字段 | 可用值 |
|---|---|---|
| 需求优先级 | | High / Middle / Low / Nice To Have |
| 缺陷优先级 | | urgent / high / medium / low / insignificant |
| 缺陷严重程度 | | fatal / serious / normal / prompt / advice |
| 任务状态 | | open / progressing / done |
| 迭代状态 | | open / done |
用户: "查看需求 1167459320001114969 的详情"
Claude:
1. python scripts/tapd.py get_stories_or_tasks --workspace_id 67459320 --entity_type stories --id 1167459320001114969
2. 分析返回的需求信息get_stories_or_tasksimages{
"data": [
{
"Story": { "id": "1167459320001114969", "name": "需求标题", ... },
"images": [
{
"path": "/tfl/captures/2026-01/tapd_67459320_base64_1767668922_121.png",
"download_url": "https://file.tapd.cn/attachments/tmp_download/...?salt=...&time=...",
"filename": "tapd_67459320_base64_1767668922_121.png"
}
]
}
]
}imagesdownload_url# 如果需要单独获取某张图片
python scripts/tapd.py get_image --workspace_id 67459320 --image_path "/tfl/captures/2026-01/tapd_xxx.png"scripts/
├── tapd.py # 统一入口脚本（43个子命令）
├── tapd_client.py # TAPD API 客户端
└── requirements.txt