Health Sync Analysis Skill
Purpose
This skill is dedicated to analyzing the user's health data across available providers:
- - Oura
- Withings
- Hevy
- Strava
- WHOOP
- Eight Sleep
The main goal is to help the user understand trends, compare signals across providers, and find useful insights from their synced data.
Scope
Use this skill when the user asks questions such as:
- - How did I sleep last night?
- How was my last workout?
- How did my resting heart rate change during the year?
- What trends are you seeing in my recovery, sleep, and training?
- What useful insights or next steps should I focus on?
Setup Handling (Remote Bootstrap Only)
Setup is bot-led and remote-first. The only supported onboarding flow is:
- 1. Bot runs
npx health-sync init remote bootstrap. - Bot sends user:
npx health-sync init --remote <bootstrap-token>. - User sends back encrypted archive.
- Bot runs
npx health-sync init remote finish <ref> <archive>.
For full operational instructions, always consult:
Do not use or recommend legacy direct setup flows such as:
- 1.
health-sync init as the primary user instruction - INLINECODE5 as a standalone onboarding path
Those commands may still exist for maintenance/debugging, but they are not the setup flow this skill should guide.
Runtime And Data Disclosure (Mandatory)
This skill assumes the bot environment has local CLI and filesystem access.
- 1. Required binary:
-
node
-
npm
-
npx
- 2. Expected local working paths:
-
workspace/health-sync/health-sync.toml
-
workspace/health-sync/.health-sync.creds
-
workspace/health-sync/health.sqlite
- 3. Sensitive-data handling:
- Remote onboarding imports encrypted archives that contain provider credentials/tokens.
- Finish flow writes decrypted secrets to local files on the bot host.
- These files must be treated as sensitive at rest (access controls, backups, retention).
- 4. Chat-safety boundary:
- Never ask users to paste raw secrets in chat.
- Only collect encrypted archive files via remote bootstrap flow.
Schema Handling
To understand data schemas and query correctly, read the provider reference files:
- - INLINECODE12
- INLINECODE13
- INLINECODE14
- INLINECODE15
- INLINECODE16
- INLINECODE17
Freshness Rule (Mandatory)
Before any analysis, always run:
CODEBLOCK0
If sync fails, report the failure clearly and continue analysis only if the user explicitly asks to proceed with potentially stale data.
Analysis Workflow
- 1. Run
npx health-sync sync first. - Identify the user question and which provider/resource(s) are relevant.
- Read the provider schema reference before forming SQL.
- Query
records, sync_state, and sync_runs as needed. - Produce a clear, user-friendly answer with concrete numbers and dates.
- Highlight meaningful patterns and offer practical guidance.
- When data quality or coverage is limited, say so explicitly.
Output Style
- - Be concise, clear, and practical.
- Focus on useful interpretation, not just raw data dumps.
- Connect metrics to actionable insights (sleep, recovery, training, consistency, etc.).
- Ask follow-up questions only when necessary to improve analysis quality.
健康同步分析技能
目的
本技能专用于分析用户在以下可用服务商中的健康数据:
- - Oura
- Withings
- Hevy
- Strava
- WHOOP
- Eight Sleep
主要目标是帮助用户了解趋势、比较各服务商之间的信号,并从同步数据中发现有价值的见解。
范围
当用户提出以下类型的问题时,请使用本技能:
- - 我昨晚睡得怎么样?
- 我上次锻炼情况如何?
- 我今年的静息心率有什么变化?
- 你在我的恢复、睡眠和训练中看到了什么趋势?
- 我应该关注哪些有用的见解或下一步行动?
设置处理(仅限远程引导)
设置为机器人主导且优先采用远程方式。唯一支持的引导流程是:
- 1. 机器人运行 npx health-sync init remote bootstrap。
- 机器人向用户发送:npx health-sync init --remote 。
- 用户发回加密存档。
- 机器人运行 npx health-sync init remote finish
[ 。]
如需完整的操作说明,请始终查阅:
请勿使用或推荐传统的直接设置流程,例如:
- 1. 将 health-sync init 作为主要用户指令
- 将 health-sync auth 作为独立的引导路径
这些命令可能仍存在于维护/调试中,但它们并非本技能应引导的设置流程。
运行时与数据披露(强制要求)
本技能假设机器人环境具有本地CLI和文件系统访问权限。
- 1. 必需的可执行文件:
- node
- npm
- npx
- 2. 预期的本地工作路径:
- workspace/health-sync/health-sync.toml
- workspace/health-sync/.health-sync.creds
- workspace/health-sync/health.sqlite
- 3. 敏感数据处理:
- 远程引导导入包含服务商凭证/令牌的加密存档。
- 完成流程将解密后的密钥写入机器人主机上的本地文件。
- 这些文件在静态存储时必须被视为敏感数据(访问控制、备份、保留)。
- 4. 聊天安全边界:
- 切勿要求用户在聊天中粘贴原始密钥。
- 仅通过远程引导流程收集加密存档文件。
模式处理
为了正确理解数据模式并进行查询,请阅读服务商参考文件:
- - references/oura.md
- references/withings.md
- references/hevy.md
- references/strava.md
- references/whoop.md
- references/eightsleep.md
数据新鲜度规则(强制要求)
在进行任何分析之前,始终运行:
bash
npx health-sync sync
如果同步失败,请清晰报告失败原因,并且仅在用户明确要求使用可能过时的数据继续分析时,才继续进行分析。
分析工作流程
- 1. 首先运行 npx health-sync sync。
- 识别用户问题以及相关的服务商/资源。
- 在编写SQL之前,先阅读服务商模式参考。
- 根据需要查询 records、syncstate 和 syncruns。
- 提供清晰、用户友好的答案,包含具体数字和日期。
- 突出有意义的模式并提供实用指导。
- 当数据质量或覆盖范围有限时,明确说明。
输出风格
- - 简洁、清晰、实用。
- 侧重于有用的解读,而非原始数据堆砌。
- 将指标与可操作的见解联系起来(睡眠、恢复、训练、一致性等)。
- 仅在必要时提出后续问题,以提高分析质量。