エイリアス

エイリアスはパックの参照を安定して読みやすくするためのものです。プロンプト、運用手順書、スクリプト、CI ジョブの中で、生のパック ID を直接扱うと読みにくくなる場合に使います。

エイリアスはパックだけを指します。トラックは UUID、または UUID を含む URL で参照します。

すべてのエイリアスは 個人用 名前空間(自分のアカウント、デフォルト)または ワークスペース 名前空間(アクティブなワークスペースの共有アカウント)に属します。名前空間の解決方法は エイリアス を参照してください。

エイリアスの作成・更新

epismo alias upsert @repo-onboarding --id $PACK_ID
epismo alias upsert @release-review --id $PACK_ID
epismo alias upsert @deploy --id $PACK_ID --namespace workspace

パックの type(workflow または context)はパック ID から導出されます。既存のエイリアス名を再利用すると、そのエイリアスは新しいパック ID を指すように更新されます。

--namespace は personal(デフォルト)または workspace です。workspace 形式はその名前をアクティブなワークスペースと共有します。エイリアスを付けられるのは自分が所有するパックだけで、書き込み前に所有権が検証されます。

エイリアスの名前は先頭の @ を取り除いて保存されます。CLI は repo-onboarding と @repo-onboarding のどちらも受け付けます。エイリアスの名前は正規化後に1〜255文字で、/ や制御文字は使えません。

エイリアスの解決

epismo alias get @repo-onboarding                 # personal 優先、次に workspace へ fallback
epismo alias get @deploy --namespace workspace    # workspace の alias を明示
epismo alias get @handle/repo-onboarding          # 別アカウントの alias

レスポンスには id、type、accountId、alias、namespace(該当する場合 personal | workspace)、そして reference(すぐ使える @alias)が含まれます。

エイリアスの一覧

epismo alias list
epismo alias list --type workflow

list は自分の個人用のエイリアスに加えて、ワークスペースがアクティブな場合はそのワークスペースの共有エイリアスも返します。各エントリには namespace が付与されます。--type は任意です。

エイリアスの削除

epismo alias delete @repo-onboarding              # personal
epismo alias delete @deploy --namespace workspace     # workspace の共有 alias

--namespace で名前空間を選びます(デフォルト personal)。ワークスペースエイリアスを削除できるのは対象パックの所有者だけなので、チームメイトの共有エイリアスを消すことはできません。エイリアスを削除してもパックは削除されません。パックを削除すると、そのパックを指す自分のエイリアスは削除されます。

よくある間違い

• @handle/alias は別アカウントのエイリアスを参照する読み取り専用の形式で、作成・削除には使えません。作成・削除は自分またはワークスペースのエイリアスに対して行い、どちらかは --namespace で選びます。
• トラックにエイリアスは使えません。
• prompt 内では生の UUID よりエイリアスを使う方が文脈が読みやすくなります。