用途:该技能用于在 AI 代理中接入 Timely Time Tracking(一款自动化工时记录软件,旨在免去手工填写工时表),让用户或代理能够读取和管理 Timely 中的人员、项目、标签、客户、时间条目、计时器与报表等数据,并自动化相关工作流。
主要能力:借助 Membrane CLI 与 Timely 交互,覆盖 Person、Project、Label、Client、Time Entry、Timer、Report 等对象。Membrane 负责认证与凭据刷新,代理无需自行处理鉴权。既可调用预置动作,也可通过代理直接请求 Timely API。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。执行 membrane login --tenant --clientName=<agentType> 登录(agentType 如 claude、openclaw、codex、warp、windsurf 等);无头环境会打印授权 URL,需用户在浏览器打开,完成后执行 membrane login complete <code>。用 membrane connection ensure "https://timelyapp.com/home-2" --json 建立连接,若状态为 BUILDING,可用 npx @membranehq/cli@latest connection get <id> --wait --json 轮询至 READY;若为 CLIENT_ACTION_REQUIRED,按 clientAction 提示操作。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。无合适动作时可用代理请求:membrane request CONNECTION_ID /path/to/endpoint,并支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项;多数命令加 --json 可得机器可读输出。
适用场景:需要自动读取或管理 Timely 工时与项目数据、按意图发现并执行 Timely 相关操作、在项目管理和计费等工作流中复用数据。
限制:官方文档为 https://developers.timelyapp.com/;具体可用动作、参数与返回结构需通过 action list 实际查询确认。该技能依赖 Membrane 服务与 CLI。资料未提供收费、价格、平台覆盖或性能效果等信息。