compozy

CompozyOS

この本文は、該当するリファレンスへ誘導します。ツールとスキルが有効な場合、起動時に読み込まれるのはこのルーターであり、リファレンスのマニュアル全文ではありません。ツールが有効でスキルが無効な場合、ネイティブなスキル読み込みが利用できないため、対応するセッションではツールのマニュアル全文 2 件がインラインに保持されます。デーモンが所有するタイトル生成では、その役割が与えられた入力を受け取って出力を返すため、ツールルーターは省略されます。それ以外のツール有効セッションでは、適切なガイダンスが保持されます。

管理対象セッションでリファレンスを読むには、アクティブなハーネスを通じて compozy__skill_view を解決し、返されたツール参照に {"name":"compozy","file":"references/<file>.md"} を指定して、以下の正確なパスを使って呼び出します。これらのリファレンスを読み込むために必要なツールの検出、ディスクリプターの読み取り、スキルの読み取り、保持された結果の読み取りは、読み取り前提条件の例外として扱われます。他のツールを呼び出す前に、最新のディスクリプターを確認してください。compozy__tool_search で機能を検出します。既存のツール認可を維持してください。ガイダンスがないからといってアクセス権が付与または剥奪されることはなく、スキルの読み取りが拒否された場合も、CLI やファイルシステムへのアクセスでポリシーを回避する許可にはなりません。

リファレンスの結果が切り詰められていてアーティファクトが含まれている場合は、アクティブなハーネスを通じて compozy__tool_artifact_read を解決します。返されたアーティファクト URI を変更せず artifact_uri として渡し、offset: 0 から開始して、eof になるまで各 next_offset の位置から続けて読み取ります。data_base64 の各ページをデコードして連結し、完全な構造化 content を含む保持結果のエンベロープを読み取ります。表示テキストに含まれる伏字はそのまま維持してください。現在のワークスペーススコープを使用します。プレビューだけでは、リファレンス全体を読んだことにはなりません。使用可能なアーティファクトが結果に含まれていない場合、または続きの読み取りが拒否された場合は、そのリファレンスを利用不可として報告してください。CLI やファイルシステムへのアクセスで回避してはいけません。

必須リーディングルーター

タスクに該当する行を選びます。エラー処理に記載された、対象を限定したディスクリプターの代替手段が適用される場合を除き、出力を作成する前に、記載されたファイルをすべて完全に読んでください。これらは付録ではありません。このファイル内のインラインの注意事項は、見落とし防止のためのものです。

