SuperAPI AI 工具集

dingtalk-tb-ai-skill

通用与其它

查看项目

更新于 10-16 08:44

技能介绍

用途:面向 Teambition 的任务与项目管理技能,通过脚本调用开放平台接口,适合查询我的待办、今天或本周到期、逾期任务,以及创建、更新、归档任务,管理状态、优先级、执行人、备注、评论(支持 @提及)、进展、动态、文件上传、项目与成员查询、迭代创建/开始/完成。不适用于 Jira、Asana 等非 Teambition 平台、Git 操作或脚本未覆盖的组织管理员设置。

使用方式:先获取 User Token,可通过环境变量 export TB_USER_TOKEN="your_token",或在 dingtalk-tb-ai-skill/ 目录创建 user-token.json(内容为 {"userToken": "your_token"}),然后执行 cd dingtalk-tb-ai-skill && uv sync。脚本以 uv run scripts/xxx.py 方式调用,如查询待办:uv run scripts/query_tasks.py --tql "executorId = me() AND isDone = false";创建任务:uv run scripts/create_task.py --project-id 'xxx' --title '完成需求文档'。

主要规则:查询“我的”任务或项目必须用 executorId = me(),禁止硬编码用户 ID;create_task.py、update_task.py、manage_sprint.py 已内置东八区到 UTC 转换,直接传本地时间,不要手动传 UTC;API 返回的 executorId、creatorId、involveMembers、sprintId、stageId、projectId、parentTaskId 等 ID 字段展示前须转换为可读名称,人员用 query_members.py --user-ids 批量查询,无法确定时展示“未知”或不展示;优先级数值 0=紧急、1=高、2=中、3=低,但企业常自定义名称,展示或更新前须先经 query_project_detail.py 获取 organizationId,再用 get_priority_list.py 查询企业真实配置;归档任务移入回收站,可用 --restore 恢复,不等于删除;动态是系统操作历史,进展是用户手动填写的阶段更新;更新任务状态优先用 get_task_statuses.py <taskId>,创建任务初始状态才用 get_taskflow_statuses.py;文件上传先用 upload_file.py 获取 fileToken,再用 create_comment.py --file-tokens 附加;任务 ID 与项目 ID 应渲染为 https://www.teambition.com/task/{taskId} 和 https://www.teambition.com/project/{projectId} 链接;空值字段应隐藏;自定义字段更新时查询用 cfId、更新用 customfieldId,日期与文本类型 value 为含 title 的数组,单选类型为含 id 的数组;work 类型文件字段须用 downloadUrl 渲染为可点击链接。

限制:仅覆盖脚本已实现的能力,组织或管理员设置等未覆盖场景暂未提供;项目没有 dueDate 字段,只有 created 和 updated;分页通过 --page-size 与 --page-token 配合 nextPageToken 使用。更多 TQL 语法、任务操作与错误处理见 references 目录文档。