using-islo

Islo の使用方法

ユーザーが Islo 上で開発する際は、このスキルを使用してください。

Islo は、エージェント向けのセキュアなクラウドサンドボックス、複数段階の自動化を実現する Factory ライン、ゲートウェイ管理のプロバイダー認証情報、生成済み SDK を提供します。ジョブと Webhook は、Factory ラインを構成する低レベルの構成要素です。Claude Code、Cursor agent、Codex はサンドボックスにプリインストールされており、サンドボックスの使用前にインテグレーションを接続していれば、サンドボックス内で認証しなくても実行できます。islo login --tool でインテグレーションを接続してください。ほとんどの作業では、default ゲートウェイプロファイルが認証情報の注入を処理します。記憶に頼るのではなく、情報を取得してください。Islo は頻繁に変更されます。

最初に確認すること

1. 利用可能な場合は、ドキュメント MCP サーバーから Islo のドキュメントを検索してください：https://docs.islo.dev/_mcp/server。
2. islo CLI がインストールされている場合は、正確なフラグを確認するため CLI のディスカバリーを使用してください：
   • islo schema
   • islo schema <command>
   • ISLO_HELP=full islo
3. マニフェストを作成または編集する前に、必ず最初にスキャフォールドを生成してください：
   • Factory：islo schema factory を実行し、その後 islo factory line deploy line.toml --dry-run を実行
   • Factory インテグレーショントリガー：islo factory triggers list --with-status
   • ジョブ：islo job init <name> → 編集 → islo schema job → islo job deploy <name> --dry-run
   • Webhook：islo schema webhook
   • サンドボックス設定：islo schema use
   • ナレッジ：islo schema knowledge
   • マニフェストのフィールド形式を記憶から書かないでください。インストール済みの CLI が信頼できる情報源です
   • スキル内の例はパターンとして扱い、そのまま使えるマニフェストとして扱わないでください
4. 試す前に、サンドボックス内への Claude Code、Cursor agent、Codex のインストールや認証をユーザーに求めないでください。これらはプリインストールされており、接続済みのインテグレーションが認証を提供します。
5. ユーザーがその回避策を明示的に選択しない限り、サンドボックス内に GitHub、Slack、モデルプロバイダーなどのプロバイダートークンを設定するよう伝えないでください。接続済みのプロバイダーと default ゲートウェイプロファイルを優先してください。
6. 再利用可能なサンドボックス変数とシークレットには islo environment を使用し、環境をサンドボックスやジョブに適用する方法を islo schema use で確認してください。

用途に応じた選択

ユーザーの目的	まず確認するもの
自動化（デフォルト）	Factory ライン — factory.md
対話型サンドボックスまたはアドホックなエージェント作業	islo use — sandbox-lifecycle.md
ハーネス、モデル、推論のルーティング	agents-and-inference.md
HTTP イベントからサンドボックスへ（ラインオーケストレーションなし）	着信 Webhook — webhooks.md
エージェントの各ステップで再利用するポリシー、スキル、ルール	islo knowledge — knowledge.md
サンドボックス内にトークンを置かずにプロバイダー認証情報を使用	gateway-integrations.md
コード内での製品インテグレーション	SDK — sdk.md
実行可能な出発点	factory.md — islo-labs/islo-agents
単独の単一段階ジョブ（上級者向け）	Job — jobs.md

デフォルトの推奨事項： 自動化には Factory ラインを使用してください。ジョブはライン内の段階を構成する要素です。ラインオーケストレーションなしで単一段階の永続実行またはスケジュール実行を明示的に希望する場合を除き、ユーザーが job.toml を直接作成することはほとんどありません。

適切なリファレンスを選ぶ

• Factory ライン、ステージ、遷移、トリガー、ライン実行、判断待ちの一時停止： factory.md を参照してください。
• ハーネス、モデル、Islo 推論の選択（Factory での Islo 推論を含む）： agents-and-inference.md を参照してください。
• 単独のジョブ（上級者向け）： ラインオーケストレーションなしの単一段階ジョブをユーザーが明示的に希望する場合に限り、jobs.md を参照してください。
• 低レベルの着信／発信 Webhook： webhooks.md を参照してください。
• ナレッジ項目（メモリー、スキル、ルール）： knowledge.md を参照してください。
• サンドボックスの作成／接続／実行／一時停止／再開／停止／削除のフロー： sandbox-lifecycle.md を参照してください。
• ゲートウェイプロファイル、プロバイダーインテグレーション、ファントムトークン、GitHub、Slack、サンドボックス内にトークンを置かないパターン： gateway-integrations.md を参照してください。
• CLI を呼び出す代わりに、生成済み SDK を使ったプログラムでの利用： sdk.md を参照してください。
• 実行可能な自動化の例（PR レビューなど）： factory.md を参照してください。

運用ルール

• Factory ラインを主要な自動化製品として扱ってください。複数のステージ、ループ、判断、スケジュール、Webhook、または統合トリガーにまたがる作業では、ラインを優先してください。
• Factory ライン内のステージを構成するブロックとして、ジョブを使用してください。ラインによるオーケストレーションを使わず、単一ステージの永続的な処理またはスケジュールされた処理を明示的に希望している場合に限り、単独の job.toml を提案してください。詳しくは jobs.md を参照してください。
• HTTP イベントの受信・送信にはウェブフックを使用してください。Factory ラインは、ウェブフックまたは統合イベントによってトリガーすることもできます。
• 対話型またはアドホックなサンドボックス作業には、islo use を優先してください。これにより、サンドボックスを作成または再接続した後、シェルを開くかコマンドを実行します。
• 再利用可能なサンドボックス環境変数や、環境が所有するゲートウェイ注入シークレットを使用するには、islo environment で名前付き環境を管理し、サンドボックスの作成時に適用するために islo use --environment <name> を使用してください。
• サンドボックスでのエージェント作業には、islo use --agent claude、islo use --agent cursor、または islo use --agent codex を優先してください。バックグラウンドプロンプトには --task を使用してください。
• Factory ステージジョブでのエージェント作業には、islo schema job に従い、入れ子になったプロンプトバインディングを持つ run_agent ステップを優先してください。islo schema job にそれを必要とする exec モードのパスが示されていない限り、claude、agent、または codex の CLI エントリーポイントをシェルでラップしないでください。
• 実行開始後の Factory ラインの実行制御には、islo factory line-run（status、events、stop、steer、retry、follow-up、agent-turn）を使用してください。stop はラインを終端キャンセルするのではなく、一時停止状態にします。一時停止中または完了済みの実行のみを steer し、最後に失敗したステージには retry を使用してください。
• 高度な判断を要する自動化では、ジョブのステージ内またはサンドボックス内でエージェントを実行してください。手書きのシェルによるビジネスロジックでエージェントを置き換えないでください。
• ハーネスコード（サーバー、CLI、シナリオアセット）は、ステージジョブから参照されるサンドボックススナップショットに配置してください。job.toml 内で base64 や heredoc を使ったブートストラップを行わないでください。jobs.md と factory.md を参照してください。
• 内部ツール、ダッシュボード、カスタムランチャーには、SDK を優先してください。