技能:状态回顾 (/vibe-explain-back)
执行代理: explainer (解说员) 主导
概述 (Summary)
Vibe coder 经常"周末做几小时、下周再回来"——回来时脑子里的上下文早就丢了。
/vibe-explain-back 用非技术语言、类比修辞、可视化清单,
在 5 分钟内让用户"接上"当前项目状态,知道下一步该按哪个按钮。
不同于 /vibe-check:
/vibe-check:校准意图(现在和最初想的一致吗?)/vibe-explain-back:恢复上下文(我上次做到哪了?)
触发时机 (Triggers)
- 用户直接调用
/vibe-explain-back - 用户表达"我忘了做到哪了"、"当前是什么情况"、"帮我梳理下"
- 距离上次交互 > 3 天时自动建议
工作流 (Workflow)
阶段 1:证据收集 (Explainer 静默完成)
不打扰用户,扫描并读取:
.usds-mode:当前模式docs/specs/lite-spec.md或docs/specs/PRD.md:最初意图docs/specs/intent-log.md:历史校准sandbox/**/README.md或production/backlog.md:当前工作项- 最近 git 提交(若可用):
git log --oneline -10 docs/reviews/:最近评审记录
阶段 2:状态提炼
生成三段式汇报(全部用非技术语言):
一、"你想做什么"
- 引用 lite-spec/PRD 的原句(不加工)
- 一句话总结项目目标
二、"你已经做到哪"
- 上次结束时的状态(用类比说明,如"厨房已经装修好,正在挑家具")
- 已完成的关键节点(清单,每条 1 行)
- 当前正在做的事
三、"下一步该做什么"
- 3 个可选动作,标注难度(10 分钟 / 1 小时 / 半天)
- 每个动作对应一个具体的 slash command 或文件
阶段 3:可视化时间线
生成 ASCII 时间线(简洁,5-8 个节点):
[意图] → [原型 v1] → [校准] → [原型 v2] → [审美评审] → [现在]
✓ ✓ ✓ ✓ ✓ ▲ 这里
阶段 4:用户交互
使用 ask_user 呈现 3 个下一步选项:
- [选 A:<10 分钟动作>]
- [选 B:<1 小时动作>]
- [选 C:<半天动作>]
成功门控 (Success Gate)
- 三段式汇报完整(想做什么 / 做到哪 / 下一步)
- 时间线可视化清晰(≤ 8 个节点)
- 3 个下一步选项每个都对应具体动作
- 用户从"完全没上下文"到"知道该按什么"
- 不落盘:这是一次性汇报,不产生文档
输出格式
这是一次直接输出到用户的技能,不落盘、不精简。全文如下:
# 📋 状态回顾 — <项目名>
## 你想做什么
> "<lite-spec/PRD 原句>"
一句话:<非技术语言总结>
## 你已经做到哪
你上次结束时,<类比说明>。
已完成:
- ✓ <关键节点 1>
- ✓ <关键节点 2>
- ✓ <关键节点 3>
正在做:
- ⏳ <当前工作项>
## 时间线
[意图] → [原型 v1] → [校准] → ... → [现在]
✓ ✓ ✓ ▲ 这里
## 下一步(选一个开始)
**A. 快速接续(10 分钟)**
<具体动作,如"跑 `/vibe-check` 校准一下方向">
**B. 认真推进(1 小时)**
<具体动作,如"打开 sandbox/xxx,修复审美评审提出的 3 个小问题">
**C. 里程碑推进(半天)**
<具体动作,如"跑 `/vibe-graduate` 把原型晋升到 src">
请选择 A / B / C,或告诉我别的方向。
特殊场景
项目刚起步(只有 lite-spec,没原型)
- 跳过"做到哪"章节
- 下一步只推荐
/vibe-prototype
项目卡壳(连续 3 次 /vibe-check 都判 pivot)
- 在汇报中主动指出"过去 X 次校准都在纠结方向"
- 下一步 A 改为"跑
/vibe-start重新对齐意图"
有多个 sandbox 分叉存在
- 在"做到哪"中并列展示每个分叉的状态
- 下一步选项包含"跑
/vibe-taste-review对比分叉"
已进入 Studio Mode
- 数据源从
intent-log切换到backlog.md和RELEASE-CHECKLIST.md - 时间线以 sprint / milestone 为节点
- 下一步动作对齐 Studio Mode 技能(
/studio-review//studio-gate-check)
与其他技能的边界
| 关注点 | 归属 |
|---|---|
| 意图漂移分析 | /vibe-check |
| 上下文恢复、状态梳理 | /vibe-explain-back |
| 审美问题识别 | /vibe-taste-review |
| 代码质量评审 | /studio-review |
输出约束
[破例] 本技能是直接对用户的汇报,输出即最终产物,不需要精简摘要。 但仍要遵守:
- 不使用未解释的技术术语
- 时间线 ≤ 8 个节点
- 下一步 ≤ 3 个选项
协作路径
- 用户选 A → 交棒对应的快速动作技能
- 用户选 B/C → 进入相应工作流
- 用户表示"我想换方向" → 建议
/vibe-branch或/vibe-start