前言¶

开发者在项目过程中往往需要手动在禅道上填写工时，逐条确认任务名称、输入剩余工时、校对时间记录。这既重复又容易出错。zentao-autoreport 这类 Agent Skill 可以在对话中描述今天的工作，自动匹配任务并调用禅道接口记录工时，减少手动操作。

是什么¶

zentao-autoreport 是一个基于通用 SKILL.md 格式的 Agent Skill，用于禅道自动记工时。由用户 user_1c6c2daa 发布，归类于 office-efficiency，版本为 1.0.3，来源为 community。它适配禅道 21.x 开源版，使用 recordworkhour 接口。

核心功能¶

• 智能匹配：用户描述今天做了什么事，Skill 自动搜索匹配的任务。
• 自动记录：确认后调用禅道 API 记录工时。
• 自动重新登录：处理会话过期或认证问题。
• 正确计算剩余工时：在记录工时时自动计算并填写剩余工时。

安装与启用¶

官方地址：https://api.skillhub.cn/user_1c6c2daa/zentao-autoreport

以 Cursor 为例：
1. 打开 Cursor 的 Extensions 面板。
2. 在 Marketplace 搜索「zentao-autoreport」或直接导入官方 URL。
3. 安装完成后在会话中激活该 Skill。

以 Codex CLI 为例（如有差异请以官方文档为准）：
1. 在项目目录下创建或编辑 .skillhub 目录。
2. 将 Skill 源码或配置放入相应路径。
3. 在 CLI 中启用该 Skill。

以 Claude Code 为例（如有差异请以官方文档为准）：
1. 打开 Claude Code 的 Skills 配置页面。
2. 添加「zentao-autoreport」并填入来源地址。
3. 保存并重载会话。

典型用法¶

在对话中按以下方式描述工作内容：

• 「今天我完成了项目 A 的需求 1 和需求 2，每个需求用了 2 小时。」
• 「修复了禅道 bug 1001，耗时 1.5 小时。」

Skill 会：
1. 提取任务名称或 ID。
2. 搜索禅道中的对应任务。
3. 列出匹配结果供确认。
4. 调用 recordworkhour 接口记录工时并填写剩余工时。

适用场景与注意¶

• 适合需要频繁在禅道上记工时的团队或个人。
• 要求禅道 21.x 开源版可用，并配置好 API 访问权限。
• 需要提供 API Key 等认证信息。
• 如遇会话过期，Skill 会自动尝试重新登录。

结尾¶

zentao-autoreport 将手工工时记录流程自动化，减少重复操作和录入错误。官方地址：https://api.skillhub.cn/user_1c6c2daa/zentao-autoreport