mcpField
A
agent-wrapped

agent-wrapped

github.com/vkpdeveloperクリエイティブ・メディア06 回インストール4 日前に更新
リポジトリ

agent-wrapped について

Agent Wrappedは、ローカルのエージェント履歴を動画にまとめ、セッションや繰り返しの修正、利用傾向を振り返るツールです。分析と動画生成はローカルで行われ、データはアップロードされません。

主な機能

  1. 01対応エージェントのセッション集計
  2. 02繰り返される修正内容の分類
  3. 03まとめデータの編集
  4. 04ローカルでの動画生成
  5. 05縦型・正方形フォーマットの選択

活用シーン

  1. 01一定期間のエージェント利用を振り返る場面
  2. 02繰り返しの修正をルールにまとめる場面
  3. 03共有前に確認する動画まとめを作る場面

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vkpdeveloper/agent-wrapped --skill agent-wrapped

インストール後、Claude Code で/agent-wrappedを入力して読み込まれたか確認します。

同梱ファイルwrapped.sh

詳細

Agent Wrapped

このファイルの隣にある wrapped.sh を使って、すべての処理を実行します。初回使用時に、GitHub からこの OS と CPU に対応する最新の agent-wrapped リリースを ~/.local/share/agent-wrapped にダウンロードします（40〜60 MB）。また、新しいリリースがあるかどうかを確認するのは1日に1回までなので、手動でインストールする必要はありません。マシンで初めて動画を作成するときは Chrome Headless Shell もダウンロードされるため、数分かかることがあります。

読み込みとレンダリングはすべてローカルで行います。アップロードされるものはありません。

1. 履歴を読み込む

<skill-dir>/wrapped.sh stats -o "${TMPDIR:-/tmp}/wrapped.json"

ローカル履歴がある、対応済みのエージェントをすべて見つけ、セッション数で順位付けして、1行の概要を出力します。別の年を指定するには --year 2025 を、最初のカードに表示する名前をユーザーが指定した場合は --name "..." を追加します。JSON にはプロンプトの抜粋が含まれるため、一時ディレクトリに保管し、プロジェクト内には置かないでください。

2. 改善点を書く

JSON の corrections.samples を読みます。ここには、ユーザーがエージェントに異議を唱えた実際のプロンプトが含まれています。エージェントが繰り返し間違えた内容ごとにまとめ、lessons を最大3件、最も頻度の高いものから順に記述します。

  • rule：ユーザーが CLAUDE.md または AGENTS.md に貼り付けられる指示です。8語以内で、命令形かつ具体的な内容にします（「Use bun, never npm」「Run the tests before saying done」「Ask before deleting files」）。
  • count：そのルールが該当するサンプルの数です。正確に数えてください。動画にその数が表示されます。

一度限りの不満や、個人名、クライアント名、秘密情報が含まれる内容は除外します。パターンが繰り返されていない場合は、lessons を空のままにします。persona.line はより明確な表現にしてもかまいませんが、計算済みの数値はそのままにしてください。編集した JSON を保存します。

3. レンダリングする

<skill-dir>/wrapped.sh render "${TMPDIR:-/tmp}/wrapped.json" -o ~/Desktop/agent-wrapped-<year>.mp4

ユーザーが場所を指定していない場合は、~/Desktop が存在すればそこを使い、なければ現在のディレクトリを使います。X または LinkedIn のフィード用には --format square（1080x1080）を指定します。Stories、Reels、TikTok 用のデフォルトは縦型（1080x1920）です。

レポート

動画のパス、主な数値（時間、セッション数、1位のエージェント）、ペルソナ、改善点を伝えます。改善点を CLAUDE.md または AGENTS.md に追加することを提案します。動画にはプロジェクト名と頻出フレーズが表示されるため、投稿前に確認するよう伝えます。

コメント

Markdown 対応