mcpField
H
handoff

handoff

github.com/steveclarkeAgent 工作流36102 次安装1 天前更新
代码仓库

关于 handoff

handoff 是用于向后续工作会话传递简报的技能，面向需要交接未完成任务的开发者。它聚焦于完成事项、待办、决策和实用环境信息，并避免把简报提交到仓库。

主要功能

  1. 01汇总已完成与未完成事项
  2. 02记录决策和关键实践
  3. 03整理仓库与环境信息
  4. 04将简报传递给后续会话
  5. 05避免把简报提交到仓库

适用场景

  1. 01在开发会话结束时交接进度
  2. 02让后续会话继续未完成任务
  3. 03传递分支、环境和关键文件信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/steveclarke/dotfiles --skill handoff

安装后在 Claude Code 中输入/handoff确认已加载。

详细介绍

交接 — 向下一个会话简要说明

将本次会话的状态传递给继续工作的会话。交接是一份简报，而非记录：应尽可能直接发送给下一个会话，且绝不提交到仓库。

1. 收集状态

只收集下一个会话需要的信息：

已完成：

  • 已完成的任务或阶段
  • 新建或修改的文件（概述即可）
  • 已提交并推送的提交（分支、远程状态）

未完成：

  • 剩余任务或阶段
  • 遇到并修复的问题，避免下一个会话重复踩坑
  • 已开始但尚未完成的事项

决策：

  • 用户批准且会限制后续工作的选择
  • 已确立的模式
  • 尝试过但未奏效的方法

实用信息：

  • 仓库路径、分支、远程
  • 开发环境状态（正在运行，或如何启动）
  • 相关的测试凭据
  • 关键文件路径（规范、计划、文档）——最多 2～4 个

如果下一个任务不明确，请询问：“下一个会话应该重点做什么？”

2. 撰写简报

确保在一分钟内读完。内容应完整自足，不要写“见上文”。

# [Topic] — Handoff (YYYY-MM-DD)

[1-2 sentence summary of where things stand]

## Done
- ...

## Not Done
- ...

## Decisions
- ...

## Bugs Fixed (Don't Repeat)
- ...

## Practical
- Repo: [path] (branch: [branch])
- Dev stack: [state]

## Next
[What to do first]

## Read First
- [path] — [why]

3. 交付简报

使用第一个可行的方式：

  1. 另一个 Claude Code 会话正在运行。 使用 ListAgents 查找，并通过 SendMessage 发送简报。发送前确认目标会话。
  2. 目标运行在 Herdr 或 tmux 中。 在 Herdr 中使用 herdr 技能，或在普通 tmux 中使用 tmux-orchestration 技能，将简报发送到目标窗格。发送前确认窗格。
  3. 没有正在运行的目标。 将简报写入 ${TMPDIR:-/tmp}/handoff-YYYY-MM-DD-<topic>.md，复制一条指向该文件的单行续接提示到剪贴板（macOS 上使用 pbcopy，Linux 上使用 wl-copy 或 xclip -selection clipboard），并告知用户文件路径。该文件是临时文件，重启后丢失也没关系。

绝不要将简报写入项目或提交。

不要包含的内容

  • 对话过程的逐步记录
  • 原始错误日志（概述修复方法即可）
  • 可直接从磁盘读取的文件内容或实现细节
  • 可从 git log 或代码中推导的信息

评论

支持 Markdown