Teambition project management via Python scripts: projects, tasks, task traces, comments, files, members. Use when: (1) querying/creating/updating tasks or projects, (2) managing task progress and comments, (3) uploading files to tasks, (4) querying team members. NOT for: non-Teambition platforms, direct API calls without scripts, or operations not covered by available scripts.
Instrucciones de origen · Vista previa de solo lectura
name
dingtalk-tb-ai-skill
description
Teambition project management via Python scripts: projects, tasks, task traces, comments, files, members. Use when: (1) querying/creating/updating tasks or projects, (2) managing task progress and comments, (3) uploading files to tasks, (4) querying team members. NOT for: non-Teambition platforms, direct API calls without scripts, or operations not covered by available scripts.
# 查询我的待办任务
uv run scripts/query-tasks.py --tql "executorId = me() AND isDone = false"# 查询特定项目的任务
uv run scripts/query-tasks.py --tql "projectId = '项目ID'"# 本周创建的任务,按创建时间降序
uv run scripts/query-tasks.py --tql "created <= endOf(w) AND created >= startOf(w) ORDER BY created DESC"# 过去 7 天更新过的我的任务,按更新时间降序
uv run scripts/query-tasks.py --tql "executorId = me() AND updated >= startOf(d, -7d) ORDER BY updated DESC"# 我的逾期未完成任务,按截止时间升序
uv run scripts/query-tasks.py --tql "executorId = me() AND isDone = false AND dueDate < startOf(d) ORDER BY dueDate ASC"# 查询标题包含关键词的任务
uv run scripts/query-tasks.py --tql "title ~ '需求'"# 只查询任务ID,不获取详情
uv run scripts/query-tasks.py --no-details
# 组合使用多个参数
uv run scripts/query-tasks.py --tql "executorId = me() AND isDone = false" --page-size 20
# 查询我创建的项目
uv run scripts/query-projects.py --tql "creatorId = me()"# 查询我参与的项目
uv run scripts/query-projects.py --tql "involveMembers = me()"# 按名称搜索项目
uv run scripts/query-projects.py --tql "nameText ~ '产品开发'"# 本周创建的项目,按创建时间降序
uv run scripts/query-projects.py --tql "created <= endOf(w) AND created >= startOf(w) ORDER BY created DESC"# 今天更新过的项目,按更新时间降序
uv run scripts/query-projects.py --tql "updated <= endOf(d) AND updated >= startOf(d) ORDER BY updated DESC"# 过去 7 天创建的我参与的非模板项目
uv run scripts/query-projects.py --tql "isTemplate = false AND involveMembers = me() AND created >= startOf(d, -7d) ORDER BY created DESC"# 查询已归档的项目
uv run scripts/query-projects.py --tql "isSuspended = true"# 查询本月创建且我参与的项目
uv run scripts/query-projects.py --tql "created >= startOf(M) AND involveMembers = me()"
查询项目详情
根据项目 ID 查询项目的详细信息,支持简单和详细两种信息级别。
uv run scripts/query-projects-detail.py <项目ID> [选项]
参数说明:
参数
类型
必需
说明
项目ID
字符串
是
项目 ID 集合,使用逗号分隔
--detail-level
字符串
否
详细程度:simple(默认)或 detailed
--extra-fields
字符串
否
简单模式下额外包含的字段,逗号分隔
简单信息(simple,默认)包含字段:
字段
说明
id
项目 ID
name
项目名称
description
项目描述
visibility
可见性(public/private)
isTemplate
是否是模板项目
creatorId
创建人 ID
isArchived
是否在回收站
isSuspended
是否已归档
created
创建时间
updated
更新时间
详细信息(detailed) 额外包含:logo(项目 LOGO)、organizationId(企业 ID)、uniqueIdPrefix(任务 ID 前缀)、startDate(开始时间)、endDate(结束时间)等 20+ 个字段。
# 查询单个项目(简单信息)
uv run scripts/query-projects-detail.py 67ec9b8c3c6130ac88605c3e
# 查询详细信息
uv run scripts/query-projects-detail.py 67ec9b8c3c6130ac88605c3e --detail-level detailed
# 查询多个项目
uv run scripts/query-projects-detail.py 67ec9b8c3c6130ac88605c3e,67ec9b8c3c6130ac88605c3f
# 更新任务状态
uv run scripts/update-task-status.py --task-id "任务ID" --status-id "状态ID"# 更新优先级(0=紧急, 1=高, 2=中, 3=低)
uv run scripts/user-update-task-priority.py --task-id "任务ID" --priority "0"# 更新任务备注
uv run scripts/update-task-note.py --task-id "任务ID" --note "更新后的备注"
任务 — 归档与恢复
# 归档任务(移入回收站)
uv run scripts/call-user-api.py PUT "v3/task/任务ID/archive"# 恢复任务
uv run scripts/call-user-api.py POST "v3/task/任务ID/restore"'{}'
任务评论与动态
# 创建评论(支持附件和 @提及)
uv run scripts/call-user-api.py POST "v3/task/任务ID/comment"'{"content": "评论内容"}'# 查询任务动态
uv run scripts/call-user-api.py GET "v3/task/任务ID/activity/list"
任务进展
# 获取任务进展列表
uv run scripts/call-user-api.py GET "v3/task/任务ID/traces"# 创建任务进展
uv run scripts/call-user-api.py POST "v3/task/任务ID/trace/create"'{"title":"已完成需求分析","content":""}'
文件上传
# 上传文件到任务
uv run scripts/upload-file.py --task-id "任务ID" --file-path "/path/to/file"