Oura Ring_AI Agent skill-PHP中文网

Oura Ring

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 Oura Cloud API V2 拉取 Oura Ring 的就绪/睡眠及 7 天就绪趋势，生成晨间就绪简报。

Oura Ring(V1),这一技能为拉动准备状态、睡眠和Oura V2 API的7天准备状态趋势提供了小型的、面向公众的参考执行(/v2/usercollec

功能概述

Oura Ring(V1),这一技能为拉动准备状态、睡眠和Oura V2 API的7天准备状态趋势提供了小型的、面向公众的参考执行(/v2/usercollec是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Oura Ring（V1）

该技能提供了一个小型、公开可用的参考实现，用于从 Oura V2 API（/v2/usercollection/*）拉取 Readiness、Sleep 及 7 日 Readiness 趋势 数据。

快速参考

CLI（原始数据）：
- python3 skills/oura-ring/cli.py --format json --pretty readiness
- python3 skills/oura-ring/cli.py --format json --pretty sleep
- python3 skills/oura-ring/cli.py --format json --pretty trends
- python3 skills/oura-ring/cli.py --format json --pretty resilience
- python3 skills/oura-ring/cli.py --format json --pretty stress
晨间简报（格式化输出）：
- ./skills/oura-ring/scripts/morning_brief.sh

功能特性

晨间 Readiness 简报：基于最新评分生成的可执行建议。
趋势分析：对过去 7 天内各项评分变化的深入洞察。
韧性追踪（Resilience Tracking）：实时映射压力管理能力。

配置步骤

1) 安装依赖（推荐使用 venv）

macOS / Homebrew 安装的 Python 常会阻止系统级的 pip install（参见 PEP 668），因此请使用虚拟环境：

python3 -m venv skills/oura-ring/.venv
source skills/oura-ring/.venv/bin/activate
python -m pip install -r skills/oura-ring/requirements.txt

2) 创建 `.env` 文件

创建 skills/oura-ring/.env：

cp skills/oura-ring/.env.example skills/oura-ring/.env
# 然后编辑 skills/oura-ring/.env

CLI 将读取以下环境变量：

OURA_TOKEN（必需）
OURA_BASE_URL（可选；默认为 https://api.ouraring.com/v2/usercollection）

获取 Oura Token（OAuth2 流程）

Oura V2 使用 OAuth2 Bearer Token。

创建一个 Oura API 应用：
- https://cloud.ouraring.com/oauth/applications
设置重定向 URI（本地测试时可设为类似 http://localhost:8080/callback 的地址）。
打开授权 URL（请将 CLIENT_ID、REDIRECT_URI 和 scope 替换为实际值）：

https://cloud.ouraring.com/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&scope=readiness%20sleep

完成授权后，你将被重定向至所设的 Redirect URI，并附带一个 code=... 查询参数。
使用该 code 换取 access token：

curl -X POST https://api.ouraring.com/oauth/token 
  -H 'Content-Type: application/x-www-form-urlencoded' 
  -d grant_type=authorization_code 
  -d client_id=CLIENT_ID 
  -d client_secret=CLIENT_SECRET 
  -d redirect_uri=REDIRECT_URI 
  -d code=AUTH_CODE

将返回的 access_token 写入 skills/oura-ring/.env，格式为：OURA_TOKEN=...。

注意事项：

Access token 可能过期；如有需要，请使用 refresh_token 进行刷新。
请勿提交你的 .env 文件。

使用方法

Readiness 数据

python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty readiness

Sleep 数据

python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty sleep

Trends（最近 7 天；分页返回）

python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty trends

封装脚本：晨间 Readiness 简报

./skills/oura-ring/scripts/morning_brief.sh

自定义 .env 文件路径：

OURA_ENV_FILE=/path/to/.env ./skills/oura-ring/scripts/morning_brief.sh

启用模拟模式运行（无需 token）：

OURA_MOCK=1 ./skills/oura-ring/scripts/morning_brief.sh

验证（无需 token）

python3 skills/oura-ring/cli.py --mock readiness --format json
python3 skills/oura-ring/cli.py --mock sleep --format json
python3 skills/oura-ring/cli.py --mock trends --format json

作者最新文章

WPS如何调整流程图中图形的旋转方向？

2026-11-09 10:00

WPS如何修改思维导图中内容的字号大小?

2026-11-09 10:00

WPS如何将流程图中的多个图形垂直居中对齐？

2026-11-09 10:00

WPS如何将思维导图的结构调整为组织结构图？

2026-11-09 10:00

Word如何在思维导图中插入水印？

2026-11-09 10:00

WPS如何对流程图进行重命名？