时间记录助手

要解决的问题

团队把工时、项目耗时等数据放在 Timely 里管理，但这套流程有不少环节靠手工完成：打开网页、找到对应的时间条目、确认项目与任务归属、补录忘记打卡的时间段，再导出报表做汇总。偶尔还需要批量调整已有记录。每一步本身不复杂，真正消耗精力的是来回切换界面和重复填写表单。

当 Agent 需要替人执行这类操作时，障碍更直接：Timely 的 API 没有统一暴露给模型，认证流程与工具形态各不相同。

技能的工作方式

这个技能本身不直接对接 Timely，而是通过 Rube MCP 走 Composio 的 Timely 工具集，让模型用统一的方式驱动远端操作。

工作流程大致分四步：

• 工具发现：任何操作之前先调用 RUBE_SEARCH_TOOLS，拿到当前可用的工具列表、slug、输入字段和推荐执行计划。技能明确要求不要硬编码工具名和参数，因为 schema 会随上游更新变化。
• 连接管理：用 RUBE_MANAGE_CONNECTIONS 传入 toolkit: timely 检查连接状态；未激活时按返回的授权链接完成授权，回到 ACTIVE 之后再继续。
• 执行与批量操作：普通调用走 RUBE_MULTI_EXECUTE_TOOL，需要一次跑多个工具时用 RUBE_REMOTE_WORKBENCH 里的 run_composio_tool()；带 schemaRef 的工具可通过 RUBE_GET_TOOL_SCHEMAS 取完整结构。
• 状态与分页：会话内复用 session ID，新任务生成新的 ID；响应里出现分页 token 时要继续拉取直到拿全。

适用边界与注意点

几个容易踩坑的地方，都是 SKILL.md 里明确列出的：

• 永远先搜索再调用。直接写死工具 slug 会在上游改字段后静默失败。
• 调用前确认连接状态。授权过期、刚换账号这类情况下，工具返回的错误往往比连接检查结果更隐蔽。
• 严格对齐 schema。字段名和类型照抄搜索结果，不要凭经验补参数。
• 不要省略 memory 参数。即使是空对象 {} 也要传，否则部分执行路径会报错。
• 分页必须走完。只取首页会漏掉时间记录，尤其在导入历史数据时后果明显。

这个技能的定位是"把 HTTP 请求细节外包给 Composio"，适合需要程序化读写 Timely 数据的自动化脚本、Agent 工作流和内部工具集成。如果只是偶尔手动记一条工时，直接打开网页更简单。