前言¶
换 AI Agent 时最常见的问题不是能力不够，而是状态丢失：上次改到哪、构建命令是什么、哪些任务已阻塞或取消、下一次进入项目应该从哪继续。聊天记录不能长期作为项目状态，散落在各处的 TODO 也不能被下一个 Agent 稳定读取。AgentHandoff 尝试把“项目进度”收敛到一个统一交接看板 handoff.md，并让进入项目的 Agent 在缺少该文件时自主初始化。
这是什么¶
AgentHandoff 是一个 community 来源的 ai-agent 类 Skill，坐标 @user_9e60f203/agent-handoff，当前版本 3.0.2，发布者 user_9e60f203，标签显示 requires_api_key=false。它解决的问题是：不同 AI Agent 进入同一个新项目时，如何快速恢复上下文、继承任务状态，并在中断或换 Agent 后继续推进。
核心功能¶
它提供的能力集中在项目接管与交接治理：
- 统一交接看板：以
handoff.md作为跨 Agent、跨会话的项目状态入口。 - 智能多技术栈自主初始化：新项目缺少
handoff.md时，Agent 可自动触发初始化。 - 推导项目构建命令：初始化过程中尝试推导项目的构建/验证命令，减少人工口述。
- 薄入口：入口保持轻量，便于进入项目时先读取状态，再展开具体实现。
- 版本备份：交接状态可备份，降低单文件覆盖或误改带来的恢复成本。
- 智能拆分：对复杂任务或交接内容进行拆分，避免单份状态文件过度膨胀。
- 统一日志：会话与任务推进过程纳入统一日志，便于回溯。
- 任务阻塞与取消状态管理：记录任务被阻塞或取消的状态，而不是只保留“待办/完成”。
- 中断接管自愈：Agent 中断后重新接管时，可基于已有状态继续处理。
官方简介将其适用面描述为 Claude Code、Codex、Antigravity、Trae、Cursor、Windsurf、GitHub Copilot 等 Agent。实际能否自动触发，仍取决于运行这些 Agent 的环境是否按 SKILL.md 方式加载并执行该 Skill。
安装与启用¶
已抓取资料没有给出具体安装命令、目录写入方式或 Cursor / Codex CLI / Claude Code 的差异配置。为避免编造，这里只列可核对的官方入口与坐标：
SkillHub 页面: https://www.skillhub.cn/skills/user_9e60f203/agent-handoff
官方地址: https://api.skillhub.cn/user_9e60f203/agent-handoff
坐标: @user_9e60f203/agent-handoff
版本: 3.0.2
来源: community
分类: ai-agent
启用方式应以官方页面当前说明为准；若你的客户端支持 SKILL.md 类 Skill，需要确认它是否允许项目内自动初始化 handoff.md，再决定是否开启。
典型用法¶
官方简介给出的触发场景包括：开始或结束一次 agent coding session、在项目中自动初始化 handoff state、在 agent 之间交接工作、查看项目任务看板、创建 session logs、备份 handoff state。可复现的用法主线如下：
- Agent 进入项目后先检查是否存在
handoff.md。 - 若不存在，按 Skill 流程初始化交接看板。
- 初始化时推导项目构建命令，并写入可被后续会话读取的状态。
- 任务推进过程中记录进度、阻塞、取消和日志。
- 需要换 Agent 或会话中断时，从
handoff.md恢复上下文。 - 交接前按版本备份机制保存状态，避免覆盖上一版进度。
适用场景与注意¶
适合这几类场景：新项目首次交给 AI Agent；同一项目长期由多个 Agent 或多次会话接力；任务较长且存在阻塞、取消、恢复等状态；需要统一日志做审计或回溯。
需要注意的点：handoff.md 是项目级状态文件，自动初始化和自动推导命令能降低启动成本，但生成内容仍应在首次接入项目时人工核对，尤其是构建命令、目录结构和任务边界。多 Agent 同时写同一个项目时，还要处理写冲突和备份策略；如果客户端不支持 Skill 自动触发，“零人工干预”只会停留在协议描述，不会实际发生。
结尾¶
AgentHandoff 的价值在于把“换 Agent”从重新解释项目，变成读取并维护一份可继承的交接状态。它不替代工程实践，但能让项目进度、任务状态和会话日志有一个统一落点。官方地址：https://api.skillhub.cn/user_9e60f203/agent-handoff
