Clockify Automation
作者 ComposioHQClockify Automation 帮助 Claude Code 用户通过 Rube MCP 自动化 Clockify 时间跟踪，包括创建时间条目、查询历史记录、管理工作区上下文，以及审计团队活动。
该 skill 得分为 68/100，意味着可以收录，但更适合作为轻量级 MCP skill 呈现，而不是完整的自包含自动化套件。目录用户能够获得足够信息来判断何时使用它——通过 Rube 自动化 Clockify 的时间条目、工作区以及用户/时间审计——也有足够的参数指引，可比通用提示词更准确；但实际采用仍依赖外部 toolkit 文档，以及预先配置好的 Rube MCP server。
- 有效的 skill frontmatter 声明了必需的 MCP 依赖（`rube`），并明确说明其用于 Clockify 自动化。
- SKILL.md 包含设置步骤，并链接到 Composio Clockify toolkit 文档，便于查看工具级细节。
- 核心工作流示例点名了 `CLOCKIFY_CREATE_TIME_ENTRY` 等具体工具，并列出 `workspaceId`、`start`、`end`、`projectId`、`taskId`、标签、可计费状态和自定义字段等关键参数。
- 未提供安装命令，也没有配套的 README 或支持文件；设置仅限于添加 Rube MCP server 并完成 Clockify 认证。
- 仓库证据显示实际工作流信号较少，也没有 SKILL.md 之外的脚本或参考资料，因此用户可能需要熟悉 Clockify/Composio，才能处理 ID、权限和边界情况。
Clockify Automation skill 概览
Clockify Automation 能做什么
Clockify Automation 是一个 Claude Code skill，可通过自然语言控制 Clockify 时间追踪，并使用 Rube MCP server 和 Composio Clockify toolkit。它可以帮助你创建工时记录、查询历史记录、管理 workspace 上下文、查看用户信息，以及审计团队活动，无需在终端和 Clockify UI 之间来回切换。
适合的用户与使用场景
这个 skill 适合已经在使用 Clockify、并希望提升工时录入效率的开发者、顾问、代理机构、团队负责人和运营人员。它真正解决的并不只是“记录工时”，而是把零散的工作上下文转换成完整的 Clockify API 操作，并准确带上 workspaceId、project、task、日期、billable 标记、tags 和 description。
它和普通 prompt 有什么不同
普通 prompt 可以帮你起草一段工时说明，但无法可靠地执行 Clockify 操作。Clockify Automation skill 的价值在于，它会把用户请求映射到具体的 toolkit action，例如 CLOCKIFY_CREATE_TIME_ENTRY，并要求使用 Clockify 原生标识符和 ISO 8601 时间值。对于需要可重复 Workflow Automation、而不只是建议的场景，这种结构能显著减少歧义。
采用前需要考虑的要点
你需要一个 Clockify 账号、Claude Code，以及对 Rube MCP server https://rube.app/mcp 的访问权限。这个 skill 只有一个可见源文件 SKILL.md，安装很轻量，但用户必须提供准确的 workspace、project、task、tag 和 user ID。如果你的团队高度依赖自定义的 Clockify 使用规范，应先把这些规则文档化，再期待自动化输出达到高质量。
如何使用 Clockify Automation skill
Clockify Automation 安装上下文
要使用 Clockify Automation skill，请从 ComposioHQ/awesome-claude-skills 中的 composio-skills/clockify-automation 安装或启用它，然后在 Claude Code 中配置 Rube MCP server URL：https://rube.app/mcp。首次使用时，需要通过连接链接认证你的 Clockify 账号。上游 skill 不包含辅助脚本或额外参考目录，因此应先阅读 SKILL.md；如果需要 tool 级别的细节，再核对 Composio toolkit 文档：https://composio.dev/toolkits/clockify。
执行前需要准备的输入
想让 Clockify Automation 发挥稳定效果，关键是提供精确的 Clockify 上下文。请准备：
- 目标 workspace 的
workspaceId - 需要分类记录时的
projectId和taskId - ISO 8601 格式的开始和结束时间，并包含时区
- 符合你们报表标准的 description 文本
- 必要时的
tagIds、billable和 custom field 值 - 查询记录或审计团队工作时需要的 user 或 date 过滤条件
较弱的请求是：“记录我今天上午的 API 工作。”
更好的请求是：“Use Clockify Automation to create a billable entry in workspace 64a687e3, project 64a687e2, from 2026-02-11T09:00:00Z to 2026-02-11T11:00:00Z, description API development for invoice endpoint, with tag IDs ["backend","client-work"] if valid.”
实用的 Clockify Automation 使用流程
如果你还不知道相关 ID，先让 skill 识别 workspace 和可用的 project 上下文。接着以小批量方式创建或查询记录，不要一开始就自动化整张 timesheet。日常使用中，一个可靠流程是：
- 查询目标日期已有记录，避免重复。
- 用精确的开始/结束时间戳创建缺失记录。
- 确认 billable 状态、project、task 和 tags。
- 请求按 project 或 client 分组的汇总。
- 修正任何不匹配的 ID，再复用这一模式。
这样可以避免最常见的失败：把看似合理的记录写进了错误的 workspace 或 project。
能提升输出质量的 prompt 模式
使用面向操作的 prompt，并明确要执行的 Clockify 操作。例如：
- “Create a running timer for workspace
...starting now with descriptionCode review.” - “Find all time entries for user
...in workspace...between2026-02-01and2026-02-07.” - “Audit yesterday’s team entries and flag missing descriptions, non-billable entries on billable projects, and entries longer than 8 hours.”
这类 prompt 通常比宽泛请求效果更好，因为它们包含了操作类型、范围、日期和校验标准。
Clockify Automation skill 常见问题
Clockify Automation 适合新手吗？
适合，前提是你已经理解自己 Clockify workspace 的结构。新手可以用它记录和搜索工时记录，但可能需要先弄清 workspace、project、task 和 tag ID。这个 skill 不能替代你对组织内部 Clockify 数据组织方式的学习。
什么时候不该使用这个 skill？
如果你只需要一段书面的 timesheet 总结、无法通过 Rube MCP 认证 Clockify，或者请求过于模糊，无法安全地修改工时记录，就不要使用 Clockify Automation。对于敏感的计费流程，应先让 skill 查询并预览记录，再创建或编辑任何内容。
它和 Clockify 的 web app 有什么不同？
Clockify 的 web app 更适合可视化检查和手动编辑。Clockify Automation skill 更适合终端优先的工作流、可重复的自然语言操作，以及跨工时记录的快速审计。对于希望在开发环境中由 Claude Code 处理结构化 Clockify 操作的 Workflow Automation 场景，它尤其有用。
安装前应该读什么？
阅读 composio-skills/clockify-automation/SKILL.md。它包含设置流程、核心工作流、示例 tool calls，以及 workspaceId、start、end、projectId、taskId、tagIds、billable 和 customFieldValues 等重要参数。skill 文件夹中没有额外的本地脚本或资源，因此这个源文件就是主要实现指南。
如何改进 Clockify Automation skill
改进 Clockify Automation 的输入
提升结果质量最快的方法，是维护一份小型内部参考资料，记录你们的 Clockify ID：workspace、projects、tasks、tags、users 和 custom fields。同时写明命名规则，例如“client work must be billable”或“support entries require tag support”。然后把相关部分粘贴到 prompt 中，这样 skill 就不必自行推断业务逻辑。
避免常见失败模式
注意时区歧义、缺少结束时间、重复记录、错误的 workspace ID，以及不一致的 project 命名。如果请求会影响计费，先要求 dry-run 风格的计划：“List the entries you intend to create, including IDs and timestamps, before calling the Clockify tool.” 这会在不放弃自动化的前提下增加一个有用的检查点。
根据第一次输出继续迭代
完成第一次查询或创建后，用具体修正继续细化：“Change the description to include ticket API-482,” “mark only the client project entries as billable,” 或 “split the 4-hour entry into two 2-hour entries by task.” 最好的迭代方式，是引用 skill 返回的具体 entry 细节，而不是重新描述整个目标。
让它更适合团队工作流
团队使用时，应标准化日常记录、周度审计和缺失记录检查的 prompt 模板。一个放在 repo 内部的高质量 Clockify Automation 指南，可以包含批准使用的 project IDs、必填 tags、计费规则和示例 prompts。这些本地上下文会把 skill 从一个方便的 Clockify 快捷方式，提升为可靠的团队自动化层。