ツール

パックツール

大きいパックはまずアウトラインデータを読み、その後に必要な stepIds または blockIds だけを取得します。

{
	"reference": "@repo-onboarding"
}

アウトラインのレスポンスには contentIndex.stepIds または contentIndex.blockIds が含まれます。その ID を使って必要な部分を取得します。

{
	"reference": "@repo-onboarding",
	"blockIds": ["b001", "b003"]
}

full=true はクライアントがすべてのブロック/ステップを本当に必要とするときだけ使います。

エージェントに大きなパック全体を渡す前に、アウトラインで必要な内容を絞り込んでください。

パック作成の例

{
	"type": "context",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"title": "Team onboarding",
	"blocks": [
		{
			"title": "Where things live",
			"content": "Docs in Notion, code in GitHub, designs in Figma."
		}
	]
}

ワークフロー・パックでは blocks ではなく steps を渡します。ワークフローステップ担当者は human またはエージェント ID のみです。

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

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

epismo_pack_run はワークフロー・パックを 1 回の呼び出しでトラックへ展開します。ルート・ゴール（今回の実行の目的であり、後から実行全体を取得するためのアンカー）と、ステップごとの todo タスクを作成します。ステップの dependsOn / parentId はトラックの UUID に解決され、相対期日は startDate（省略時は今日）を起点とした絶対日付に変換され、作成されるすべてのトラックには workflow:<pack-id> ソースが刻まれます。

{
	"reference": "@release-review",
	"title": "Ship CSV export",
	"startDate": "2026-07-01",
	"assignees": ["human=<user-id>"],
	"context": ["@repo-conventions"],
	"scope": { "type": "projects", "ids": ["project-id"] }
}

title / content は省略するとパックのタイトルと内容が使われます。assignees は token=id 形式でパック側の担当トークンをマッピングします。human はユーザー ID へマッピングしてください（エージェント ID はそのまま解決されます）。未マッピングの human ステップは担当なしで作成され、warnings に報告されます。context はコンテキスト・パックを context: ソースとしてゴールに記録します。

レスポンスには goal.id、各タスクの ID と対応する stepId、stepMap が含まれます。実行全体は後から epismo_track_search を goalId で絞り込んで取得できます。

トラックツール

エージェントが複数の関連タスクを作る場合は epismo_track_apply が向いています。

{
	"scope": { "type": "projects", "ids": ["project-id"] },
	"upserts": [
		{
			"id": "t001",
			"title": "Review MCP docs",
			"task": { "status": "todo", "dueDate": "2026-06-05" }
		},
		{
			"id": "t002",
			"title": "Publish docs changes",
			"task": { "status": "todo", "dependsOn": ["t001"] }
		}
	]
}

t001 のような非 UUID ID は新規トラック作成として扱われます。同じ epismo_track_apply 呼び出し内では、そのラベルを parentId、dependsOn、goalId に使えます。サーバーが生成された UUID に解決します。

エージェントが探索のために検索を繰り返す場合は、検索語とフィルターを絞り、必要なレコードだけ詳細を取得してください。

タスクのステータスは backlog, todo, in_progress, done です。ゴールのステータスは not_started, on_track, at_risk, postponed, completed です。

epismo_track_review は、1件以上のタスクまたはゴールに対する読み取り専用のレビューを生成します。references と、任意で instruction を渡します。対象トラック、関連するタスク/ゴール、ログ、source pack を読み、stats と生成された Markdown content を返します。詳細レビューは、内部で使った AI token usage に基づいて credits を消費します。パックの作成・更新や改善案の作成は行わないため、結果を反映したい場合は pack / suggestion tools を明示的に呼び出してください。

ログツール

epismo_log_create は、タスクやゴールにコメント/活動ログを残します。対象トラックの UUID または URL を reference に渡します。エージェントが行った作業や発見は kind: "update"、判定やレビュー結果は kind: "review"、議論やメモは kind: "comment" を使い分けてください。metadata は任意の構造化 JSON(シリアライズ後 16KB が上限)で、リトライを安全にしたい場合は idempotencyKey を渡せます。ログの追記は無料なので、まとめて要約するのではなく、こまめに残すことを想定しています。

epismo_log_list は既定で新しい順にログを返します。reference(トラックの UUID または URL)を渡すと1トラックに絞り込み、省略すると今アクセスできる全トラックを横断するアクティビティフィードになります — どちらの場合も authorId でさらに絞り込めます。「最近何が起きたか」や、特定ユーザーが書いたものを見るのに使えます。次のページを取得するには、直前レスポンスの nextCursor を同じ order のまま cursor に渡してください。時系列で再生する場合や、既知のログ以降の新着だけを取得する場合は order: "asc" を使います。横断フィード(reference 省略時)は各ログを書いた時点での ACL スナップショットを反映しており、トラックの現在の ACL をその都度確認しているわけではありません — 書いた時点でアクセスがあったログは、そのアクセスが後で取り消されてもここに残り続けることがあります。reference を指定した読み取りは常にトラックの現在の ACL を反映するため、これとは異なります。呼び出し側から見えない著者(例: その後ワークスペースを離れたユーザー)は、生のアカウント id ではなく "unknown" として返されます。

epismo_log_delete はログ ID でログを 1 件削除します。著者は自分のログを削除でき、トラックの作成者はそのトラック上の任意のログを削除できます。削除済みログは以後の一覧結果から除外されます。

クレジットの挙動

各ツールのコストは上の表に記載しています。クレジットは OAuth トークンで解決される現在の個人用 / ワークスペースのコンテキストから消費されます。クレジットが不足している場合、ツール呼び出しはクレジットまたは支払いのエラーとして失敗することがあります。

エイリアスツール

エイリアスの入力はエイリアス名です。先頭の @ は受け付けられ、保存時に除去されます。@handle/name の形式は別アカウントのエイリアスを読み取るためのもので、作成・削除には使えません。

epismo_alias_upsert はパックの reference(pack ID、alias、共有 URL、ハブ URL)と作成する alias 名を受け取ります。epismo_alias_upsert と epismo_alias_delete は任意の namespace を受け取ります。personal(デフォルト)または workspace(アクティブなワークスペースの共有アカウント。メンバー全員が解決可能)です。エイリアスを作成・付け替え・削除できるのは対象パックの所有者だけです。epismo_alias_get は alias 参照(@alias、alias、または @handle/alias。曖昧な場合は任意の namespace で指定)を解決し、パックの id、type、namespace、そしてすぐ使える reference を返します。epismo_alias_list は各エントリについて同じフィールドを返します。

改善案ツール

改善案は、ワークフロー / コンテキスト・パックに対するテキスト中心の提案です。epismo_suggestion_create はパックの reference、title、content を受け取り、提出時点のパックのスナップショットを保存します。epismo_suggestion_list は owner: true(自分の受信箱)、reference(特定のパック)、どちらも指定しない(自分が送信した改善案)でビューを選び、statuses、page、includeSnapshots を受け付けます。各改善案の content は短縮プレビューで返るため、全文は epismo_suggestion_get で取得します。改善案を更新できるのは投稿者だけ、解決できるのはパックの所有者だけです(open, applied, declined, archived)。詳細は 改善案 を参照してください。