Skip to Content
Skip to Content
スキル管理

スキル管理

組織でアクセスできるスキルを探し、ライブラリのスキルを複製したり、ローカルファイルを登録したりできます。組織共有スキルの管理とGitHub連携には、AI担当者の権限が必要です。

スキルを探す

aipctl skill list aipctl skill list --search "レポート" aipctl skill get SKILL_ID

一覧でIDを確認し、getで詳細を取得します。詳細に表示されるファイルは最大10件のため、スキルに含まれるすべてのファイルが表示されるとは限りません。

ライブラリから複製する

aipctl skill library --search "レポート" aipctl skill clone SKILL_ID

ライブラリで選んだスキルを、現在の組織に複製します。1回に最大5件のIDを指定できます。複数件を複製した場合は、各項目の成否と新しいIDを確認してください。

ビルトインスキルの一覧取得と複製には、AI担当者の権限が必要です。

aipctl skill built-in --search "レポート" aipctl skill clone-built-in BUILT_IN_SKILL_ID

ローカルファイルを登録する

aipctl skill upload ./report-skill.zip aipctl skill list --search "report"

.zipまたは.skillファイルに対応しています。アップロード後、返されたIDで詳細を確認してください。通常のスキルコマンドと組織共有スキルの管理コマンドでは、登録・アクセスの範囲が異なります。目的に合ったコマンドを選択してください。

同じ名前のスキルがある場合、登録は拒否されます。既存の内容を置き換える場合に限り、次のコマンドを実行してください。

aipctl skill upload ./report-skill.zip --overwrite

ファイルをダウンロードする

ダウンロードが許可された組織のスキルIDを使用してください。一覧に表示されるスキルでも、すべてをダウンロードできるとは限りません。

aipctl skill download SKILL_ID -o ./downloads/report-skill.zip

CLIでのダウンロードには、最大128 MiB・10分の制限があります。制限を超えた場合は、保存できたと判断せず、エラーを確認してウェブからダウンロードしてください。

保存先に同名のファイルがあると上書きされます。-oを省略すると、現在のディレクトリに元のファイル名で保存されます。先に同名のファイルがないか確認してください。

組織共有スキルを管理する

AI担当者は、admin skillで組織共有スキルを確認・登録し、ライブラリへの公開状態を変更できます。

aipctl admin skill list --search "レポート" aipctl admin skill get SKILL_ID aipctl admin skill upload ./report-skill.zip aipctl admin skill download SKILL_ID -o ./downloads/report-skill.zip aipctl admin skill publish SKILL_ID aipctl admin skill unpublish SKILL_ID

publishはライブラリに公開し、unpublishは公開を解除します。変更後は詳細で状態を確認してください。

組織管理コマンドでも、ビルトインスキルの一覧取得と複製ができます。

aipctl admin skill built-in --search "レポート" aipctl admin skill clone-built-in BUILT_IN_SKILL_ID aipctl admin skill list

skill built-in・skill clone-built-inと同様に、AI担当者の権限が必要です。複製時は1回に最大5件のIDを指定できます。各項目の成否と新しいスキルIDを確認してください。

GitHubから取り込む

AI担当者は、リポジトリまたはスキルフォルダーのURLから組織のスキルを取り込めます。GITHUB_URLを実際のURLに置き換えてください。

aipctl admin skill github inspect GITHUB_URL aipctl admin skill github import GITHUB_URL aipctl admin skill list

先にinspectでリポジトリ情報を確認し、importを実行します。同じ名前のスキルを置き換える場合に限り、importに--overwriteを追加してください。

取り込み後は、GitHubの変更を確認して反映できます。

aipctl admin skill github sync SKILL_ID aipctl admin skill github sync SKILL_ID --apply

最初のコマンドは変更内容の確認だけを行います。更新を反映するには--applyが必要です。 反映後、getでスキルを確認してください。

非公開リポジトリでPATが必要な場合は、トークンを格納した環境変数の名前を指定します。

aipctl admin skill github inspect GITHUB_URL --pat-env GITHUB_PAT aipctl admin skill github import GITHUB_URL --pat-env GITHUB_PAT

先にシェルでGITHUB_PAT環境変数を設定してください。--pat-envにはトークン自体ではなく、変数名を入力します。トークンを含むコマンド・画面・ログは共有しないでください。

GitHub認証情報を変更・削除する

非公開リポジトリから取り込んだスキルを継続して同期する場合は、そのスキル用のPATを保存できます。この操作にもAI担当者の権限が必要です。

aipctl admin skill github credentials set SKILL_ID --pat-env GITHUB_PAT aipctl admin skill get SKILL_ID --json aipctl admin skill github sync SKILL_ID

SKILL_IDには、GitHubから取り込んだ組織のスキルIDを指定します。GITHUB_PATには、実際にリポジトリを読み取れるトークンを設定してください。setは、そのスキルに保存された認証情報を変更します。getのGitHub情報でPATの設定有無を確認し、syncで変更内容を取得できるか確認します。取得結果にトークン自体は表示されません。

保存したPATを使わなくなった場合は削除します。

aipctl admin skill github credentials clear SKILL_ID aipctl admin skill get SKILL_ID --json

clearは、そのスキルに保存されたPATだけを削除し、スキル自体は削除しません。GitHub側でのトークンの失効は別途行ってください。認証情報を削除した後、非公開リポジトリを同期するには、有効なPATを再度保存する必要がある場合があります。

スキルを削除する

詳細で対象を確認してから削除します。組織共有スキルには、admin skill deleteを使用してください。

aipctl skill get SKILL_ID aipctl skill delete SKILL_ID --force

組織共有スキルを削除する場合は、次のコマンドを使用します。

aipctl admin skill get SKILL_ID aipctl admin skill delete SKILL_ID --force aipctl admin skill list

--forceは削除を実行するという明示的な確認です。他の処理で使用しているスキルでないか確認してから実行してください。コマンドが中断して結果が不明な場合は、一覧を再取得してから再実行を判断します。

Last updated on