前言¶
做睡眠监测、健康类应用或可穿戴数据对接时，常见做法是自己在产品里堆规则：入睡怎么判、浅睡深睡 REM 怎么切、体动和觉醒怎么计数、呼吸暂停要不要单独告警。业务问一句「昨晚睡得怎么样」，开发侧往往要翻文档、对字段、再写一段解释逻辑。若希望 Coding Agent 在对话里按统一口径解读睡眠相关数据，需要一个把能力写进 SKILL.md 的社区技能，而不是每次从零写提示词。
下面介绍 SkillHub 上的 Sleep Quality Analysis Skill | 睡眠质量分析技能：面向睡眠监测场景，把阶段识别与夜间事件监测收敛到可安装的技能包里。
这是什么¶
Sleep Quality Analysis Skill 是 SkillHub 社区来源（community）的生活服务类技能，坐标为 @user_bb47e3e3/sleep-quality-analysis，当前版本 1.0.3，由发布者 user_bb47e3e3 维护。
官方简介说明：识别入睡、浅睡、深睡、快速眼动（REM）等睡眠阶段，并监测体动、夜间觉醒、睡眠呼吸暂停，适用于睡眠监测场景。页面标签标明 requires_api_key=true，使用前需自行准备并配置调用所需的 API Key（具体变量名与配置步骤以安装后技能目录内的 SKILL.md 为准，本文不臆造字段）。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_bb47e3e3/sleep-quality-analysis
- API 条目（元数据）：https://api.skillhub.cn/user_bb47e3e3/sleep-quality-analysis
核心功能¶
以下能力均来自 SkillHub 页面与抓取元数据中的简介，未单独核实实现细节的部分不展开：
- 睡眠阶段识别：入睡、浅睡、深睡、REM。
- 夜间行为与风险信号监测：体动、夜间觉醒、睡眠呼吸暂停。
- 场景定位：面向睡眠监测类产品或数据分析流程，由 Agent 按技能说明组织输出，而不是替代医疗设备诊断。
分类为 life-service；截至资料抓取时，SkillHub 显示评分 100000、下载 583、安装 0（以商店页面实时数据为准）。
安装与启用¶
SkillHub 提供两种常见入口：用自然语言让 AI 按安装文档操作，或用 skillhub CLI 装到当前 Agent 的 skills 目录。未安装 CLI 时，可先检查版本：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本技能时，必须用 --dir 指向当前环境会被识别的 skills 目录；默认装到 ./skills/ 可能不会被 Agent 加载。官方文档给出的常用路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（将 <skills 目录> 换成你当前客户端对应路径）：
skillhub install @user_bb47e3e3/sleep-quality-analysis --dir <skills 目录>
也可将下面提示词发给已支持 SkillHub 安装流程的 AI（与商店页一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bb47e3e3/sleep-quality-analysis`。
安装完成后，重启或刷新 Agent 对 skills 的加载（各客户端行为以官方文档为准），并按技能包内 SKILL.md 配置 API Key。
典型用法¶
公开页面未提供独立的可复制「示例请求」片段；可复现的流程如下：
- 按上一节将
@user_bb47e3e3/sleep-quality-analysis安装到正确的 skills 目录。 - 根据
SKILL.md完成 API Key 等前置配置（requires_api_key=true）。 - 在对话中提供睡眠监测相关数据或分析需求，由 Agent 按技能说明调用能力，输出阶段划分与体动、觉醒、呼吸暂停等维度的解读。
若需要字段级接口说明，应以安装后本地 SKILL.md 及技能附带参考文档为准。
适用场景与注意¶
适合谁
- 正在做睡眠监测、健康管理、可穿戴或床垫/手环数据后处理的开发者，希望 Agent 在编码或分析对话里沿用同一套睡眠语义。
- 已在使用 Cursor、Claude Code、Codex 等支持 Skill 目录的客户端，并愿意通过 SkillHub 管理社区技能。
限制与注意
- 社区技能（
community），能力边界与 SLA 以发布者与SKILL.md为准，医疗决策须走合规流程，不能当作诊断设备。 - 依赖外部 API 时，Key 的保管、计费与限流需自行处理；未配置 Key 时技能可能无法正常工作。
- 商店统计（下载、安装数）会变动，接入前建议在 SkillHub 页面确认版本仍为 1.0.3 或按需选择更新版本。
结尾¶
经过上面的步骤，你可以把「睡眠阶段 + 体动 / 觉醒 / 呼吸暂停」这类重复解释工作交给 Sleep Quality Analysis Skill，让 Agent 在睡眠监测场景下按技能文档组织分析。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_bb47e3e3/sleep-quality-analysis
