/
← Back to home@DBinK

dbk-handoff

轻量级、基于文件的上下文交接协议与 Agent Skills，在 Claude Code、Cursor、Windsurf、pi 等任意 Agent 间实现任务无缝接力。 | A lightweight, file-based context handoff protocol and Agent Skills for seamless task continuity across Claude Code, Cursor, Windsurf, pi, and any AI agent.

Stars
2
Language
—
Created
Oct 18, 2026
Updated
Oct 20, 2026
Skills
GitHub repoHomepage

Introduction

dbk-handoff

skills.sh Agent Skills Protocol License: MIT

跨 AI Agent 的通用上下文交接与接力协议 Skills

在 Claude Code、Cursor、Windsurf、OpenHands 等工具之间切换时，新 Agent 往往缺少上一个会话的目标、进度和踩坑记录，只能重新翻代码。dbk-handoff 用一份高密度 Markdown 快照解决这个问题：发出端负责总结，接收端负责接手，全程不依赖服务端或外部中转。

核心特性

  • 纯文件协议：只需要读写文件的能力，报告是普通 Markdown，无数据库、无 RPC。
  • 渐进式加载：优先消费摘要；原始会话日志仅在关键信息缺失时按需检索，避免上下文爆炸。
  • 防重复考古：报告显式列出核心工作集、已排除的死胡同方案和验证命令，新 Agent 不需要重新摸索。
  • 可追溯：每次交接生成带时间戳的历史快照，latest.md 始终保存最新副本。
  • 人工确认环：交接通过一段可复制的 Prompt 完成，用户可以在接手前审计和补充。

灵感与设计来源

本项目的结构化交接模板与设计哲学深受 can1357/oh-my-pi（omp）项目及其 /handoff 机制启发。特别吸纳了 omp 对核心工作集（Key Files，8~15 个文件上下文）、**已排除的死胡同方案（Dead Ends，防止接手 Agent 重蹈覆辙）与验证闭环（Verification Plan）**的严格定义，避免把时间耗在“代码考古（File Archaeology）”上。

组成

  • dbk-handoff（发出端）：总结当前进度、写入 .agent/handoff/、生成接手指引。
  • dbk-pickup（接收端）：读取交接快照，向用户确认理解后继续执行。

安装

npx skills add DBinK/dbk-handoff -g -y

支持 skills 生态的客户端可直接执行上述命令；其他客户端可由 Agent 根据自身环境完成 Skill 安装。

读取交接报告必须遵循 dbk-pickup 中的指引（路径解析、版本与 Git 状态校验、Transcript 按需检索），不要绕过 Skill 直接裸读 latest.md。

使用

  1. 发出交接：在当前 Agent 中调用 skill /dbk-handoff。它会写入一份 <YYMMDD>-<HHMM>-<主题>.md 快照和 latest.md 副本，并输出一段引导 Prompt。
  2. 接手任务：把引导 Prompt 粘贴给新 Agent。它调用 /dbk-pickup 读取报告、汇报理解并停下来等待你确认，确认后再继续执行。

引导 Prompt 示例：

--- [请复制以下内容发送给接手 Agent] ---
我在使用另一个 AI 协助开发，现需要你接手该任务。

【前置检查】
请检查你是否已安装 `dbk-pickup` skill。若未安装，请先装上该 skill（如 `npx skills add DBinK/dbk-handoff -g -y`）并重新加载 skills，再调用 `dbk-pickup`。

【接手指引】
请调用 `dbk-pickup` skill 恢复以下任务的上下文：
- 项目根目录：/abs/path/to/workspace
- 交接报告路径：/abs/path/to/workspace/.agent/handoff/261018-1230-auth-refactor.md

请先阅读交接报告，用简短几句话向我汇报你所理解的当前现状与下一步计划，然后停下来等待我确认，在此之前不要修改任何文件或执行待办命令。
----------------------------------------

报告元数据示例：

---
handoff_version: 1
created: "2026-10-18T12:30:00+08:00"
snapshot: 261018-1230-auth-refactor.md
workspace: /abs/path/to/workspace
source_agent: claude-code
source_model: claude-sonnet-4
task: auth-refactor
git: { branch: main, head: 11670ce, dirty: true }
---

兼容性

任何具备文件读写能力的 Agent 都可以参与交接流程，但读取报告必须加载 dbk-pickup 的指引；支持 Skill 的客户端可一键调用，其他客户端可由 Agent 按该指引执行。快照目录自带 .gitignore，默认不会污染业务仓库。

文档

  • ARCHITECTURE.md — 存储与命名规范、报告元数据、工作流程、Skill 设计细节。
  • AGENTS.md — 面向 Agent 与贡献者的修改约定与校验命令。
  • CHANGELOG.md — 项目显著变更记录。

许可

MIT