# Vesti Handoff

> Produce a schema-based work handoff when transferring a task to another AI or session, compacting context, switching tools, generating a handoff, or preparing for /compact. Require the receiving agent to re-run the latest verification before trusting the handoff. The V2 format aligns with the VESTI-APP RelayPackV2 schema.

- Skill: `firefly-hefeng/vesti-handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add firefly-hefeng/vesti-handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/firefly-hefeng/vesti-handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: firefly-hefeng (https://skillmd.com/u/firefly-hefeng)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/firefly-hefeng/vesti-handoff

---


# VESTI Handoff V2 — 结构化工作交接（含接手先验证规则）

把当前工作压缩为下一会话/另一个 AI 可直接接手的交接文档。**清单类信息（文件、命令、git 状态）从真实记录提取，不凭印象罗列**；叙事类由你归纳。

## V2 格式（与 VESTI-APP Relay Pack 对齐）

```json
{
  "meta": { "version": 2, "createdAt": "<ISO 8601>", "conversationCount": 1 },
  "goal": "可检验的目标（一两句）",
  "state": {
    "completed": ["已完成事项 + 证据锚点"],
    "inProgress": ["进行中事项 + 停在哪一步"],
    "blocked": ["被阻塞事项 + 阻塞原因"]
  },
  "files": [
    { "path": "真实碰过的文件路径", "why": "为什么重要", "last_state": "目前改动状态" }
  ],
  "decisions": [
    { "decision": "做了什么决定", "rationale": "理由 + 否决的替代方案" }
  ],
  "failedPaths": [
    { "approach": "试过的方案", "whyFailed": "失败原因", "evidence": "上下文中的证据位置" }
  ],
  "verification": {
    "lastCommand": "最后执行的验证命令",
    "lastResult": "最近一次输出",
    "passed": true
  },
  "nextSteps": ["按优先级排序的下一步"],
  "confidence": { "overall": 0.85, "lowAreas": ["低置信区域"] },
  "environment": {
    "gitBranch": "分支名",
    "gitRemote": "远程地址",
    "dirtyFiles": ["未提交文件"],
    "nodeVersion": "v20.x",
    "packageManager": "pnpm"
  },
  "handoffPrompt": "【交接说明】以下内容来自另一个 AI…（完整交接提示词）"
}
```

## 交接文档结构（Markdown 可读版本，按此顺序）

```markdown
# 交接：<任务一句话>
> 另一个 AI 产出了以下工作摘要。请在已有基础上继续，避免重复劳动。
> **在采信最后的结论之前，先回到「验证」一节重新跑一遍最后一条验证命令，确认无误后再继续。**

## 目标（Goal）
做完是什么样（一两句，可检验）。

## 状态（State）
### 已完成（Completed）
- 每条带证据锚点：文件路径 / 命令输出 / 会话引用。

### 进行中（In Progress）
- 当前停在哪一步、为什么。

### 被阻塞（Blocked）
- 哪些事项因未解决的依赖而无法推进。

## 关键决策（Key Decisions）
- 选了什么 + 否决了什么 + 原因。

## 关键文件（Key Files）
| 路径 | 为什么重要 | 最后状态 |
（从工具调用/编辑记录确定性提取，禁止虚构；每条带来源）

## 失败死路（Failed Paths）
- 试过什么 → 结果如何 → 为什么放弃。（最贵、最易丢的一段，必须保留）
- 每条附带证据位置（哪个会话/消息显示了该失败）

## 验证（Verification）
- 最后执行的验证命令 + 最近一次实际结果（时间）。
- 标注通过/失败状态。接手方第一条必须重跑。

## 下一步（Next Steps）
- 每条自包含、离开本聊天也能执行；第一条 = 重跑验证。

## 置信度
- 整体 0-100% + 低置信区域（哪些部分需要接手方重点复核）。

## 环境（Environment）
- Git 分支/远程、Node/包管理版本等可重现的环境信息。
```

## 守则

- **接手先验证**：无论交接方多可信，先把「验证」节最后一条命令重跑一遍——"报告说完成"不等于完成。
- 失败尝试与否决原因**完整保留**，不许美化成"一切顺利"；每条致命 `evidence` 指向上下文中的证据。
- 文件清单只列真实碰过的（编辑/读取/引用）；不确定的条目标「待核实」。
- **阻塞项与进行中区分**：因依赖未满足而无法推进的标为 blocked，正在做的标为 inProgress。
- **决策要写否决方案**：不光写做了什么决定，还要写否决了哪些替代方案及原因。
- 交接文档本身落盘（如 `HANDOFF.md` 或交给 VESTI 沉淀区），不要只存在于对话里。
- V2 JSON 格式与 VESTI-APP Relay Pack 对齐，确保机器可读。