| name | vibe-save |
| description | Use when the user wants to save session context. This is a human-facing session handoff entrypoint that preserves work state via vibe3 handoff, not an automated persistence workflow. |
/vibe-save - Human-Facing Session Handoff Entrypoint
该技能是人机协作的 session 保存入口,负责整理当前会话并写入 handoff。
Core Principle: Human-Facing Interaction Only
vibe-save 只负责人机交互:
- 判断当前会话哪些内容值得保留
- 整理 handoff 内容(已完成、当前判断、阻塞点、下一步)
- 写入
vibe3 handoff append
- 提供明确的恢复提示
vibe-save 不承担的职责(由基础设施承接):
- 不定义"哪些字段算恢复现场"的业务语义
- 不决定 session 是否应该自动恢复
- 不承担 flow / task 状态同步
这些恢复语义由 vibe3 handoff、vibe3 flow 等基础设施承接。
Semantic Boundary
- vibe-save: Session handoff 保存入口
- vibe-continue: Session handoff 恢复入口
- vibe3 handoff: Handoff 基础设施(存储、链、查询)
- vibe3 flow/task: Flow 与 task 状态真源
- mcp-search / claude-mem: 长期项目共识存储(仅形成稳定共识时使用)
vibe-save 不等于自动状态同步:
vibe-save 只写入 handoff,不自动回写 flow/task 状态
- Flow/task 状态同步由各自的基础设施命令负责
Resume Contract (Shared with vibe-continue)
vibe-save 和 vibe-continue 共享以下恢复契约:
最小恢复现场(由 handoff 承接):
- 当前任务(task_id、title、status)
- 当前现场(branch、flow、worktree、pr、dirty)
- 本轮已完成
- 当前判断
- 阻塞点
- 下一步
- 关键文件
恢复顺序(vibe-continue 负责):
- 先读 flow/task 状态(共享真源)
- 再读 handoff(本地补充)
- 交叉核对现场
Human-Facing Workflow
Step 1: Read Current Scene Facts
优先读取基础设施事实:
vibe3 flow show
vibe3 handoff show
必要时补充:
git status --short
- 当前 branch
- 当前 PR / review 事实(如涉及)
Step 2: Write Handoff
在写入前必须先审阅已有内容,并核对共享真源与现场事实。
若发现现有 handoff 与当前事实不一致,必须先修正,再退出。
使用 vibe3 handoff append 写入,至少覆盖:
- 当前任务
- 当前现场
- 本轮已完成
- 当前判断
- 阻塞点
- 下一步
- 关键文件
Handoff 应优先回答"下个会话接手时需要知道什么"。
Step 3: Sync Shared Truth (Optional)
如果当前目录承载的 flow 已能识别当前 task:
- 使用现有 Shell API 同步最小必要事实
- 优先同步
next_step,必要时同步 status 或 pr_ref
- 不在 save 阶段替上层流程做新的任务拆分或优先级判断
vibe3 handoff append "[vibe-save] session save: <summary>" --actor vibe-save --kind milestone
如果当前目录尚未识别出当前 flow 对应的 task:
- 只运行
vibe3 handoff append 写入当前状态
- 明确向用户说明本次未回写共享 task 状态
Step 4: Long-Term Memory (Optional)
只有在本次会话产出了稳定的项目约束、长期适用的定义或反复复用的规则时,才使用 mcp-search / claude-mem 记录。
如果只是完成当前任务、记录 blockers 或保存下一步,不写记忆,更不默认创建新知识库。
Step 5: Output Save Summary
摘要应说明:
- Handoff 是否已写入(
vibe3 handoff show 可验证)
- 是否同步了共享 task 状态
- 是否使用了
mcp-search / claude-mem 记录稳定共识
- 当前最关键的下一步是什么
Recommended Handoff Format
# Current Task
- task_id:
- title:
- status:
# Current Scene
- branch:
- flow:
- worktree:
- pr:
- dirty:
# Completed This Session
- ...
# Current Judgment
- ...
# Blockers
- ...
# Next Step
- ...
# Key Files
- ...
Minimal Stop Points
- Save complete (handoff written)
- Handoff inconsistent, requires manual fix
- No active flow, only handoff saved
Design Principles
vibe-save 只负责人机交互,不定义恢复语义
- Handoff 是补充来源,不代替 flow/task 真源
- Claude-memory 只记录稳定共识,不承担临时状态保存