Agent Skills
返回列表
TAPD工时批量填报助手

TAPD工时批量填报助手

办公效率 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2d9e4ad2/tapd-timesheet 到你的 AI 助手中。

技能介绍

要解决的问题

TAPD 工时填报常把工程师拉回逐天录入:周末和节假日要人工剔除,多任务精力占比要反复手算,提交失败后还容易重复重试。该技能把流程收敛为一个本地页面应用,用 tapd_proxy.py 代理处理 TAPD API 的 CORS、Bearer Token 认证和失败状态判定,适合把上月、本周等周期的一次性填报做成可预览、可作废、可重试的工作流。

工作方式

  • 打开 tapd-timesheet-v4.html,并保持 tapd_proxy.py 在 127.0.0.1:8899 运行
  • 配置 TAPD 个人访问令牌和姓名,系统从 19 位任务 ID 中推导 workspace_id
  • 选择周期、编辑工作日,内置 2024-2027 节假日数据
  • 添加任务 ID、精力 % 和独立日期范围,系统校验合计为 100%
  • 生成 日期 × 任务 预览后逐条提交,并展示进度
  • 本地 localStorage 保存最近 100 条历史,支持批量作废并调用 TAPD 删除接口

边界与注意

  • 面向单用户桌面浏览器,不提供多人协作和移动端适配
  • 仅支持 entity_type: 'task',不支持需求或缺陷实体
  • 不与 TAPD 已提交工时双向同步;已提交记录不能直接修改,只能作废后重新提交
  • 节假日数据为静态内置,过期后需手动更新;提交和删除都依赖本地代理

使用场景

  • 周一把上月全部工作日按任务精力拆好,预览无误后一键批量提交到 TAPD。
  • 新增两个前端任务后,调整各自日期范围和精力百分比,让合计保持100%再生成预览。
  • 发现某日误填后,在历史记录勾选该条提交记录并批量作废,再重新提交正确任务。
  • 提交时遇到401或workspace_id不匹配,根据代理日志和任务ID长度排查配置。

适合人员

  • 需要每月把多任务开发工作量按天填入 TAPD 的前端工程师
  • 要把周期内任务精力拆到100%再提交的项目成员
  • 提交后发现工时填错、需要通过历史批量作废再重交的研发
  • 用本地 HTML 和 Python 代理调用 TAPD API 的办公工具维护者