desktime-automation

desktime-automation skill 概览

desktime-automation 能做什么

desktime-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动化处理 DeskTime 任务。它的设计目标是帮助 AI agent 发现当前可用的 DeskTime tool schemas、验证你的 DeskTime 连接，并执行 DeskTime 相关操作，而不是依赖可能已经过时的硬编码 API 假设。

适合的用户与工作流

如果你已经在使用 DeskTime，并希望让助手围绕时间追踪、员工生产力数据、考勤类检查、项目工时复盘或运营报表来辅助 Workflow Automation，那么这个 skill 会比较适合。对于更偏好通过 MCP 访问工具、而不是从零编写自定义 DeskTime API 脚本的团队，它尤其有价值。

这个 skill 的差异点

desktime-automation skill 最重要的行为是先做工具发现。上游 skill 明确要求 agent 在执行前先调用 RUBE_SEARCH_TOOLS，以获取当前的 tool slugs、schemas、执行计划和潜在坑点。这一点很关键，因为 Composio tool schemas 可能会变化，而普通提示词可能会猜测到过时的字段名。

采用前需要考虑的事项

这不是一个独立的 DeskTime 客户端。它依赖 Rube MCP，以及通过 Composio 管理的有效 DeskTime 连接。仓库路径下只有 SKILL.md，因此它的价值主要在工作流指引，而不是辅助脚本、示例或本地代码。适合在你需要一套可复用的 agent 操作流程来处理 DeskTime 任务时安装；如果你需要的是完整打包好的应用，它并不合适。

如何使用 desktime-automation skill

desktime-automation 安装场景

在支持 Claude skills 和 MCP tools 的客户端中，从 Composio skill collection 安装该 skill。典型安装命令如下：

npx skills add ComposioHQ/awesome-claude-skills --skill desktime-automation

然后在你的客户端中添加 https://rube.app/mcp 作为 MCP server 来配置 Rube MCP。源 skill 说明 MCP endpoint 本身不需要 API keys，但你仍然需要通过 Composio 授权 DeskTime 连接。

必需的连接配置

在要求 agent 执行 DeskTime 工作之前，先确认以下条件：

1. RUBE_SEARCH_TOOLS 可用。
2. RUBE_MANAGE_CONNECTIONS 可以被调用。
3. desktime toolkit connection 状态为 ACTIVE。
4. 如果连接未激活，请根据 RUBE_MANAGE_CONNECTIONS 返回的 auth link 完成授权。
5. 只有在确认连接状态后，才运行 DeskTime 工作流。

实际阻塞点通常是授权，而不是提示词写得不够好。如果 DeskTime connection 处于非激活状态，无论请求写得多清楚，skill 都无法完成操作。

高质量使用 desktime-automation 的提示词模式

较弱的提示词是：“Check DeskTime for my team.”

更强的提示词会给 agent 一个明确用例，并要求它先发现 schemas：

Use the desktime-automation skill. First call RUBE_SEARCH_TOOLS for current DeskTime tools and schemas. Then check whether the desktime connection is active. I need a summary of DeskTime activity for the engineering team for last week, grouped by user and project if the available tools support those fields. If a required field or filter is unavailable, tell me before executing.

这样能提升输出质量，因为它明确了业务目标、日期范围、分组需求、降级处理方式，以及必须先执行的发现步骤。

依赖前应检查的文件

首先阅读 composio-skills/desktime-automation/SKILL.md。它包含完整工作流：前置条件、Rube MCP 设置、工具发现、连接检查和核心执行模式。当前目录树中没有配套的 scripts/、resources/、references/ 或 README.md 文件，因此不要期待 skill 文档之外还有额外示例。

desktime-automation skill 常见问题

desktime-automation 适合新手吗？

适合，前提是你的 AI 客户端已经支持 MCP tools，并且你能完成类似 OAuth 的连接授权流程。如果你从未配置过 MCP server，它就不算特别新手友好，因为该 skill 默认 Rube MCP 可以访问，并且 agent 能调用 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。

它比普通提示词好在哪里？

普通提示词可能会编造 DeskTime API 字段，或者跳过连接验证。desktime-automation skill 为 agent 提供了更安全的操作顺序：先发现工具、查看 schemas、检查 DeskTime 连接，然后再执行。这样的结构可以减少由过时假设导致的失败。

它可以自动化哪些 DeskTime 任务？

具体能执行哪些操作，取决于当前通过 Rube MCP 暴露出来的 Composio DeskTime toolkit。该 skill 适合用于 DeskTime 操作，例如获取时间追踪信息、检查可用的项目或用户数据，以及构建报表工作流；但在承诺结果之前，应该先让 RUBE_SEARCH_TOOLS 确认可用动作。

什么时候不应该使用这个 skill？

如果你需要离线处理、直接编写 DeskTime API 代码，或者工作流不能依赖 Composio/Rube，就不应使用它。如果你的组织尚未批准将 DeskTime 连接到第三方自动化工具，它也不适合。

如何改进 desktime-automation skill

运行 desktime-automation 前先优化输入

把请求的操作轮廓告诉 agent：日期范围、用户或团队、项目、输出格式、操作是只读还是允许写入，以及当 schema 缺少目标字段时该怎么处理。例如：“Export-style summary, read-only, last calendar month, grouped by project, include only active users if supported.”

避免常见失败模式

最常见的失败是跳过发现步骤。应明确要求 agent 针对你的具体用例调用 RUBE_SEARCH_TOOLS，而不是只用泛泛的 “Desktime operations” 查询。另一个常见失败是在连接激活前就开始运行；应要求在任何 DeskTime 操作之前，先通过 RUBE_MANAGE_CONNECTIONS 检查连接。

在第一次结果后继续迭代

把第一次运行视为 schema 发现加工作流草稿。如果输出不完整，让 agent 说明哪些字段可用、哪些过滤条件不支持，以及 Rube 推荐了什么替代执行计划。然后围绕受支持的字段优化提示词，而不是继续要求不可用的数据。

为团队专属使用补充本地指引

为了让 desktime-automation skill 更适合重复使用，可以在已安装 skill 旁维护自己的说明：已批准的 DeskTime workspaces、标准报表周期、团队名称、隐私边界和偏好的输出格式。这样可以把通用的 desktime-automation 指南转化为更安全的团队工作流，同时仍然保留必要的 Rube 工具发现步骤。