パック

再利用するワークフロー / コンテキストの成果物は epismo pack で操作します。

コンテキスト・パックの作成

epismo pack create --type context --title "Team onboarding" --personal \
  --blocks '[{"title":"Where things live","content":"Docs in Notion, code in GitHub, designs in Figma."}]'

ワークフロー・パックの作成

epismo pack create --type workflow --title "Release review" --projects $PROJECT_ID \
  --steps '[{"title":"Summarize changes","content":"List merged PRs."}]'

ワークフローステップの dueDate は、これから実行するワークフローの開始からの相対日数です。実行開始から7日後なら "7" を使います。YYYY-MM-DD ではありません。

パックの検索

epismo pack search --type workflow --query "release review"
epismo pack search --type context --query "オンボーディング" --search-mode semantic

--search-mode はランキング方式を選びます: keyword（既定）または semantic（キーワード一致にベクトル類似を加味）。省略するとキーワード検索になります。

パックの読み取り

epismo pack get $PACK_ID
epismo pack get $PACK_ID --full
epismo pack get @repo-map --block-id b001,b002
epismo pack get @handle/repo-map

デフォルトの読み取りはアウトラインのデータを返します。--full はネストした内容がすべて必要な場合だけ使います。

エージェントに渡すコンテキストを小さく保つため、まずアウトラインを読み、必要なネストした内容だけを取得してください。 epismo pack get はアウトライン、指定ブロック / ステップ、全文モードのいずれでも同じ 1 credit です。

パックの評価

epismo pack rate は、実際に使ったパックがうまくいったかどうかを評価として記録します。

epismo pack rate @release-review success
epismo pack rate $PACK_ID failure

実行結果はアカウントとパックの組につき 1 件で、コマンドを再実行すると前回の結果を更新します（最新優先）。評価された結果はハブの成功/失敗数とトレンドのランキングに反映されます。

ワークフロー・パックの実行

epismo pack run はワークフロー・パックをトラックへ展開します。ルート・ゴール 1 件と、ステップごとの todo タスクを 1 回の呼び出しで作成します。

epismo pack run @release-review \
  --title "Ship CSV export" \
  --projects $PROJECT_ID \
  --start-date 2026-07-01 \
  --assignee human=$USER_ID \
  --context @repo-conventions

• ゴールは今回の実行の目的であり、後から実行全体を取得するためのアンカーです。--title / --content で設定し、省略時はパックのタイトルと内容が使われます。
• ステップの相対期日（"7" = 7 日後）は --start-date（省略時は今日）を起点とした絶対日付に変換されます。
• ステップの dependsOn / parentId は作成されたトラックの UUID に解決されます。すべてのタスクは goalId でゴールに紐づきます。
• --assignee token=id はパック側の担当トークンをトラックの担当者にマッピングします。human はユーザー ID へマッピングしてください（エージェント ID はそのまま解決されます）。未マッピングの human ステップは担当なしで作成され、warnings に報告されます。
• --context はコンテキスト・パックを context: ソースとしてゴールに記録します（コピーではなく参照）。作成されるすべてのトラックには workflow:<pack-id> ソースが刻まれます。

レスポンスには goal.id、各タスクの ID と対応する stepId、stepMap が含まれます。実行全体は後から次のコマンドで取得できます。

epismo track search --type task --filter '{"goalId":["<goal-id>"]}'

ネストした内容の更新

epismo pack update @repo-map --blocks '[{"op":"add","title":"Local setup","content":"npm install"}]'
epismo pack update @repo-map --blocks '[{"op":"update","id":"b001","content":"Updated text"}]'
epismo pack update @repo-map --blocks '[{"op":"remove","id":"b002"}]'

--blocks または --steps を省略するとネストした内容は変更されません。[] は何もしません。すべて削除するには、各項目 ID に対して remove 操作を送ります。

エイリアス

epismo alias upsert @repo-map --reference $PACK_REFERENCE
epismo alias get @repo-map
epismo alias list --type context