sandroandric/AgentHandover
What if OpenClaw, Claude Code, Codex etc. knew how to do your work without you saying it? AgentHandover observes you, learns and teaches your agents with self-improving skills.
AgentHandover – あなたのMacワークフローをAI実行可能なスキルに
これは何か
AgentHandover は、macOS専用のアプリケーションで、コンピュータ上で繰り返し行うタスクの実行方法を監視し、各タスクをスキル(ワークフロー、その目的、意思決定ロジック、ガードレール、あなたのライティングスタイルを構造化した説明)に変換し、そのスキルをClaude Code、Codex、OpenClaw、Hermes、またはMCPプロトコルを話す任意のツールなどのAIエージェントが利用できるようにします。
なぜ重要なのか
- 手作業のプロンプトは不要 – いつも通りに作業するだけ。アプリがクリック、キーストローク、画面内容を記録します。
- Whyに焦点 – 生成されたスキルは、手順だけでなく、あなたが暗黙のうちに使っている戦略(選択基準、ガードレール、声)も捉えます。
- 継続的改善 – エージェントがスキルを実行した後、報告が返されます。成功した実行は信頼度を上げ、逸脱は質問を引き起こし、スキルを承認または修正できます。
- ローカルファースト&プライベート – すべての録画、埋め込み、ナレッジベースはあなたのMac上に残ります。エージェントが保存された「メモリ」を照会できるかどうかを決めるのはあなただけです。
中核概念
| 概念 | 機能 |
|---|---|
| スキル | ワークフローを説明するMarkdown文書:戦略、順序付き手順、選択基準、ガードレール、声、信頼度スコア、未解決の質問。 |
| メモリ | あなたが見たすべての画面のプライベートで検索可能なアーカイブ。画面はGoogleの EmbeddingGemma 2(Ollama経由)で埋め込まれ、ベクトル+短い編集済み説明として保持されます。スクリーンショットは埋め込み後に削除されます。 |
| Commonplace | あなたや接続されたエージェントが、スキル、メモリの瞬間、日次ダイジェスト、ユーザープロファイルを照会できる統一検索UI(およびCLI / REST API)。 |
| ナレッジ台帳 | スキルのどの部分が既知、仮説、不明かを追跡し、毎週の質問予算を推進します。 |
| MCPサーバー | AgentHandoverとMCP互換エージェントとの間の通信を仲介する小さなローカルサーバー。 |
仕組み – ユーザーフロー
- インストール –
.pkgリリースをダウンロードし、オンボーディングウィザードを実行します(画面キャプチャ、アクセシビリティを許可し、必要なOllamaモデルをインストールします)。 - タスクを記録 – メニューバーの Record をクリックし、ワークフローを一度実行し、録画を停止します。
- 最大3つの質問に回答 – アプリが推測できなかったこと(開始条件、終了条件、あいまいな手順など)を尋ねます。
- レビューして承認 – ドラフトスキルが表示されます。手順、戦略、ガードレールを確認し、Approve for Agents をクリックします。
- エージェントを接続 – ワンライナー
agenthandover connect claude-code(またはcodex、openclaw、hermes)。エージェントはMCP経由でスキルを受け取ります。 - 実行 – エージェントのチャットでスキルを呼び出します(
/reddit-community-marketingまたは自然な説明)。エージェントが手順を実行し、進捗を報告し、スキルの信頼度が更新されます。
スキルの例(抜粋)
Reddit Community Marketing
Daily engagement workflow – 6 steps – 4 sessions learned
STRATEGY
Browse target subreddits for posts about marketing tools or growth-hacking. Engage with high-signal posts (10+ comments, <48 h old, not promotional). Write authentic replies: acknowledge → share experience → mention product.
STEPS
1. Open Reddit → r/startups
2. Scan posts – skip promotional, skip <10 comments
3. Open high-signal post, read top comments
4. Write reply: acknowledge → experience → mention product
5. Submit, verify not auto-removed
6. Repeat for r/marketing, r/growthacking (max 5/day)
SELECTION CRITERIA GUARDRAILS
- 10+ comments - Max 5 replies/day
- Not promotional - Never identical phrasing
- <48 h old - Never reply to own posts
VOICE & STYLE
Tone: casual, short punchy sentences, occasional emoji.
スキルには信頼度(89%)と所要時間(約15分)も保存されます。
メモリと検索(Commonplace)
- すべての画面は EmbeddingGemma 2 で埋め込まれます(画面あたり約0.5秒)。
- メニューバーから検索したり、
agenthandover memory search "invoice from Acme"で検索したり、エージェントに照会させることができます(agenthandover memory agents on)。 - 画面は小さな暗号化されたサムネイルとして7日間保持され、ベクトルと編集済み説明は1年間保持されます。
- プライバシーゾーンでは、パスワードマネージャーや銀行サイトなどをキャプチャから除外できます。
自動化のユースケース
- リサーチ – ソースをスキャンし、事実を抽出し、要約を作成します。
- コミュニティエンゲージメント – あなたの声で毎日Reddit/Discordに投稿します。
- サポートトリアージ – チケットを読み、マクロを選び、返信を作成します。
- データ抽出 – ダッシュボードやスプレッドシートから構造化データを引き出します。
- 運用チェックリスト – デプロイ、リリース、ステータス更新。
- パーソナルスキルライブラリ – エージェントに実行させたい任意の繰り返し可能なワークフロー。
インストールとクイックスタート(概要)
# 1. GitHubリリースページから.pkgをインストールします
# 2. タスクを記録します
# 3. 自動生成された質問に回答します
# 4. ドラフトスキルを承認します
# 5. エージェントを接続します
# agenthandover connect claude-code
# 6. Claude Codeで実行します: /reddit-community-marketing
CLIは、高度な制御のために agenthandover install、agenthandover memory forget、agenthandover search …、list_ready_skills も提供します。
プライバシーとセキュリティ
- すべてのデータはデバイス上に留まります。エージェントがメモリを検索できるかどうかを制御できるのはあなただけです。
- 画面は埋め込み後に削除されます。サムネイルはキーチェーンに保存されたキーで暗号化されます。
- アプリはmacOSのプライバシーゾーンを尊重し、メモリキャプチャを手動で忘れたり一時停止したりできます。
誰が作ったのか?
Sandro Andrić(BySandro)によって作成されました。READMEにロゴと個人サイトへのリンクがあります。ディスコードコミュニティでサポートを利用できます。
結論: AgentHandoverは、繰り返し可能なデスクトップワークフローを構造化されたAI読み取り可能なスキルに変換し、作業の検索可能なビジュアルメモリを保存し、ローカルAIエージェントがそれらのスキルを実行しながら実行から継続的に学習できるようにする、真のmacOS中心のツールです。それはまさにAIエージェント自動化の分野にあります。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト