mcpField
L
luxonis-guide

luxonis-guide

github.com/luxonisエージェントワークフロー1938 回インストール8 週間前に更新
リポジトリ

luxonis-guide について

Luxonis Guideは、カメラのセットアップからPoC開発まで、状況に合う次のスキルへ案内するLuxonis向けルータースキルです。デバイスやプロジェクトのマーカー、報告された問題を基に分岐し、対象外の場合はドキュメントやサポートを案内します。

主な機能

  1. 01状況に応じて次のスキルを選択
  2. 02DEVICE.mdとPROJECT_BRIEF.mdを確認
  3. 03セットアップからPoC開発までを案内
  4. 04ソフトウェアのトラブルシューティング分岐
  5. 05対象外の場合は文書やサポートを案内

活用シーン

  1. 01新しいカメラのセットアップや接続確認
  2. 02動作するデバイスがあり企画書がない場合
  3. 03既存のプロジェクト概要からPoCを構築
  4. 04ソフトウェア・ハードウェア問題の対応先を判断

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/luxonis/skills --skill luxonis-guide

インストール後、Claude Code で/luxonis-guideを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

Luxonis ガイド

現在の状況に合った Luxonis スキルを1つ案内します。次に実行するコマンドを提示したら、そこで終了してください。この場でそのスキルの作業を行ってはいけません。

終了時の状態は、次のいずれか1つにしてください。

  • 案内済み -- 次に実行するコマンドを1つと、フローのどこに位置するかを示します。
  • 対象外 -- フェーズ1のスキルでは対応できない状況です。該当する不足点を示し、ドキュメントまたはサポートを案内します。

フロー

ほとんどの作業は、1つのメインフローに沿って進みます。もう1つ、別の経路があります。

メインフロー：アイデア -> 動作するデモ

  1. カメラを動作させる -> luxonis-device-setup
  2. アイデアをブリーフにまとめる -> luxonis-project-interview
  3. 小規模な PoC を構築する -> luxonis-build-poc

ステップ1と2は順不同です。インタビューはデバイスがなくても進められるため、ハードウェアの到着を待つ間に、先にアイデアを具体化できます。ステップ3が合流地点です。ここでは、ブリーフと検証済みのデバイスの両方が必要です。

別経路：問題がある、動作が遅い、または分かりにくい -> luxonis-troubleshoot。どの時点からでも分岐して、問題を解決したらメインフローに戻ります。

1. 状況を確認する

現在の作業ディレクトリにフローの目印があるか、事前に確認します。存在するかどうかだけを判定し、内容を詳しく解析しないでください。

!ls -1 2>/dev/null | grep -E '^(DEVICE|PROJECT_BRIEF)\.md$' || echo "no markers"

!cat PROJECT_BRIEF.md 2>/dev/null | head -3 || true

Claude Code など、シェルインジェクションに対応するエージェントでは、案内を開始する前に上記の行が実行結果で置き換えられます。対応していないエージェントでは、これらを無視してディレクトリの内容を一覧表示するか、PROJECT_BRIEF.md を自分で読み取ってください。

目印とユーザーの発言を組み合わせて判断します。

  • DEVICE.md がある -> この環境ではすでにデバイスが検証済みです。
  • PROJECT_BRIEF.md がある -> アイデアはすでにブリーフにまとめられています。

2. 案内する

状況を次のいずれかに当てはめます。

  • 新しいカメラを使う、または動作や接続に不安がある -> luxonis-device-setup。
  • 動作するカメラがある（または DEVICE.md がある）が、PROJECT_BRIEF.md はなく、何かを構築したい -> luxonis-project-interview。
  • PROJECT_BRIEF.md があり、実際に動かしたい -> luxonis-build-poc。
  • アプリ、パイプライン、またはデバイスの検出に問題がある、動作が遅い、または分かりにくい -> luxonis-troubleshoot。

状況が明確なら、すぐに案内します。曖昧な場合（依頼内容がない場合や、「OAK について助けて」のように漠然としている場合）は、確認の質問を1つだけしてから判断してください。

カメラはすでに接続され、正常に動作していますか？それとも、アイデアだけの状態から始めますか？

質問を2つ目に進めてはいけません。アイデアの具体化を始めてはいけません。それはこのルーターではなく、luxonis-project-interview の役割です。

デバイスの故障とソフトウェアの問題

「カメラが動かない」は、2つの状況に分かれます。ここで確認の質問を1つする意味があります。

  • ソフトウェアの問題 -- デバイス検出に失敗する、パイプラインでエラーが発生する、深度が不正、FPS が低い、出力が分かりにくい -> luxonis-troubleshoot。
  • デバイスの故障 -- オレンジ色の LED が点灯する、起動しない、キャリブレーションの不具合が疑われる -> ハードウェアの故障です。トラブルシューティングではなく、[email protected] に連絡して対象外とします。

3. 終了する

案内済み -- 次のコマンドと、フロー内での位置を1行で示します。

次に /luxonis-device-setup を実行してください。カメラを検証し、その後アイデアをまとめて構築します。

プラグインのインストール方法によっては、/luxonis:luxonis-device-setup のようにコマンドに名前空間が付く場合があります。

対象外 -- 無理に案内しないでください。対応できない内容を示し、適切な参照先を案内します。

  • ハードウェアの故障（オレンジ色の LED、起動失敗、キャリブレーション） -> [email protected]。
  • V2 -> V3 の移行 -> まだ対応するスキルはありません。以下のドキュメントを案内してください（今後スキルが追加される可能性があります）。
  • 4つのスキルの対象外となるその他の内容（OAK 以外のハードウェア、大規模な本番環境／フリートへのデプロイ） -> 内容を示し、https://docs.luxonis.com を案内してください。

ドキュメント

コメント

Markdown 対応