技能介绍

要解决什么问题

在 Agent 对话里查 Timelink 的客户、项目、工时条目时，如果让模型直接拼 HTTP 请求或粘贴 API Key，既容易泄露凭证，也很难保证请求体符合当前 API 契约。你需要一种方式：在已登录 OOMOL 的前提下，用统一 CLI 调用 Timelink，且不在本地处理原始 Token。

技能如何工作

本技能通过 OOMOL 注入的凭据 与 oo CLI 的 timelink connector 执行动作。典型流程是两步：

查看契约：用 oo connector schema 拿到该动作的权威输入/输出结构，再组 --data。
执行动作：--data 传 JSON 字符串或 @path/to/file.json；省略则发送 {}。返回形如 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 在 meta.executionId。

资料中列出的 14 个动作均为读取类（get_* / list_*），覆盖例如：

单条查询：get_client、get_project、get_time_entry、get_user 等
列表与筛选：list_clients、list_projects、list_time_entries、list_active_time_entries 等
元数据：get_company、get_current_token、list_time_entry_required_fields

技能约定：默认不要主动跑 oo auth login 或打开连接页；用户已安装 oo、已登录且已连接 Timelink 时，直接执行动作。仅在命令因鉴权或连接失败时再走一次性设置（安装 CLI、登录、在 OOMOL 用 API key 连接 Timelink、或处理 402 欠费）。

适用边界与注意点

只读动作（get/list）可按资料直接调用；若后续扩展为创建、更新、发送或删除，必须先与用户确认 payload 与影响，删除类需明确批准。
列表类接口支持过滤与分页参数，具体字段以 live schema 为准，不要凭记忆硬编码。
Timelink 产品主页见 timelink.io；连接器行为以 OOMOL 侧凭证与 scope 为准，连接过期或 scope 不足时需重新连接而非重复登录骚扰用户。