Teambition Skill

通过 Python 脚本（uv run）管理 Teambition 项目、任务和团队协作。

适用场景

✅ 适合使用本技能：

• 通过 TQL 查询项目、任务或任务详情
• 创建、更新或归档任务
• 管理任务进展、评论和动态
• 上传文件到任务
• 查询企业成员或当前用户信息
• 更新任务优先级和状态

不适用场景

❌ 不要使用本技能：

• 操作非 Teambition 平台（Jira、Asana 等）
• 不通过脚本直接调用 REST API
• 管理脚本未覆盖的 Teambition 组织/管理员设置
• Git 操作或代码管理 → 直接使用 git

环境准备

# 安装 uv（如未安装）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装依赖
cd dingtalk-tb-ai-skill && uv sync

Token 配置

从 Teambition 开放平台 获取 Token，然后通过以下任一方式配置：

# 方式 1：环境变量
export TB_USER_TOKEN="your_token_here"

# 方式 2：Claw 配置文件（~/.openclaw/openclaw.json）
 { "skills": { "entries": { "dingtalk-tb-ai-skill": { "enabled": true, "env": { "TB_USER_TOKEN": "your_token" } } } } }

任务查询完整指南

使用 TQL（任务查询语言）查询 Teambition 任务，支持分页，默认自动获取简单详情。

查询任务列表

uv run scripts/query-tasks.py [选项]

参数说明：

TQL 快速参考

完整 TQL 参考：请查看 任务 TQL 参考文档

常用查询示例

# 查询我的待办任务
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

查询任务详情

根据任务 ID 查询任务的详细信息，支持简单和详细两种信息级别。

uv run scripts/query-tasks-detail.py <任务ID> [选项]

参数说明：

简单信息（simple，默认）包含字段：