Explain back

Skill wxxzy/Claude-Code-Software-Studios/.claude/skills/explain-back

基于 Claude Code 的双模态软件开发工作室框架

Install

npx -y skills add wxxzy/Claude-Code-Software-Studios --skill explain-back

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

项目状态非技术语言汇报。用非技术语言告诉用户"我们现在项目是什么状态、做到哪一步、下一步该做什么"。适合走开一段时间回来的用户，或非技术背景的用户。

SKILL.md

5.0 KB, as published. Nobody here has run it

技能：状态回顾 (/explain-back)

执行代理: explainer (解说员) 主导

概述 (Summary)

Vibe coder 经常"周末做几小时、下周再回来"——回来时脑子里的上下文早就丢了。 /explain-back 用非技术语言、类比修辞、可视化清单，在 5 分钟内让用户"接上"当前项目状态，知道下一步该按哪个按钮。

不同于 /vibe-check：

/vibe-check：校准意图（现在和最初想的一致吗？）
/explain-back：恢复上下文（我上次做到哪了？）

触发时机 (Triggers)

用户直接调用 /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. 里程碑推进（半天）**
<具体动作，如"跑 `/graduate` 把原型晋升到 src">

请选择 A / B / C，或告诉我别的方向。

特殊场景

项目刚起步（只有 lite-spec，没原型）

跳过"做到哪"章节
下一步只推荐 /prototype

项目卡壳（连续 3 次 `/vibe-check` 都判 pivot）

在汇报中主动指出"过去 X 次校准都在纠结方向"
下一步 A 改为"跑 /vibe-start 重新对齐意图"

有多个 sandbox 分叉存在

在"做到哪"中并列展示每个分叉的状态
下一步选项包含"跑 /taste-review 对比分叉"

已进入 Studio Mode

数据源从 intent-log 切换到 backlog.md 和 RELEASE-CHECKLIST.md
时间线以 sprint / milestone 为节点
下一步动作对齐 Studio Mode 技能（/review / /gate-check）

与其他技能的边界

关注点	归属
意图漂移分析	`/vibe-check`
上下文恢复、状态梳理	`/explain-back`
审美问题识别	`/taste-review`
代码质量评审	`/review`

输出约束

[破例] 本技能是直接对用户的汇报，输出即最终产物，不需要精简摘要。但仍要遵守：

不使用未解释的技术术语
时间线 ≤ 8 个节点
下一步 ≤ 3 个选项

协作路径

用户选 A → 交棒对应的快速动作技能
用户选 B/C → 进入相应工作流
用户表示"我想换方向" → 建议 /branch-vibe 或 /vibe-start