timely-automation

timely-automation skill 概览

timely-automation 能做什么

timely-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动化 Timely 操作。它的核心价值不是提供一套固定的 Timely 脚本，而是教会 agent 先用 RUBE_SEARCH_TOOLS 发现当前可用的 Timely tool schema，验证 Timely 连接状态，然后针对具体任务执行正确的 Rube MCP tool。

当你希望 AI assistant 更可靠地处理 Timely workflow automation 时，timely-automation 很适合使用，尤其是那些 tool 名称、必填字段或 API schema 可能变化的操作场景。

最适合的用户与任务

timely-automation skill 适合已经在使用 Timely、并希望 Claude 协助处理运营类任务的用户，例如查找可用的 Timely action、准备 tool call、检查连接状态，以及通过 Composio 运行受支持的 workflow。对于更偏好 tool-driven automation、而不是手动管理时间追踪的团队，它尤其有价值。

如果你只是需要关于时间追踪的自然语言建议、不使用 Timely，或者无法在 AI client 中连接 Rube MCP，那么它的帮助就比较有限。

核心差异：先发现 schema

这份 timely-automation 指南中最重要的行为规则是“先搜索 tools”。它不会假设一个静态 API contract，而是要求在执行前先调用 RUBE_SEARCH_TOOLS。这一点很关键，因为 Composio tool schema 可能演进，过期的 prompt 可能悄悄失败，或发送不完整的字段。

这个 skill 的实际工作流是：发现 tools，验证 timely 连接，查看必填输入，执行操作，然后检查结果。

采用前需要考虑的事项

安装 timely-automation 之前，先确认你的 client 支持 MCP，并且可以把 https://rube.app/mcp 添加为 server。源 skill 只有一个 SKILL.md，没有 helper scripts 或本地 resources，因此能否顺利采用主要取决于你的 MCP 配置、Timely 授权，以及 prompt 质量，而不是仓库侧提供的工具。

如何使用 timely-automation skill

timely-automation 安装上下文

从 GitHub skill repository 安装该 skill：

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

然后在你的 AI client 中添加 Rube MCP：

https://rube.app/mcp

源 skill 说明 MCP endpoint 不需要单独的 API key，但你仍然需要一个有效的 Timely 连接。实际使用时，在开始任何 Timely 工作前，先让 agent 检查 RUBE_SEARCH_TOOLS 是否可用。

运行 workflow 前的必要设置

可靠使用 timely-automation 的流程应从连接验证开始：

1. 确认 RUBE_SEARCH_TOOLS 有响应。
2. 使用 RUBE_MANAGE_CONNECTIONS，并指定 toolkit timely。
3. 如果连接状态不是 ACTIVE，按照返回的授权链接完成授权。
4. 在要求 agent 执行任何 Timely action 之前，重新检查状态。

不要跳过这一步。很多看起来像是“AI 失败”的问题，实际上是 app 连接未激活，或缺少 schema 字段。

把粗略目标改写成可执行 prompt

较弱的 prompt：

Update my Timely stuff.

更好的 prompt：

Use the timely-automation skill. First call RUBE_SEARCH_TOOLS for the exact Timely task: “find supported operations for managing Timely entries and projects.” Check the timely connection with RUBE_MANAGE_CONNECTIONS. If active, show me the available tool options, required fields, and any risks before executing. Do not run a write action until I approve the prepared tool call.

这个写法更可靠，因为它明确点名 skill，强制进行 schema discovery，区分读取与写入操作，并要求在执行前进行审查。

优先阅读的文件

先阅读 composio-skills/timely-automation/SKILL.md。它包含完整的操作约定：前置条件、设置方式、tool discovery，以及核心 workflow pattern。这个 skill 路径下没有 README.md、metadata.json、rules/、resources/ 或 scripts/ 文件，因此主文件就是事实来源。

对于具体 tool 的行为，应参考链接的 Composio Timely toolkit 文档和实时的 RUBE_SEARCH_TOOLS 输出，而不是凭示例猜测。

timely-automation skill 常见问题

timely-automation 是用于 Workflow Automation 还是报表？

timely-automation skill 主要用于通过 Timely 的 Composio toolkit 做 Workflow Automation。它可以帮助发现可能支持类似报表任务的 tools，但其可靠范围取决于运行时 RUBE_SEARCH_TOOLS 针对你已连接的 Timely 账号返回的内容。

它比普通 prompt 好在哪里？

普通 prompt 可能会编造 Timely API 字段，或依赖过时的假设。timely-automation 会指导 agent 先查询 Rube MCP，获取当前 tool schema，再继续执行，因此 workflow 更有依据，执行时也更安全。

新手可以使用吗？

可以，前提是能够配置 MCP 并完成 Timely 连接流程。新手应要求 agent 在执行前解释每个发现的 tool，并展示必填字段。如果你还不熟悉如何审批 tool call，建议先从只读的 discovery 任务开始。

什么时候不该使用 timely-automation？

当 Timely 连接未激活、你的 client 无法访问 Rube MCP，或任务需要 Timely 不支持的行为时，不应使用它。对于“clean up my account”这类含糊的写入请求，也应避免直接使用，除非你提供清晰约束，并要求在变更前先获得批准。

如何改进 timely-automation skill

用任务细节改进 timely-automation prompt

输入越具体，tool 选择就越准确。建议包含：

• 你关注的具体 Timely 对象，例如 time entries、projects、users、clients 或 tags
• 任务是只读，还是可以修改数据
• 日期范围、项目名称、用户名或筛选条件
• 写入操作前的审批要求
• 期望的输出格式，例如 summary、table 或 prepared tool call

这样可以减少无效 discovery，并帮助 agent 把你的目标映射到正确的 Composio tool。

需要预防的常见失败模式

最常见的问题包括 Timely 授权未激活、跳过 tool discovery、必填字段不完整，以及写入请求范围过大。可以要求 agent 做到以下几点来避免：

1. 针对具体 use case 搜索 tools。
2. 验证 timely 连接。
3. 展示所选 tool slug 和 schema。
4. 询问缺失字段。
5. 在破坏性或大规模变更前请求批准。

在第一次输出后继续迭代

拿到第一次 discovery 响应后，不要从头开始，而是在原有基础上细化 workflow。例如：

Use the same Rube session. Narrow the Timely tool search to updating time entries for last week. Compare the required fields across candidate tools and recommend the safest one before execution.

这样可以保留上下文，减少重复设置，并提升决策质量。

按需添加本地操作规则

如果你的团队有特定的 Timely 使用方式，可以在本地 prompt 或项目指令中补充规则，例如 “never modify locked periods”、“always filter by workspace” 或 “summarize before executing bulk changes”。上游的 timely-automation skill 有意保持轻量，因此本地 guardrails 是在不改变“先 discovery”核心模式的前提下，将它适配到你们 workflow 的最佳方式。