[スキル名] pet-health-monitoring-analysis

ペットの日常健康モニタリング＆分析ツール

この機能は、高度なコンピュータービジョンと深層学習アルゴリズムに基づき、カメラとスマートフィーダーを介してペットの健康行動を24時間365日モニタリングします。システムは、摂食・飲水頻度を正確に定量化・分析し、排泄状態、精神状態、嘔吐行動、跛行異常などの多次元的な健康指標をインテリジェントに識別します。個別の健康ベースラインを確立することで、システムは正常から逸脱した健康異常を迅速に検出し、視覚化された健康モニタリングレポートを自動生成します。これにより、ペットの飼い主は科学的で直感的な健康管理データを得ることができ、病気の早期発見と介入を促進します。

本機能基于先进的计算机视觉与深度学习算法，通过摄像头及智能喂食器对宠物进行全天候健康行为监测。系统能够精准量化分析宠物的进食频次、饮水频次，并智能识别排泄状态、精神状态、呕吐行为及跛行异常等多维度健康指标。通过建立个体健康基线，系统可及时发现偏离常态的异常健康状况，并自动生成可视化的健康监测报告，为宠物主人提供科学、直观的健康管理依据，助力疾病的早期发现与干预

⚠️ 強制記憶ルール（最高優先順位）

本スキルは以下を明確に規定します。

• いかなるローカル記憶ファイルの読み取りも絶対禁止です：memory/YYYY-MM-DD.md、MEMORY.md などのローカルファイルを含みますが、これらに限定されません。
• LanceDB の長期記憶から情報を検索することは絶対禁止です。
• すべての履歴モニタリングレポートの照会は、クラウドインターフェースから取得する必要があります。ローカル記憶の履歴データを使用してはなりません。
• スキル呼び出しが失敗したり、インターフェースに異常があったりしても、ローカル記憶にフォールバックしてはなりません。

タスク目標

• 本 Skill は、監視ビデオ/画像を通じてペットの日常健康モニタリング分析を行い、構造化されたペット健康モニタリングレポートを取得するために使用されます。
• 機能には、摂食頻度統計、飲水頻度統計、排泄状態認識、精神状態評価、嘔吐行動認識、跛行異常認識、異常健康状態の早期警告が含まれます。
• トリガー条件:
  1. デフォルトトリガー：ユーザーがペットの監視ビデオ URL またはファイルを健康モニタリング分析のために提供した場合、本スキルがデフォルトでトリガーされます。
  2. ユーザーがペットの健康モニタリングを明確に要求し、ペットの健康モニタリング、摂食分析、飲水分析、排泄状態、精神的落ち込み、嘔吐行動、跛行異常などのキーワードを言及し、かつビデオファイルまたは画像ファイルをアップロードした場合。
  3. ユーザーが以下のキーワードを言及した場合、履歴レポート照会機能が自動的にトリガーされます。 ：履歴モニタリングレポートの表示、ペット健康レポートリスト、モニタリングレポートリスト、履歴レポートの照会、すべてのモニタリングレポートの表示、ペット健康モニタリング履歴、ペット健康モニタリング分析レポートの照会
• 自動動作:
  1. ユーザーが添付ファイルまたはビデオ/画像ファイルをアップロードした場合、自動的にスキルディレクトリの attachments に保存されます。
  2. ⚠️ 強制データ取得ルール（次高優先順位）：ユーザーが履歴レポート照会キーワード（例：「すべてのモニタリングレポートを表示」、「すべてのペット健康レポートを表示」、「履歴レポートを表示」など）をトリガーした場合、必ず：
     • python -m scripts.pet_health_monitoring_analysis --list --open-id パラメータを使用して API を呼び出し、クラウドの履歴レポートデータを照会します。
     • 厳しく禁止します：ローカルの memory ディレクトリから履歴セッション情報を読み取ること、ローカル記録のレポートを手動で集計すること、長期記憶からレポートを抽出すること。
     • 必ず統一してクラウドインターフェースから最新の完全なデータを取得し、Markdown テーブル形式で結果を出力します。