タスク	必ず読む
隔離されたブランチでコード変更を委任する、サブエージェントの Git／PR の事実を確認する、または作業成果を受け取る	references/native-tools.md; references/worktrees.md
CompozyOS のセッションとデーモンの状態を開始、確認、プロンプト送信、停止、再開、圧縮、またはデバッグする	references/runtime-operations.md
デスクトップアプリを開く、確認、再試行、診断、または復旧する。ホストのランタイムとアプリを更新する	references/desktop.md
デーモンが管理するバックグラウンドロール、ロール診断、組み込み ID、またはロールのフォールバックルーティングを確認または設定する	references/runtime-operations.md + references/agent-definitions.md
プロバイダーモデル、ランタイム戦略、ACP オプション、推論、Fast、または料金を確認、更新、選定、または設定する	references/runtime-operations.md + references/native-tools.md
プロバイダーの利用状況（サブスクリプションの上限、リセット、クレジット、残高）を確認または更新する、あるいはその収集と同意を設定する	references/runtime-operations.md + references/native-tools.md
プロバイダー認証を設定する、またはプロバイダー認証ログインを実行する	references/agent-definitions.md + references/native-tools.md
compozy mcp serve を使って、1 つの CompozyOS ワークスペースを外部 MCP クライアントに公開する	references/runtime-operations.md
ネイティブツール、CLI、HTTP、または UDS を通じて仮想デスクトップ、管理対象ウィンドウ、またはワークスペースのレイアウトを確認、変更、または監視する	references/window-management.md + references/native-tools.md
CompozyOS のターミナルを開く、確認、接続、実行、または操作する。ターミナル入力に回答する、またはターミナルコマンドを監査する	references/terminal.md + references/native-tools.md
CompozyOS エージェント定義、プロバイダーのデフォルト、権限、または MCP サイドカーを作成またはレビューする	references/agent-definitions.md + references/tools-and-skills.md
CompozyOS ネイティブツールを検出または呼び出す、ネイティブツール ID を確認する、スキルを表示する、またはツールと CLI のどちらを使うか選択する	references/tools-and-skills.md + references/native-tools.md
コマンドパレットのコマンドを一覧表示、確認、または実行する。保留中のパレット承認を確認またはキャンセルする	references/native-tools.md
コーディネーター、タスクワーカー、またはタスクレビュアーとして作業する。タスクをブロックまたは復旧する、あるいはタスク作成者を起動する	references/tasks-and-orchestration.md
別のエージェント、プロバイダー、またはモデル上のサブエージェントにタスクを委任する。サブエージェントを確認、一覧表示、またはキャンセルする	references/native-tools.md + references/tasks-and-orchestration.md
CompozyOS Loop または Goal を作成、設定、実行、監視、承認、または停止する。/goal を使う。Loop のターミナル結果またはイベントを確認する	references/loops.md + references/native-tools.md
拡張機能をインストール、有効化、更新、開発用リンク、ビルド、公開、または削除する。拡張機能キット、シークレット、またはフックを管理する	references/extensions.md + references/native-tools.md
拡張機能のコード（マニフェスト、権限、提供サーフェス、追加コマンド、またはコマンドパレット項目）を作成またはひな形化する	references/extension-authoring.md + references/extensions.md
Automation（ジョブとトリガー）を作成または管理する、最終実行を確認する、または提案をレビューする	references/native-tools.md + references/configuration.md
ワークスペースのワークツリーを作成、確認、セッションにバインド、終了、公開、削除、または復旧する	references/worktrees.md + references/native-tools.md
Gateway の状態、ティアサーフェス、デバイスのペアリング、接続プロファイル、SSH フォワード、またはストリームチケットを確認または管理する	references/runtime-operations.md + references/configuration.md
プロファイルのライフサイクル操作を一覧表示、選択、作成、更新、名前変更、アーカイブ、アーカイブ解除、削除、または再試行する	references/profiles.md + references/native-tools.md
TypeScript または Go クライアントで外部アプリを構築する、またはアプリトークンを作成、監査、更新、取り消す	references/app-sdk.md
CompozyOS の設定（config.toml のキー、デフォルト、スコープ、設定適用のライフサイクル）を確認または変更する	references/configuration.md

参考インデックス

