工时统计助手

解决终端工时管理痛点

在开发工作流中，频繁切换到 Clockify 网页端记录工时或核对历史数据不仅打断心流，还容易因为手动输入导致时间戳不准确或账单（Billable）状态遗漏。这个技能将 Clockify 的核心操作直接暴露给 AI 代理，让你在终端里通过自然语言就能完成时间追踪，无需离开代码编辑器。

核心能力与关键步骤

技能通过 MCP 协议连接 Clockify 账户，主要支持以下工作流：

• 时间条目管理：使用 CLOCKIFY_CREATE_TIME_ENTRY 创建条目，支持关联项目、任务和标签。如果不填 end 参数，系统会自动开启一个运行中的计时器。
• 历史数据查询：利用 CLOCKIFY_GET_TIME_ENTRIES 按日期范围、项目或标签过滤历史记录。设置 hydrated: true 可以返回包含项目和任务详情的完整对象，方便直接生成报表。
• 工作区与成员审计：通过 CLOCKIFY_GET_ALL_MY_WORKSPACES 和 CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE 获取多工作区权限和团队成员信息。

推荐操作路径：先调用工作区接口获取 workspaceId，再获取当前用户信息得到 userId，最后利用这两个 ID 进行具体的工时创建或查询。

适用边界与注意点

• 强依赖 ID 参数：大多数接口强制要求 workspaceId 和 userId，请务必在操作前通过查询接口解析这两个值。
• 严格的时间格式：所有时间参数必须使用带时区的 ISO 8601 格式（如 2026-02-11T09:00:00Z），否则会导致不可预知的错误。
• 单一计时器限制：Clockify 同一时间只允许运行一个计时器。在开启新任务前，请先通过 in-progress: true 检查并停止已有的计时器。