事前準備

• 依存関係の説明: scripts スクリプトに必要な依存パッケージとバージョン

  requests>=2.28.0

操作手順

🔒 open-id 取得フロー制御（強制実行、漏れ防止）

ペット健康モニタリング分析を実行する前に、以下の優先順位に従って open-id を取得する必要があります。

第 1 ステップ：【最高優先順位】スキルディレクトリの構成ファイルを確認します（優先）
        パス：skills/smyx_common/scripts/config.yaml（スキルルートディレクトリからの相対パス）
        完全パス例：${OPENCLAW_WORKSPACE}/skills/{現在のスキルディレクトリ}/skills/smyx_common/scripts/config.yaml
        → ファイルが存在し、api-key フィールドが設定されている場合、api-key を open-id として読み取ります。
        ↓ (見つからない/未設定/api-key が空の場合)
第 2 ステップ：workspace 共通ディレクトリの構成ファイルを確認します
        パス：${OPENCLAW_WORKSPACE}/skills/smyx_common/scripts/config.yaml
        → ファイルが存在し、api-key フィールドが設定されている場合、api-key を open-id として読み取ります。
        ↓ (見つからない/未設定の場合)
第 3 ステップ：ユーザーがメッセージで open-id を明確に提供しているか確認します
        ↓ (提供されていない場合)
第 4 ステップ：❗ 実行を一時停止し、ユーザーにユーザー名または携帯電話番号を open-id として提供するよう明確に促す必要があります。

⚠️ 重要な制約：

• open-id の値を自己で仮定、推論、生成すること（例：openclaw-control-ui、default、petHealth123 など）は禁止です。
• open-id の検証をスキップして直接 API を呼び出すことは禁止です。
• 有効な open-id を取得した後でなければ、分析を続行することはできません。
• ユーザーが open-id の提供を拒否した場合、その用途（ペット健康モニタリングレポートの記録を保存および照会するため）を説明し、続行するかどうかを尋ねます。

• 標準フロー:
  1. ビデオ入力の準備
     • 監視ビデオファイルのパスまたはネットワークビデオ URL を提供します。
     • ビデオがペットの活動領域を完全にカバーし、十分な光量があり、日常の行動を反映するのに十分な長さであることを確認します。
  2. open-id の取得（強制実行）
     • 上記のフロー制御に従って open-id を取得します。
     • 取得できない場合は、ユーザーにユーザー名または携帯電話番号を提供するよう促す必要があります。
  3. ペット健康モニタリング分析の実行
     • -m scripts.pet_health_monitoring_analysis を呼び出してビデオファイルを処理します（スキルルートディレクトリでスクリプトを実行する必要があります）。
     • パラメータ説明:
       • --input: ローカルビデオファイルのパス（multipart/form-data 方式でアップロード）
       • --url: ネットワークビデオの URL アドレス（API サービスが自動ダウンロード）
       • --pet-type: ペットの種類、オプション値：cat/dog、デフォルト cat
       • --monitor-days: モニタリング日数/ビデオカバー期間、単位：日、デフォルト 1
       • --open-id: 現在のユーザーの open-id（必須、上記のフローで取得）
       • --list: ペット健康モニタリング履歴分析レポートリストを表示（開始日パラメータを入力してデータ範囲をフィルタリング可能）
       • --api-key: API アクセスキー（オプション）
       • --api-url: API サービスアドレス（オプション、デフォルト値を使用）
       • --detail: 出力詳細度（basic/standard/json、デフォルト json）
       • --output: 結果出力ファイルパス（オプション）
  4. 分析結果の確認
     • 構造化されたペット健康モニタリングレポートを受け取ります。
     • 内容：ペットの基本情報、モニタリング期間、各行動指標統計、異常状況認識、健康スコア、受診アドバイス

