这个项目能做什么

Handoff 是一项针对同一工作跨多个 AI 代理会话进行接力的代码库代理技能。其解决的问题是：列表中未勾选的任务不一定未完成，因为其他代理可能已经实现它、某次提交可能已经满足它、需求可能已变，或者其他人可能仍拥有相关文件的所有权。该技能使用一个共享的账本文件 HANDOFF.md，并结合 Git 历史、当前代码、测试和所有权等代码库证据，来判定哪些任务实际上仍未完成。 记录的工作流包含六个阶段。预检（Preflight）认领一个会话名称，并从一个版本化快照中返回每个开放账本条目及其步骤、最近完成条目的摘要、结构错误和 Git 状态。接入（Intake）将每个请求转化为带有日期的任务条目，其中包含独立的“进行中”和“已完成”复选框、步骤、验证和状态行。渐进式审计（Progressive audit）权衡后期的账本条目、提交、当前源码、实时所有权以及较早条目的复选框，然后将实际范围分类为“已完成”、“部分完成”、“已被取代”、“未完成”或“未知”，并采用批注而非删除的方式以保留历史记录。所有权解决（Ownership resolution）在用户未给出显式排序的情况下，询问符合条件的工作是应当先完成，还是在开始新任务之前留给当前所有者。安全写入（Safe writes）在同行可能写入同一树时，通过带锁的比较并交换（compare-and-swap）路由更新。最后，代理暂存显式路径、记录验证和提交标识符，并留下一个可供下一个代理继续推进的状态。 账本条目记录所有者标签、可选的 harness 字段（自动检测 Claude Code、Codex、Cursor 和 VS Code，可通过环境变量覆盖）、状态框、已勾选和未勾选的步骤、状态行以及下一步行动。已完成的任务保持两个框都处于勾选状态，以便将账本作为历史记录阅读。会话从一百个神话人物的名单中认领名称，按先到先得的原则分配，且绝不会复制账本中已存在的拥有者。 该项目提供了一个标准库 Python CLI，带有用于代理和任务的实时 curses 仪表盘，可显示已完成与总任务数、进行中和待处理计数、步骤进度，以及记录时每个所有者使用的 harness。它还可以在纯文本快照模式、只读模式下运行，或者在解析当前版本锁定安装的 PATH 启动器后面运行。仪表盘支持剪切任务并将其粘贴到另一个所有者身上，这会重写所有者标签并在同一锁下记录移动。状态栏脚本打印单行进度行，文档记录其可与 Claude Code、Grok CLI 和 Kimi Code 状态栏配合使用，并为 Codex 和其他 CLI 提供 tmux 包装器。 本地代理消息通道将消息和确认存储在限定于一个检出且被 gitignore 排除的 SQLite 文件中，无需守护进程或套接字。代理可以发送问题、回复、报告可用性、释放其未完成的任务桶、在租约上声明续期截止日期，并使用挑战/证明（challenge/attest）随机数交换来表明另一个代理正在响应。安装方式提供为来自市场的 Claude Code 插件、Cursor 市场导入，或通过 npx skills add 适用于其他主机；README 指出需要 Git、具有代码库读/edit 访问权限的代理以及 Python 3.9+，无需 API 密钥、托管服务或第三方 Python 包。唯一离开机器的功能是可选的 ssh 发布步骤，在配置文件存在之前保持不活动状态。五个斜杠命令涵盖了初始化、查看、状态、继续和清除账本，README 指出了 Windows 对 curses 仪表盘和状态栏快速路径的限制。