禅道自动工时助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1c6c2daa/zentao-autoreport 到你的 AI 助手中。
技能介绍
为什么需要它
在禅道里记录工时通常要打开任务页、找任务、手填耗时,和实际开发或项目推进混在一起时容易漏记。zentao-autoreport 解决的问题是:用户用自然语言说出“今天做了 xxx,花了 x 小时”后,技能先把描述匹配到当前用户名下的任务,经用户确认再调用禅道接口写入工时,减少从描述到记录之间的断点。
技能如何工作
核心流程围绕配置、匹配、确认、写入展开。首次使用时会询问 ZENTAO_URL、ZENTAO_ACCOUNT、ZENTAO_PASSWORD,并保存到 /root/.config/zentao/.env。随后技能会获取用户所有任务,把工作描述与任务名称或上下文做语义匹配,列出候选任务请用户确认;若匹配不准,可以重新匹配或手动指定 taskID。确认后会重新登录获取最新 zentaosid,查询任务当前剩余工时 left,计算 newLeft = left - consumed,再调用 recordworkhour 接口提交。脚本会优先使用 Python 版本,否则回退到 shell 版本。
适用边界与注意点
该技能面向禅道 21.x 开源版的任务工时记录,适合已经使用禅道 task 模块、且希望从聊天式描述补记工时的场景。它依赖用户名下任务信息可查询,匹配结果仍需人工确认,避免把工时写到错误任务。密码保存在本机配置文件中,需要按团队安全要求管理;若禅道接口版本、登录态或任务权限变化,可能需要调整脚本中的接口路径或鉴权方式。
使用场景
- 开发完成一天任务后,把自然语言工作描述匹配到禅道任务并确认后写入工时。
- 项目经理需要核对当天多个事项,把模糊描述重新匹配或手动指定任务ID后补记。
- 运维或研发在禅道21.x任务模块下,刷新zentaosid并提交recordworkhour接口。
- 团队已配置ZENTAO_URL、账号和密码,希望按保存的凭证自动查询用户任务。
适合人员
- 使用禅道任务模块、希望用自然语言补记当日工时的研发工程师。
- 需要确认匹配结果、避免工时写错任务的项目负责人。
- 维护本地.env凭证、希望复用脚本自动调用recordworkhour接口的运维。
- 管理多人工时录入、希望先匹配任务再人工确认的项目助理。