Communitygithub.com

LiveHotspot

LiveHotspot: ラップトップのテザリング接続をmacOS、Windows、Linuxで維持するエージェントスキル

LiveHotspot とは?

LiveHotspotは、ラップトップがスマートフォンのホットスポットに接続している際に、アイドル状態やOSの省電力機能によって接続が切れる問題を解決するためのエージェントスキルです。このスキルは、macOS、Windows、Linuxの3つの主要OSをサポートし、それぞれのOSに最適な方法でホットスポット接続を維持します。macOSではLaunchAgentとシェルスクリプト、WindowsではタスクスケジューラとPowerShell、LinuxではNetworkManagerとsystemdサービスを利用して、定期的なキープアライブパケットの送信や接続監視を行います。直接実行モードの他に、弱いローカルエージェントが実行できるコピペ可能なプロンプトも提供し、ユーザーの承認なしに特権昇格や隠れた処理を行わないよう、透明性とセキュリティを重視しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add LongChangPost/livehotspot

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

LiveHotspot は何をしますか?

運用モデル

ホットスポットの不安定さを、以下の2つの関連する問題として扱います。

  1. 長時間の作業中にラップトップがスリープしたり、ディスクがアイドル状態になったり、Wi-Fiが切断される。
  2. スマートフォンのホットスポットまたはOSのWi-Fiスタックが、クライアントが非アクティブであると判断し、切断する。

ライブマシンを処理する最小限で透過的な修正を使用します。ネイティブコマンド、ユーザーレベルのスケジューラ、可読性の高いスクリプト、ログ、シンプルなロールバックコマンドを優先します。コンパイル済みバイナリ、難読化、認証情報のスクレイピング、ブラウザ/セッションへのアクセス、ステルス的な永続化、隠しウィンドウのトリック、グローバルな電源設定の変更、管理者権限の昇格は、ユーザーが明示的に承認しない限り避けてください。

このスキルは2つのモードで動作する必要があります。

  • 直接実行モード: 現在のエージェントがライブマシン上で診断と修正をインストールします。
  • 委任モード: 現在のエージェントは、assets/agent-prompt.zh.md からコピーペーストが可能な単一のプロンプトをユーザーに提供し、より弱いローカルエージェントがワークフローを実行できるようにします。

ワークフロー

  1. OSとホットスポットの役割を確認します。

    • クライアントモード: ラップトップがスマートフォンのホットスポットに接続します。これがこのスキルのデフォルトです。
    • ホストモード: ラップトップが他のデバイス向けにホットスポットを作成します。references/windows.md または references/linux.md にあるOS固有の注意事項を参照してください。クライアントの前提条件を盲目的に適用しないでください。
  2. 変更を加える前に現在の状態を検査します。

    • macOS: route -n get default, ipconfig getifaddr en0, networksetup -getairportnetwork en0, pmset -g assertions
    • Windows: netsh wlan show interfaces, ipconfig, powercfg /requests
    • Linux: nmcli -t -f DEVICE,TYPE,STATE,CONNECTION dev, ip route, systemd-inhibit --list
  3. OSに対応したパスを選択します。

    • macOS: scripts/macos-livehotspot.sh とユーザー LaunchAgent を使用します。references/macos.md を参照してください。
    • Windows: 透過的なPowerShellスクリプトを実行するユーザータスクスケジューラアクションを使用します。references/windows.md を参照してください。
    • Linux: 利用可能な場合はNetworkManagerとユーザー systemd サービス/タイマーを使用します。references/linux.md を参照してください。
  4. AVとセキュリティ体制は地味に保ちます。

    • スクリプトは、ASCIIパスを持つ通常のユーザーディレクトリに保存します。
    • 通常のユーザーログパスにログを記録します。
    • curl | sh、base64ペイロード、エンコードされたPowerShellコマンド、レジストリのRunキー、LaunchDaemon、ルートサービス、ブラウザ自動化、または認証情報APIを使用しないでください。
    • ユーザーから見えるコマンドラインと文書化されたOS APIを優先します。
    • 最終的な回答にはアンインストールコマンドを含めます。
  5. 証拠をもって検証します。

    • サービス状態、プロセス/アサーションの証拠、最新のログ行、および短い時間枠での安定性チェックをユーザーに表示します。
    • 現在のOSでテストを実行できない場合は、その旨を伝え、代わりにドライラン/構文チェックを提供します。

コピーペーストエージェントプロンプト

ユーザーが別のエージェントにこの機能を使用させたい場合、assets/agent-prompt.zh.md のテキストを返します。その安全ルールを要約して省略しないでください。重要なのは、弱いエージェントに完全で明示的な実行手順書を提供することです。

判断ポイント

  • ホットスポットがmacOS上のiPhoneである場合、SSIDだけでなく、ルート/ゲートウェイと 172.20.10.x アドレスパターンで検出します。Instant Hotspotはルーティングが機能している間でもAirPortアソシエーションがないと報告することがよくあります。
  • キープアライブ後も接続が切断される場合は、既知のSSIDへの再接続試行を追加し、次に信頼性の高いトランスポートとしてUSBテザリングを検討します。
  • ユーザーがバッテリー駆動で長時間の稼働を望む場合は、強制的なスリープ禁止動作を適用する前に確認を取ります。
  • 企業のウイルス対策ソフト/EDRが存在する場合は、特にスクリプトをプレーンに保ちます。エンコードされたコマンド、ダウンロードされた依存関係、隠しスケジュールタスク、特権昇格は使用しないでください。

バンドルリソース

  • scripts/macos-livehotspot.sh: 一般的なmacOSクライアント側のキープアライブ/再接続ループ。ライブiPhoneホットスポット修正から適用。
  • references/macos.md: LaunchAgentのインストール/検証/アンインストールパターン。
  • references/windows.md: Windowsラップトップ向けのPowerShellおよびタスクスケジューラパターン。
  • references/linux.md: Linuxラップトップ向けのNetworkManagerおよびユーザーsystemdパターン。
  • references/research.md: 公開GitHub/Webリサーチからのメモ、および盲目的に再利用すべきでないもの。
  • assets/agent-prompt.zh.md: 汎用ローカルエージェント向けの中国語コピーペーストプロンプト。安全ルール、OSルーティング、検証、ロールバック要件を含む。

関連スキル