Handoff

跨会话交接、上下文保存或长任务中断续接时使用。结构化保存→新会话恢复。

kyrie66nb b3d1f9f 1.4 KB Updated

File contents

跨会话交接

当前状态

!git branch --show-current 2>/dev/null && git log --oneline -5 2>/dev/null !git status --short 2>/dev/null | head -20

触发时机

  • 用户明确要求保存进度或交接
  • 长任务接近上下文窗口上限
  • 完成一个逻辑阶段,准备进入下一阶段
  • 当日结束,次日需继续

保存流程

  1. 写入 HANDOFF 文件:优先 .claude/HANDOFF.md,不存在则 HANDOFF.md
  2. 有未提交代码变更时委派 git-committer 提交;无变更则跳过
  3. 告知用户文件位置与恢复方式

HANDOFF 格式

## HANDOFF — [任务名]

### 已完成
- [x] 步骤描述:结果摘要

### 进行中
- 当前分支:`<branch>` @ `<commit-sha>`
- 当前状态:描述

### 下一步(可验证目标)
1. 目标描述 → 期望结果
2. 目标描述 → 期望结果

### 注意事项
- 已知风险 / 设计决策 / 依赖 / 阻塞点

恢复流程

  1. 读取 HANDOFF,跳过“已完成”
  2. 验证“进行中”中的分支与代码状态
  3. 从“下一步”的第一个目标继续执行

退出标准

  • HANDOFF 文件已写入,且包含全部必需章节
  • 若存在代码变更:已提交到对应分支;若无代码变更:结果中已明确说明

kyrie66nb/codex-omx-public-config/tree/main/home/.codex/skills/handoff commit b3d1f9fe38

Frequently asked questions

npx skillmds@latest add kyrie66nb/handoff