米家（Mijia）コントロール汎用AIエージェント技能パッケージ

Tool
米家（Mijia）コントロール汎用AIエージェント技能パッケージ

米家（Mijia）コントロール汎用AIエージェント技能パッケージ

本リポジトリは、Xiaomi 米家（Mijia）デバイスの操作を目的とした「汎用型 AI エージェント技能パッケージ」です。Claude の Agent Skills をはじめ、ローカルファイルの読み取りや Python/CLI 実行が可能な任意の AI アシスタント（GitHub Copilot、Cursor、Open Interpreter 等）で動作します。SKILL.md によるトリガー定義、.agent-rules による非Claudeモデル向けの行動規約、instructions.md による標準作業手順（SOP）を備え、mijiaAPI を利用するスクリプト群で実機制御を行います（依存は requirements.txt に明記）。

https://github.com/lllooollpp/mijia-skills

概要

これは Xiaomi の「米家（Mijia）」エコシステムを AI エージェントから操作するための汎用スキルパッケージです。Claude の Agent Skills として設計されていますが、ローカルファイルを読み、Python や CLI を実行できる任意の AI アシスタントにも対応します。SKILL.md に技能の入口・トリガーとコアロジックを定義し、instructions.md で自己点検やデバイス検出、例外処理のフローを標準化します。.agent-rules により、Claude 以外のモデルへ行動規範を明示できる点が特徴です。実行用のスクリプト群と mijiaAPI を利用したドライバ連携で、ローカルネットワーク上の Mijia デバイスを自動制御します。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 4
  • ファイル数: 9
  • メインの言語: Python

主な特徴

  • Claude の Agent Skills に対応しつつ、任意の Python/CLI 実行可能な AI アシスタントで利用可能
  • SKILL.md による技能定義と instructions.md による SOP（自己点検・デバイス照合・例外処理）
  • .agent-rules で非Claudeモデル向けの行動規範を提供
  • mijiaAPI を利用したスクリプト群でローカルの Mijia デバイスを操作

技術的なポイント

本プロジェクトは「技能（Skill）」を明確に分離して設計しており、エージェント側のトリガー判定・実行ロジックと実際のデバイス制御用ドライバを分離している点がポイントです。SKILL.md が技能のエントリーとなり、ここで「いつ・どのように」この技能を起動するか（トリガー条件や期待する入力／出力）を宣言します。instructions.md は標準作業手順（SOP）として、技能実行前の自己チェック（環境・依存パッケージの確認）、ターゲットデバイスの発見・識別、異常時のフォールバックやログ出力の手順を細かく定めることで、AI による自動実行の信頼性を高めています。

.mijia-skills は Claude の Agent Skills を想定しているものの、.agent-rules を置くことで Claude 以外（GitHub Copilot、Cursor、Open Interpreter など）にも行動原則を明示でき、ファイルベースで技能を読み取るエージェントであれば互換性が出ます。実行部分は Python スクリプト群（scripts/）と mijiaAPI ライブラリに委ねられ、requirements.txt に依存関係を明示。setup_env.py などのユーティリティは環境整備を自動化して、mijiaAPI のインストールチェックや必要な C ライブラリの確認を行います。

設計上の注目点は「ローカル実行」と「最小権限」。デバイス操作はローカルネットワークを介するため認証情報やトークンの扱い、CLI 実行による任意コード実行のリスク管理が重要です。README では環境分離（仮想環境）や依存の監査を推奨しており、SOP による逐次チェック・ログ記録により安全性を担保しようとする姿勢が見て取れます。拡張性としては、SKILL.md と scripts を編集して他メーカーのデバイス向けアダプタを追加することが容易で、エージェント側でのトリガー拡張も比較的に単純です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .agent-rules: file
  • CSDN_BLOG_POST.md: file
  • README.md: file
  • README_EN.md: file
  • SKILL.md: file

…他 4 ファイル

まとめ

Claude 以外のエージェントにも対応する、実用的で拡張性の高い Mijia 制御スキル集。

リポジトリ情報：

READMEの抜粋：

米家控制通用 AI 代理技能包

English Version

这是一个通用型 AI 代理技能包。不仅支持 Claude (通过 Agent Skills)，也支持任何能够读取本地文件、执行 Python/CLI 的 AI 助理（如 GitHub Copilot, Cursor, Open Interpreter 等）。

📁 目录结构

  • .agent-rules: [新增] 通用代理规则文件，用于向非 Claude 模型声明行为准则。
  • SKILL.md: 技能入口。定义了触发条件和核心运行逻辑。
  • instructions.md: 标准作业程序 (SOP)。详细规定了模型如何自检、匹配设备以及处理异常。
  • requirements.txt: 该技能及其底层驱动包 mijiaAPI 所需的 Python 依赖项列表。
  • scripts/: 核心执行脚本。
    • setup_env.py: 检查当前 Python 环境是否安装了 mijiaAPI 包以及 C…