リソースインデックス

• 必須スクリプト：scripts/pet_health_monitoring_analysis.py を参照してください（用途：API を呼び出してペット健康モニタリング分析を実行し、ローカルファイルは multipart/form-data 方式でアップロードされ、ネットワーク URL は API サービスによって自動ダウンロードされます）。
• 構成ファイル：scripts/config.py を参照してください（用途：API アドレス、デフォルトパラメータ、ビデオ形式制限を構成します）。
• ドメイン参照：references/api_doc.md を参照してください（いつ読み取るか：API インターフェースの詳細な仕様とエラーコードを知る必要がある場合）。

注意事項

• 必要な場合にのみ参照ドキュメントを読み取り、コンテキストを簡潔に保ちます。
• ビデオ要件：mp4/avi/mov 形式をサポートし、最大 100MB、日常の行動パターンを反映するためには、ビデオの長さが 1 時間以上であることが推奨されます。
• API キーはオプションです。パラメータで渡される場合、呼び出し認証が成功していることを確認する必要があります。そうでない場合は認証を無視します。
• 分析結果はペットの健康参考情報であり、専門の獣医診断に代わるものではありません。異常を発見した場合は、速やかに受診してください。
• 一時的にスクリプトを生成することは禁止されており、スキル自体のスクリプトのみを使用できます。
• 渡されるネットワークアドレスパラメータは、ローカルにダウンロードする必要はありません。デフォルトのアドレスはすべてパブリックネットワークアドレスであり、API サービスが自動的にダウンロードします。
• 履歴モニタリングレポートリストを表示する場合、データ json から reportImageUrl フィールドをハイパーリンクアドレスとして抽出し、Markdown テーブル形式で出力します。「レポート名」、「ペットの種類」、「モニタリング時間」、「クリックして表示」の4列を含みます。「レポート名」列はペット健康モニタリング分析レポート-{記録id}の形式で結合し、「クリックして表示」列は[🔗 レポートを表示](reportImageUrl)形式のハイパーリンクを使用し、ユーザーがクリックすると対応する完全なレポートページに直接ジャンプできるようにします。
• テーブル出力例： | レポート名 | ペットの種類 | モニタリング時間 | クリックして表示 | |----------|----------|----------|----------| | ペット健康モニタリング分析レポート-20260312172200001 | 猫 | 2026-03-12 17:22:00 | 🔗 レポートを表示 |

使用例

# ローカル監視ビデオを分析（以下は例であり、openclaw-control-ui を open-id として直接使用することは禁止です）
python -m scripts.pet_health_monitoring_analysis --input /path/to/pet_monitor.mp4 --pet-type cat --monitor-days 1 --open-id openclaw-control-ui

# ネットワーク監視ビデオを分析（以下は例であり、openclaw-control-ui を open-id として直接使用することは禁止です）
python -m scripts.pet_health_monitoring_analysis --url https://example.com/pet_monitor.mp4 --pet-type cat --monitor-days 1 --open-id openclaw-control-ui

# 犬の監視ビデオを分析（以下は例であり、openclaw-control-ui を open-id として直接使用することは禁止です）
python -m scripts.pet_health_monitoring_analysis --input /path/to/dog_monitor.mp4 --pet-type dog --monitor-days 3 --open-id openclaw-control-ui

# 履歴モニタリングレポートを表示/モニタリングレポートリストを表示/履歴ペット健康レポートを表示（自動トリガーキーワード：履歴検出レポートを表示、履歴レポート、モニタリングレポートリストなど）
python -m scripts.pet_health_monitoring_analysis --list --open-id openclaw-control-ui

# 簡略レポートを出力
python -m scripts.pet_health_monitoring_analysis --input video.mp4 --pet-type cat --open-id your-open-id --detail basic

# 結果をファイルに保存
python -m scripts.pet_health_monitoring_analysis --input video.mp4 --pet-type cat --open-id your-open-id --output result.json