Oura Ring CLI 技能

描述

该工具可通过命令行界面（CLI）从 Oura Ring API（V2）获取健康与生物特征数据。可用于回答有关用户睡眠、活动、准备度及生理指标等方面的问题。

代码仓库：https://github.com/ruhrpotter/oura-cli

前提条件

CLI 必须已完成身份验证。若命令因鉴权失败而报错，请提示用户运行 ./oura auth login。

语法

./oura get [flags]

数据类别

• personal：用户个人资料（年龄、体重、身高、邮箱）。
• sleep：每日睡眠得分与睡眠效率。
• activity：每日活动得分、步数与身体活动量。
• readiness：每日准备度得分，反映身体恢复状态。
• heartrate：心率时间序列数据。
• workout：详细运动记录。
• spo2：血氧饱和度水平。
• sleep-details：详细睡眠记录（含睡眠周期图 hypnogram）。
• sessions：活动时段记录（例如小睡、休息）。
• sleep-times：最佳就寝时间建议。
• stress：每日压力水平。
• resilience：每日韧性得分与恢复情况。
• cv-age：心血管年龄估算值。
• vo2-max：最大摄氧量（VO2 Max）测量值。
• ring-config：戒指硬件配置（颜色、尺寸等）。
• rest-mode：休息模式启用时段。
• tags：增强型标签（备注、生活方式选择等）。

参数

• --start ：**大多数时间序列数据必需**。指定查询范围的起始日期。
• --end ：**可选**。指定查询范围的结束日期。若未提供，则可能默认为起始日期，或根据上下文返回单日数据。

智能体操作说明

1. 日期解析：你必须将所有相对日期表述（例如“今天”、“昨天”、“上周”、“本月”）基于当前运行日期，转换为绝对的 YYYY-MM-DD 字符串格式。
2. 日期范围处理：
   • 对于“今天”：将 --start 设为今日日期。
   • 对于“昨天”：将 --start 设为昨日日期。
   • 对于“过去 7 天”：将 --start 设为 7 天前的日期，--end 设为今日日期。
3. 路径假设：除非用户另行指定，否则默认二进制文件位于当前工作目录下，路径为 ./oura。
4. 输出处理：CLI 返回 JSON 格式响应。请解析其中的 data 数组，并据此生成自然语言形式的回答。

示例

用户请求：“我昨晚的睡眠怎么样？”
上下文：当前日期为 2024-03-15。“昨晚”通常指结束于今日清晨的睡眠阶段，或依据 Oura 的日期逻辑（Oura 按睡眠结束的早晨日期归档睡眠数据），对应前一日的数据。
推理：2024 年 3 月 14 日晚至 15 日晨的睡眠记录在 Oura 中标记为 2024-03-15。
命令：

./oura get sleep --start 2024-03-15

用户请求：“我今天的准备度得分是多少？”
上下文：当前日期为 2024-03-15。
命令：

./oura get readiness --start 2024-03-15

用户请求：“显示我 2024 年 1 月第一周的心率数据。”
命令：

./oura get heartrate --start 2024-01-01 --end 2024-01-07

用户请求：“我是谁？”
命令：

./oura get personal