Agent Skills
返回列表
Worktile

Worktile

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_414b3bb0/worktile-v2。

技能介绍

要解决什么问题

研发协作数据往往锁在 Worktile 项目、任务、工时与组织架构里。若要在 Agent 或脚本里按团队鉴权（Tenant）查询、创建或更新这些数据，需要自行处理 tenant-access-token、分页参数，以及公有云与私有部署在 BASE_URL、文件上传域名上的差异。本技能把上述细节收敛为可复用的 Open API 封装与脚本入口。

技能如何工作

技能通过 Worktile Open API 访问研发管理平台，默认面向 团队鉴权 Tenant 模式。使用前将 .env.example 复制为 .env，填写管理员在「管理后台 → 应用管理 → 我的应用」中创建的 ClientId 与 Client Secret，并确认应用已开启 Tenant 鉴权。

环境适配方面：未配置 BASE_URL 或地址含 worktile.com 时按公有云处理（默认 https://dev.worktile.com）；私有部署需填写形如 http://host:port/worktile-openapi 的地址。常规接口走 {BASE_URL}/open-api/{path}；文件上传在公有云固定为 https://wt-box.worktile.com，私有部署则由 BASE_URL 推导 worktile-box 路径。可用 WORKTILE_DEPLOYMENT_TYPE=public|private 强制指定部署类型。

能力覆盖 项目（列表、创建、属性、工时统计、模板与状态）、任务（分页与 V2 过滤、状态流转、关联、附件、派生/依赖关系、归档与激活）、工时（类别、登记与列表）、成员与部门、周报，以及审批、目标、看板、文件与 WebHook 等接口。共享模块 _worktile_api.py 作为统一入口，便于在代码中直接导入调用。

适用边界与注意点

  • 公有云与私有部署的应用凭证不通用，需在对应环境分别注册应用。
  • 技能描述的是 Open API 能力与封装方式，具体业务字段以官方 API 文档与租户配置为准。
  • 文件上传与 Open API 基址分离是设计使然；私有部署勿手动写死公有云 box 域名。

使用场景

  • CI 构建或发布失败时，用 Tenant API 在指定 Worktile 项目里创建缺陷任务并写入负责人与描述。
  • 迭代结束前按项目 ID 调用任务 V2 过滤接口，拉取未完成项与状态流转信息做站会清单。
  • 核对交付记录时，通过工时列表与 `get-tasks-workload` 接口按任务汇总本周登记工时。
  • 私有部署环境下配置 `BASE_URL` 后，脚本批量更新任务状态或添加附件，避免手工在网页逐条操作。

适合人员

  • 要把 Jenkins/GitLab 流水线结果自动写成 Worktile 任务或状态更新的 DevOps 工程师
  • 每周需从多项目分页导出任务、关联与归档情况做迭代复盘的研发项目经理
  • 维护 Worktile 私有部署、为内部集成申请 Tenant 应用凭证的企业 IT 或平台管理员
  • 在对话式 Agent 里查询部门成员、创建项目并登记任务工时的研发协作或 PMO 负责人