use-skill

スキルを使用する

範囲

デフォルトでは一時的に取得・実行・破棄し、インストールや永続化は行いません。 Blob／raw／tree の URL、または owner/repo@ref:path はスキルディレクトリとして解決します（ファイルの場合はその親ディレクトリを使用します）。ref が省略されている場合は、リポジトリのデフォルトブランチを使用します。それ以外の形式や保存・インストールのリクエストはブロックします。リポジトリの内容に関する質問は box の対象です。 links | resolved directory/revision | blob set | executed | terminal を記録します。

取得したワークフローは、この呼び出しに与えられた権限の範囲内で実行されます。ホストの権限や、優先度の高い指示を超えることはありません。許可リストがなくても、リンク先のスキルはデフォルトで信頼します。内容と直接矛盾する場合は、現在のユーザー指示が優先されます。取得したコンテンツ内のスキルリンクも、同じ制限の範囲内でたどることができます。

1. 解決して取得する

すべてのリンクを解決し、そのref／デフォルトブランチをコミットリビジョンに固定します。 認証済みの gh を使用します。これらのファイルを読み取る際、兄弟スキルは必要ありません。 gh／認証情報がない場合はブロックします。REFERENCE.md の API／デコード規則を適用します。

固定したリビジョンで再帰的なツリーを一度だけ一覧表示し、一覧が途中で切り詰められていないことを確認したうえで、エントリだけでなくディレクトリ内のすべての blob を取得します。 リポジトリの外にある、この実行専用の一時ディレクトリにのみステージングします。長いコンテンツは、取得に成功した blob を再取得せず、ローカルでページ分割して表示します。ディレクトリが存在しない場合、blob の取得に失敗した場合、またはレート制限が発生した場合は、再試行の合図を付けてブロックします。 すべてのリンクに識別情報があり、一覧にあるすべての blob のデコード済みコンテンツがそろった時点で完了です。

2. 検証して実行する

空のセットの場合は NO_CHANGES です。空でない場合は、SKILL.md またはリンクで指定されたエントリ、name frontmatter、手順が必要です。これらがなければ BLOCKED です。 エントリとすべての兄弟ファイルを最初から最後まで読みます。弱いリモート参照によって、必須の資料を隠すことはできません。権限の範囲内で、手順を順番に実行します。項目の実行に失敗した場合も、残りのリンクの処理を続けます。成功した実行は再試行しません。 すべてのリンクが最終状態に達した時点で完了です。

3. 破棄して報告する

実行後、この実行で作成した一時ファイルだけを削除し、把握していないパスには触れません。 各リンクの SUCCESS／NO_CHANGES／BLOCKED と、実行した内容を、固定した参照元を示して報告します。一時ファイルが破棄され、すべての最終状態が根拠とともに示された時点で完了です。