前言¶
在 Cursor、Claude Code 等环境里，用户常会随口问「最近睡不好」「怎么改善睡眠」。通用对话容易给出泛泛建议，又缺少固定的问诊顺序、输出结构和安全边界（例如不推荐药物、持续失眠应就医）。若希望 Agent 按同一套流程收集睡眠数据、分析问题类型并给出可执行的作息与环境建议，可以把 SkillHub 上的社区 Skill「睡眠优化师」（@user_70c2f807/sleep-optimizer）装进当前客户端的 skills 目录，由模型在匹配到睡眠相关意图时自动遵循 SKILL.md 中的步骤与限制。
这是什么¶
「睡眠优化师」是面向 life-service 场景的 Agent Skill，坐标 @user_70c2f807/sleep-optimizer，版本 1.0.0，来源为 community，由发布者 user_70c2f807 维护。Skill 标签标明 requires_api_key=false，不依赖外部 API Key。
定位（据官方 SKILL.md）：帮助用户记录睡眠数据，分析作息、饮食、环境、压力等潜在影响因素，生成个性化改善方案，覆盖入睡困难、睡眠浅、白天犯困、作息紊乱等常见问题。明确 不用于 睡眠障碍治疗、安眠药推荐或医疗诊断。
SkillHub 页面：https://www.skillhub.cn/skills/user_70c2f807/sleep-optimizer
API 元数据地址：https://api.skillhub.cn/user_70c2f807/sleep-optimizer
核心功能¶
以下能力均来自已安装的 SKILL.md（v1.0.0），供 Agent 在对话中执行：
- 现状采集：入睡/起床时间、入睡耗时、夜间醒来次数、白天精神状态及可能影响因素。
- 问题分型：区分入睡困难、睡眠维持困难、早醒；评估时长是否充足、连续性及日间精力。
- 方案输出：针对性策略、睡前 routine、睡眠环境（温度/光线/声音）、作息调整（含周末与午睡建议）、入睡技巧（如 4-7-8 呼吸、身体扫描等）。
- 记录与趋势：基于用户描述或手环数据做记录与分析（无法自动监测，需用户输入）。
- 边界与异常处理：信息不足时追问；严重或持续失眠建议就医；拒绝推荐安眠药/助眠保健品；强调习惯调整通常需 2–4 周见效。
触发关键词示例：睡眠、失眠、睡不好、sleep optimization、insomnia、sleep quality，以及用户主动要求改善睡眠。
安装与启用¶
下面介绍通过 SkillHub CLI 安装到当前 Agent 可识别的目录。安装说明以 https://skillhub.cn/install/skillhub.md 为准。
1. 检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装，可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装睡眠优化师¶
必须 使用 --dir 指向当前环境的 skills 目录，否则默认装到 ./skills/ 可能不会被客户端加载。
skillhub install sleep-optimizer --namespace user_70c2f807 --dir ~/.cursor/skills/
其他常见路径（同一文档列出，按实际客户端替换 --dir）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Gemini CLI：
~/.gemini/skills/
也可在对话中让 AI 按 SkillHub 页面提示，参照 https://skillhub.cn/install/skillhub.md 安装 @user_70c2f807/sleep-optimizer。
安装成功后，包内包含 SKILL.md（主指令）及 _meta.json（slug、version 等元数据）。修改 skills 目录后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。
典型用法¶
Skill 通过自然语言触发，无需单独命令。官方 SKILL.md 中的快速开始示例如下，可直接复现：
用户：我最近睡不好
→ Agent 按 Skill 追问：入睡困难还是易醒、大致睡眠时长等
用户：昨晚12点睡，7点醒，中间醒了2次
→ 记录数据，评估质量并给出分析
用户：怎么改善睡眠？
→ 按问题类型输出个性化改善方案
用户：我总是想太多睡不着
→ 分析入睡困难原因并推荐放松技巧
用户：周末补觉有用吗？
→ 说明补觉利弊与作息建议
执行流程在 Skill 中固定为三步：了解睡眠现状 → 分析问题（时长/质量/类型/原因）→ 制定方案（策略、睡前 routine、环境、作息）。输出宜包含睡眠数据表、多维度状态说明、影响因素列表及分块改善建议；持续约 4 周仍无改善时，Skill 要求明确建议就医。
适用场景与注意¶
适合：希望 Agent 用统一话术收集睡眠信息、区分问题类型、给出非医疗性的生活方式建议；用户愿意主动描述或提供可穿戴设备数据；需要强调固定起床时间、睡前断电、床仅用于睡眠等习惯培养。
不适合（Skill 明示）：睡眠障碍诊断、安眠药或保健品推荐、疑似睡眠呼吸暂停（需专业监测）、由严重焦虑/抑郁导致的失眠（应寻求心理治疗/医疗）。
其他限制：
- 不能替代医生；超过约 4 周的严重或持续失眠应就医。
- 改善依赖用户坚持记录与执行，短期「速效」预期需提前校准。
- SkillHub 抓取元数据显示：分类 life-service，评分 100000，下载 1075 次（页面统计会变动，以 SkillHub 为准）。
若 skillhub install 使用错误 slug 导致下载 404，应带上 --namespace user_70c2f807，与搜索结果的 install 提示一致。
结尾¶
「睡眠优化师」把睡眠相关的问诊、分析、方案输出和安全红线写进 SKILL.md，适合作为 life-service 类 Skill 接入 Cursor 等支持 Agent Skills 的客户端。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_70c2f807/sleep-optimizer ，元数据 API：https://api.skillhub.cn/user_70c2f807/sleep-optimizer 。
