# Handoff

> Handoff

- Skill: `bog5d/handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bog5d/handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bog5d/handoff/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bog5d (https://skillmd.com/u/bog5d)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/bog5d/handoff

---


# handoff — 工作交接协议

## 核心逻辑

确保工作状态不丢失——任何 AI（Claude、Cursor、下一个 Hermes 会话）读完 handoff.md 就能接盘。

## Phase 1: 信息采集（并行）

三个维度同时采集：

```python
# 1. 项目结构
search_files(pattern="*", target="files", path=项目根目录, limit=100)

# 2. 任务状态
todo()  # 当前 todo list

# 3. Git 状态
terminal("git status --short && git log --oneline -10")
```

## Phase 2: 生成 handoff.md

文件结构：

```markdown
# Handoff — YYYY-MM-DD HH:MM

## 接手方
[Claude / Cursor / 下一个 Hermes 会话 / Aider]

## 项目状态
- 当前分支 / 最后 commit
- 关键文件改动

## 已完成决策
1. ...
2. ...

## 遗留问题（Pending Issues）
| 问题 | 严重程度 | 备注 |
|------|---------|------|
| ... | high/medium/low | ... |

## 下一步具体指令
1. ...
2. ...

## 环境信息
- 工作目录
- 活跃服务/端口
- 需要设置的 API Key
```

## Phase 3: 写入根目录

```python
write_file(path="handoff.md", content=...)
```

## Phase 4: 确认输出

告知波总文件路径和核心内容摘要。

## Pitfalls

- 不要写废话——接手方 AI 需要的是可执行指令，不是叙事散文
- 遗留问题必须标注严重程度，让接手方知道先处理什么
- 环境信息要具体到端口号、进程名，不要"服务器在运行"这种模糊描述