前言¶
寵物夜間是否睡得安穩，主人很難靠肉眼盯完一整晚。寵物醫院和寄養中心在做住院觀察時，也缺少一種能持續記錄睡眠時長、翻身次數和驚醒頻次的低成本手段。下面介紹的這個 Skill 面向的就是這類”長時間無人值守、需要從固定畫面裏統計睡眠行爲”的場景。
這是什麼¶
這是一個基於通用 SKILL.md 格式的數據分析類 Skill，由社區開發者 user_bb47e3e3 發佈，座標 @user_bb47e3e3/sleep-quality-analysis-analysis，當前版本 1.0.0。它解決的是這樣一個問題：給定寵物窩或休息區的固定攝像頭畫面，自動判斷寵物處於睡眠還是覺醒狀態，並把整段觀察期的睡眠行爲彙總成可量化的指標。
SkillHub 頁面顯示，它分類爲 data-analysis，來源爲 community，當前評分 100000，下載 1032 次，安裝 0 次。名稱寫作”Pet Sneeze / Cough Detection | 寵物睡眠質量分析（時長/翻滾次數）”，但從官方簡介看，實際能力集中在睡眠時長與體動統計，標題裏的”Sneeze / Cough”字樣在簡介中沒有對應的功能描述，使用時以簡介能力爲準。
核心功能¶
官方簡介中寫明的能力有四項，均圍繞固定攝像頭畫面做離線或準實時分析：
1、睡眠/覺醒狀態判定：通過運動檢測和姿態識別，判斷畫面中的寵物處於靜止（睡眠）還是活動（覺醒）狀態。
2、睡眠總時長累計：按判定結果累加整個觀察時段內的睡眠時長。
3、體動統計：統計翻身次數、位置變化次數，以及驚醒（startle-awakening）頻次。
4、睡眠質量評分：綜合上述指標輸出 0-100 分的睡眠質量評分。
簡介同時說明了這套指標的用途：幫助主人識別寵物可能存在的疼痛、焦慮或疾病跡象。注意這是”輔助觀察”定位，評分本身不構成診斷結論。
安裝與啓用¶
該 Skill 以 SKILL.md 格式分發，官方地址爲 https://api.skillhub.cn/user_bb47e3e3/sleep-quality-analysis-analysis ，對應的 SkillHub 頁面爲 https://www.skillhub.cn/skills/user_bb47e3e3/sleep-quality-analysis-analysis 。
啓用方式上，已抓取資料只提供了座標和標籤信息，沒有給出命令行安裝命令，也沒有列出具體的配置字段。可以確認的兩點是：
1、Skill 座標爲 @user_bb47e3e3/sleep-quality-analysis-analysis，需在所安裝的 Agent 環境中按此座標引用。
2、頁面標籤爲 requires_api_key=true，說明使用前需要準備好對應的 API Key，具體在哪個配置項中填入，以官方頁面或運行環境的說明爲準。
本次寫作時官方頁面未能成功抓取，因此 Cursor、Codex CLI、Claude Code 三類環境下的安裝命令差異無法覈實，這裏不做推測。如果你手頭已有該 Skill 的安裝文檔，優先以文檔爲準。
典型用法¶
根據官方簡介還原的可復現流程如下：
1、把攝像頭固定在寵物窩或休息區上方，確保整個睡眠區域完整入畫，寵物起身、翻身時不會離開視野。
2、在夜間或寵物的主要睡眠時段持續錄製或推流，把這段視頻作爲輸入交給 Skill。
3、Skill 在畫面上依次完成運動檢測與姿態識別，逐段判定睡眠與覺醒狀態，並累加睡眠總時長。
4、同時統計區間內的位置變化次數與驚醒頻次。
5、輸出睡眠質量評分（0-100 分），以及對應的睡眠時長、翻身次數、驚醒次數明細。
輸入應當是固定機位、視角穩定的視頻；鏡頭畫面抖動或寵物頻繁離開畫面，會直接影響運動檢測和姿態識別的結果。
適用場景與注意¶
適合的場景是官方簡介中列出的四類：
1、寵物家庭夜間監護：主人不在臥室時，記錄寵物整晚的睡眠與體動情況。
2、老年寵物健康管理：長期追蹤睡眠時長與翻身次數，爲健康變化留下可比對的記錄。
3、寵物醫院住院觀察：住院期間對動物做睡眠層面的持續觀察。
4、寵物寄養中心：在寄養期間向寵物主人提供睡眠側的照護記錄。
使用時的限制和坑，主要來自能力邊界和環境：
1、依賴固定機位。畫面移動、角度頻繁變化時，運動檢測和姿態識別的判定會失真，該 Skill 不適用於手持或跟隨拍攝。
2、需要 API Key。標籤 requires_api_key=true 表明調用前必須完成密鑰配置。
3、統計口徑以”靜止”和”體動”爲主。淺睡、多夢這類主觀狀態無法區分，翻身次數與驚醒次數是行爲層面的近似統計。
4、評分不能替代獸醫判斷。簡介提到的疼痛、焦慮或疾病識別，指的是通過睡眠指標發現異常趨勢，最終診斷仍需專業檢查。
5、多寵物共用一個窩時，姿態識別很難把翻身歸屬到具體個體，這類場景下統計口徑需要先明確。
結尾¶
這個 Skill 的價值在於把”盯着寵物睡覺”這件無法整晚人工完成的事，轉成可量化的睡眠時長、翻身次數和驚醒頻次，並給出 0-100 的睡眠質量評分。它適合固定機位、夜間長時段的觀察場景，作爲健康趨勢記錄使用。官方地址：https://api.skillhub.cn/user_bb47e3e3/sleep-quality-analysis-analysis 。
