DBinK/dbk-handoff / skills/dbk-pickup
dbk-pickup
Verified读取 .agent/handoff/ 下的交接快照,校验协议版本与 Git 工作区状态,恢复任务上下文并向用户确认后继续开发。本技能是读取交接报告的唯一入口。当用户粘贴了交接引导 Prompt、要求接手上一个 Agent 或上一轮会话未完成的任务、让 Agent 读取 .agent/handoff/ 下的报告或 latest.md 继续干活,或提到“接手”“接着做”“pickup”“恢复上下文”时使用。不适用于在当前会话结束时总结进度并导出交接报告(应使用 dbk-handoff)。
上下文接手恢复(dbk-pickup)
作为读取 .agent/handoff/ 交接报告的唯一入口,按渐进式加载原则恢复任务上下文,校验协议版本与工作区 Git 状态,向用户汇报对齐并经确认后再继续推进任务。
工作流
1. 解析路径并读取交接报告
按“显式指定优先、latest.md 兜底”的顺序读取报告:
- 显式指定:若用户指令或引导 Prompt 中给出了具体的交接报告路径(如
<workspace>/.agent/handoff/<YYMMDD>-<HHMM>-<task>.md),直接读取该指定文件。 - 缺省兜底:若用户未附带具体路径(如直接调用
/dbk-pickup),默认读取<workspace>/.agent/handoff/latest.md。由于latest.md与权威快照内容完全一致,读取后直接使用其正文即可,无需再次读取snapshot字段指向的同名快照文件(snapshot字段仅用于标识快照归属与汇报引用)。 - 缺失处理:若指定文件或
.agent/handoff/latest.md不存在,列出.agent/handoff/下已有的快照供用户选择,或告知用户当前工作区尚无交接报告。
2. 校验报告元数据(Frontmatter)
读取报告后,先核对开头的 YAML frontmatter:
- 协议版本校验(
handoff_version):- 当前支持的版本为
1。 - 若报告中的
handoff_version高于1,必须先提示用户“当前交接报告版本高于本技能支持版本,将降级按纯文本阅读”,不要强行套用旧版字段假设。 - 忽略未识别的扩展字段,保持向后兼容。
- 当前支持的版本为
- Git 工作区状态比对(
git):- 若报告包含
git: { branch, head, dirty }字段,用只读 Git 命令检查当前工作区的实际分支、HEAD 短哈希与未提交变更状态;比对dirty时忽略.agent/路径,交接产物本身不算工作区变更。 - 若分支切换、HEAD 移动或
dirty状态与报告记录不一致,在向用户汇报时必须明确指出“交接后工作区已发生变化(说明具体差异)”,并在动手修改代码前等待用户确认。
- 若报告包含
3. 渐进式加载与防 Token 爆炸约束
- 聚焦核心工作集:根据报告中的
🎯 任务目标、📂 核心工作集、✅ 已完成事项、💡 关键决策与避坑指南和⏳ 当前停顿点与下一步待办建立任务全貌,仅按需读取下一步待办直接涉及的工作集文件,避免全仓盲目搜索。 - 严守避坑指南:仔细阅读报告中列出的
已踩坑/已排除方案,不得重复尝试已被前序 Agent 证伪的做法。 - 禁止盲读原始会话日志(
transcript):- 严禁主动一次性通读原 Agent 的完整 Transcript 日志文件。
- 只有在交接报告缺失关键细节导致无法推进、报告提供了有效
transcript路径且获得用户授权时,才使用行范围或关键词局部检索所需片段。
4. 向用户对齐状态并等待确认
读取与校验完成后,用简短 3~4 句话向用户汇报:
- 快照与状态:已读取的快照标识(
snapshot)及 Git 工作区状态是否与交接时一致。 - 目标与现状:已理解的任务目标、已完成进展与当前停顿点。若交接报告包含需求对照矩阵(
Spec & Baseline),优先按需求宏观坐标复述(如“对照 PRD 已完成 M/N 项,当前停留在第 X 项……”)。 - 避坑与待办:已留意的避坑约束,以及接下来准备执行的第一步具体动作与自测方案。
遵循以下行动边界:
- 默认先停下来等待确认:完成上述汇报后立即结束本轮回复并等待用户确认,在此之前只允许执行只读检查,禁止在同一轮直接修改任何文件或运行待办中的非只读命令。
- 例外:仅当用户在粘贴引导 Prompt 之外,额外附加了明确的立即执行指令(如“不用等我确认,直接开始改”)且工作区 Git 状态一致时,才可在汇报后直接执行待办第一步。
注意事项
- 未加载本技能指引时,不要跳过元数据校验直接裸读
.agent/handoff/latest.md开工。 - 若报告标记
git.dirty: true,接手时先通过git status -s和git diff查看工作区现有的未提交改动,分清哪些是前序 Agent 已完成的部分、哪些是停顿点留下的半成品,切勿盲目执行git checkout或git reset抹掉前序改动。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |