HagiTask の使い方

対象読者： HagiCode をインストール済みで、タスクの管理や実行を行う方。

前提条件： HagiTask のインストールを完了しているか、アプリに組み込みプリセットが用意されていること。

タスクを探す

アプリの HagiTask／コミュニティタスク管理画面を開きます。アプリには組み込みタスク、インストール済みのコミュニティパッケージ、ワークスペースのパッケージ、管理対象のソースがまとめて表示され、各タスクの提供元と削除できるかどうかが示されます。コミュニティ Gallery の一覧はコミュニティパッケージを探して取得するために使用します。サーバーから参照可能なディレクトリは、ランタイムがソースを検出するために使用します。

タスクをインストールする

Gallery でタスクを選んでインストールするか、取得済みの対応 ZIP をローカルアーカイブからインストールします。成功すると、アプリは正規 ID、バージョン、公開者、提供元、アーカイブのダイジェスト、インストール先ディレクトリを記録します。同じ ID のインストール済みタスクが黙って上書きされることはありません。既存のインストールに先に対処してください。

有効化と無効化

有効化： インストール済みタスクをアクティブなタスク一覧に加え、検出と実行ができるようにします。
無効化： インストール記録とパッケージのファイルを残したまま、アクティブな一覧から外します。タスクは実行されなくなります。
アンインストール： インストール記録のあるコミュニティタスクにのみ適用できます。組み込みタスクは情報として表示されるだけで、アンインストールできません。

状態の変更後、アプリは一覧を更新します。更新に失敗した場合、ライフサイクル操作によって中途半端な一覧が残るのではなく、従来の利用可能な状態が維持されるべきです。

更新と実行

更新操作で現在のタスク一覧を再読み込みします。Gallery の一覧を強制更新すると、アプリは一覧を再取得して検証します。上流で一時的な障害が発生した場合も、既存の有効なキャッシュを引き続き利用できる場合があります。更新によってタスクの有効化状態やバージョンが自動的に変わることはありません。

実行前にタスクが有効で、依存関係が満たされていることを確認し、タスクパネルまたは対応する実行入口から実行します。タスクが表示されない場合は、まず一覧を更新し、インストール状態、タスク ID、互換性に関する表示を確認してください。Schema やパッケージのリソースが無効な場合は、コミュニティ貢献ガイドを参照してください。

パッケージ管理とサーバーのソース管理

この二つの操作は混同されがちです。

機能	役割	パスの意味
パッケージ管理	ローカルの HagiTask パッケージをインストール、有効化、無効化、アンインストールします。	アプリが管理するデータディレクトリ。
サーバーのソース管理	ランタイムが一覧から検出するタスクのソースを設定します。	サーバーから参照可能なディレクトリである必要があります。

サーバーのソースに指定したパスは、バックエンドがディレクトリ内のタスクパッケージを検出するために読み取ります。ブラウザのパスでもアップロード用の入力欄でもありません。現在のインストール手順では、ブラウザ上のローカルフォルダーを Community Gallery のパッケージとして直接アップロードしません。パッケージをインストールする場合は、Gallery または対応するローカル ZIP の手順を使ってください。

タスクを利用できない場合

タスク ID、バージョン、インストール記録がまだ存在することを確認します。
タスクが有効で、必要な agent、skills、CLI が準備できていることを確認します。
タスク一覧を更新し、管理画面を開き直します。
ソースがサーバーのディレクトリである場合、バックエンドプロセスにそのパスの読み取り権限があることを確認します。
アーカイブの検証またはパッケージのリソースに問題がある場合は、インストールのトラブルシューティングに戻ってください。パッケージのメンテナーはコミュニティへの貢献を参照してください。

次のステップ： コミュニティへの貢献、またはHagiTask の紹介に戻る。