• references/runtime-operations.md - デーモン、セッション、ゲートウェイのプロファイル／SSH、バックグラウンドのロール、運用、ライフサイクル診断、ランタイムのトラブルシューティング。
• references/desktop.md - デスクトップアプリのコマンド、添付と所有権、ランタイムとアプリの更新、診断、復旧。
• references/window-management.md - デーモンを権威とするデスクトップ、ウィンドウ、レイアウト、リビジョン、クライアント、リソース、フック、復旧、公開サーフェス。
• references/terminal.md - 意図的なターミナルの有効化、ネイティブのツール ID、承認と共有入力、入力リクエスト、信頼できない出力、ジャーナル、プロファイル、プラットフォームのルール。
• references/agent-definitions.md - AGENT.md の構造、予約済みの組み込みロール ID、プロバイダーのデフォルト、権限、カテゴリーパス、MCP サイドカー、安全なセットアップワークフロー。
• references/tools-and-skills.md - CompozyOS ネイティブのツール検出、スキルの表示／検索、バンドルされたリソース、マーケットプレイスと MCP のインストールフロー、管理サーフェスの例外。
• references/native-tools.md - デーモンネイティブのツールセット、安定した CompozyOS ツール ID、記述子を確認するタイミング、CompozyOS 内で実行されるエージェント向け CLI フォールバック。
• references/tasks-and-orchestration.md - コーディネーター、ワーカー、レビュー担当者のループ、サブエージェントと起動されたワーカーの違い、タスクの権限境界、型付きブロックとブロック解除ループのブレーカー、wake-creator、完了の主張、レビュー判定ルール、機密データの制限。
• references/loops.md - Loop と Goal の作成／運用、/goal コマンド、ネイティブツール、ターミナルとコンテキストの状態、承認／復旧のセマンティクス、参照文法、フック、監視の動作。
• references/extensions.md - 拡張キット、インストール時の信頼、作成と開発のループ、インスタンスのスコープ、開発オーバーレイ、ログ、フック管理。
• references/extension-authoring.md - コードベースおよびリソースのみの拡張機能の作成：テンプレート、SDK 宣言、静的マニフェスト、権限、提供サーフェス、追加コマンド、コマンドパレット項目、構造化ワークフロー。
• references/app-sdk.md - 外部の TypeScript および Go アプリ、デーモン検出、プロンプト／イベントストリーム、ローカルのアプリトークン管理、ブラウザーのオリジン境界、ランタイム OpenAPI。
• references/configuration.md - 階層化された config.toml の望ましい状態、プロファイル資格情報、設定の適用ライフサイクル、ゲートウェイ、スケジューラー、Loop、Goal、自動化、セッション再構築、ロール、ウィンドウマネージャーの設定に関する主要リファレンス。
• references/worktrees.md - ワークスペースのワークツリーのライフサイクル、セッションのバインド、終了プランとアクション、フォージ連携、クリーンアップの証跡、公開管理サーフェス。
• references/profiles.md - オペレータープロファイルの選択、不変のセッションバインド、ライフサイクルプラン、ローカルのみの変更、エラー、イベント、公開管理サーフェス。

運用ループ

1. 操作を行う前に、ルーターが選択したすべてのリファレンスを読むか、以下の限定的な記述子フォールバックの条件を満たしてください。
2. CompozyOS の管理では、文章、ログ、直接的な内部アクセスよりも、CompozyOS ネイティブのツールと構造化出力を優先してください。
3. 権限はデーモンに委ねてください。タスク状態、レビュー判定、セッションのライフサイクル、拡張機能のライフサイクル、フック、ツール呼び出しには、CompozyOS の公開サーフェスを使用する必要があります。SQLite データベース、プロセス内部、生成されたプロジェクションを直接編集しないでください。
4. 変更後は、成功を前提とせず、構造化された読み取りで結果を確認してください。

エラー処理

必須のリソース読み取りに失敗した場合は、正確なルーターパスを指定して compozy__skill_view を一度再試行してください。再試行の前に tool_not_found または tool_invalid_input を修正してください。tool_backend_failed の場合は、リクエストを変更せずに一度再試行してください。2回目も失敗した場合は、1回のネイティブ呼び出しのライブ記述子で、要求された操作、リスク、および結果の処理方法が完全に定義されている場合に限り、続行してください。terminal_exec が表示されている場合は、1コマンドのターミナル実演であれば条件を満たします。複数ステップのターミナル操作には、引き続き references/terminal.md が必要です。それ以外の場合は、該当する操作を中止し、正確なパスを報告してください。構造化されたランタイムエラーを保持し、references/runtime-operations.md の診断順序に従い、デーモンが所有する状態を正としてください。

運用上のツール呼び出しやツール／スキルの変更を行う前に、references/tools-and-skills.md と references/native-tools.md を最後まで読んでください。 ガイダンスを読み込むための探索、記述子の確認、リファレンスの読み取り、およびそれらの保持された結果の続きの処理は、先に実行できます。このファイルのカタログはルーターとしてのみ使用してください。

停止してください。コーディネーター、ワーカー、またはレビュアーとして行動する前に、references/tasks-and-orchestration.md を最後まで読んでください。 タスクの権限とレビュー判定は、プロンプト上の慣例ではなく、ランタイムの契約です。