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 代理可以使用该技能。

为什么重要

无需手工编写提示词 – 你只需像往常一样工作；应用会记录点击、按键和屏幕内容。
聚焦“为什么” – 生成的技能不仅捕捉步骤，还捕捉你隐式使用的策略（选择标准、护栏、语气）。
持续改进 – 代理执行技能后会回报结果；成功运行会提高置信度，偏差会触发问题，你可以批准或修正技能。
本地优先且私密 – 所有录制、嵌入和知识库都留在你的 Mac 上；只有你能决定代理是否可以查询存储的“记忆”。

核心概念

概念	功能
技能	描述工作流程的 Markdown 文档：策略、有序步骤、选择标准、护栏、语气、置信度分数以及任何未解决的问题。
记忆	你见过的每个屏幕的私密、可搜索的存档。屏幕通过 Google 的 EmbeddingGemma 2（通过 Ollama）嵌入，并以向量 + 简短的编辑后描述形式保留；截图在嵌入后删除。
Commonplace	统一搜索 UI（以及 CLI / REST API），让你或连接的代理可以查询技能、记忆时刻、每日摘要和用户资料。
知识账本	追踪技能中哪些部分是已知、假设或未知的，并推动每周的问题预算。
MCP 服务器	一个小的本地服务器，调解 AgentHandover 与任何 MCP 兼容代理之间的通信。

工作原理 – 用户流程

安装 – 下载 .pkg 版本，运行入门向导（授予屏幕录制、辅助功能权限，并安装所需的 Ollama 模型）。
录制任务 – 点击菜单栏中的 Record，执行一次工作流程，停止录制。
回答最多三个问题 – 应用会询问它无法推断的内容（例如，开始条件、结束条件、模糊步骤）。
审核并批准 – 出现草稿技能；你确认步骤、策略和护栏，然后点击 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 天；向量和编辑后的描述保留一年。
隐私区域可让你从捕获中排除密码管理器、银行网站等。

自动化使用案例

研究 – 扫描来源，提取事实，起草摘要。
社区参与 – 每天用你的语气在 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 用于高级控制。

隐私与安全

所有数据保留在设备上；只有你能控制代理是否可搜索记忆。
屏幕在嵌入后删除；缩略图使用 Keychain 存储的密钥加密。
应用尊重 macOS 隐私区域，并允许你手动遗忘或暂停记忆捕获。

谁在背后？

由 Sandro Andrić（BySandro）创建 – 参见 README 中的徽标和个人网站链接。可提供 Discord 社区支持。

底线： AgentHandover 是一款真正的 macOS 中心工具，它将你重复的桌面工作流程转换为结构化的、AI 可读的技能，存储你的工作的可搜索视觉记忆，并让本地 AI 代理执行这些技能，同时从它们的运行中持续学习。它完全属于 AI 代理自动化领域。

sandroandric/AgentHandover