# 续接格式

完成命令或工作流后展示下一步的标准格式。

## 核心结构

```
---

## ▶ 下一步

**{标识符}: {名称}** — {单行描述}

`{可复制粘贴的命令}`

<sub>`/clear` 优先 → 全新上下文窗口</sub>

---

**也可选：**
- `{备选项 1}` — 描述
- `{备选项 2}` — 描述

---
```

## 格式规则

1. **始终展示它是什么** — 名称 + 描述，绝不仅仅是一个命令路径
2. **从源文件拉取上下文** — ROADMAP.md 用于阶段，PLAN.md `<objective>` 用于计划
3. **命令用内联代码** — 反引号，易于复制粘贴，渲染为可点击链接
4. **`/clear` 说明** — 始终包含，保持简洁但解释原因
5. **用"也可选"而非"其他选项"** — 听起来更像应用
6. **视觉分隔符** — 上下用 `---` 使其突出

## 变体

### 执行下一个计划

```
---

## ▶ 下一步

**02-03: 刷新令牌轮换** — 添加带滑动过期的 /api/auth/refresh

`/gsd:execute-phase 2`

<sub>`/clear` 优先 → 全新上下文窗口</sub>

---

**也可选：**
- 执行前审查计划
- `/gsd:list-phase-assumptions 2` — 检查假设

---
```

### 执行阶段中最后一个计划

添加注释说明这是最后一个计划以及接下来是什么：

```
---

## ▶ 下一步

**02-03: 刷新令牌轮换** — 添加带滑动过期的 /api/auth/refresh
<sub>阶段 2 的最后一个计划</sub>

`/gsd:execute-phase 2`

<sub>`/clear` 优先 → 全新上下文窗口</sub>

---

**完成后：**
- 阶段 2 → 阶段 3 过渡
- 下一步：**阶段 3: 核心功能** — 用户仪表板和设置

---
```

### 规划阶段

```
---

## ▶ 下一步

**阶段 2: 认证** — 带刷新令牌的 JWT 登录流程

`/gsd:plan-phase 2`

<sub>`/clear` 优先 → 全新上下文窗口</sub>

---

**也可选：**
- `/gsd:discuss-phase 2` — 先收集上下文
- `/gsd:research-phase 2` — 调查未知项
- 审查路线图

---
```

### 阶段完成，准备下一步

在下一步操作前显示完成状态：

```
---

## ✓ 阶段 2 完成

3/3 计划已执行

## ▶ 下一步

**阶段 3: 核心功能** — 用户仪表板、设置和数据导出

`/gsd:plan-phase 3`

<sub>`/clear` 优先 → 全新上下文窗口</sub>

---

**也可选：**
- `/gsd:discuss-phase 3` — 先收集上下文
- `/gsd:research-phase 3` — 调查未知项
- 回顾阶段 2 构建的内容

---
```

### 多个同等选项

当没有明确的主要操作时：

```
---

## ▶ 下一步

**阶段 3: 核心功能** — 用户仪表板、设置和数据导出

**直接规划：** `/gsd:plan-phase 3`

**先讨论上下文：** `/gsd:discuss-phase 3`

**研究未知项：** `/gsd:research-phase 3`

<sub>`/clear` 优先 → 全新上下文窗口</sub>

---
```

### 里程碑完成

```
---

## 🎉 里程碑 v1.0 完成

全部 4 个阶段已发布

## ▶ 下一步

**开始 v1.1** — 提问 → 研究 → 需求 → 路线图

`/gsd:new-milestone`

<sub>`/clear` 优先 → 全新上下文窗口</sub>

---
```

## 拉取上下文

### 用于阶段（从 ROADMAP.md）：

```markdown
### 阶段 2: 认证
**目标**: 带刷新令牌的 JWT 登录流程
```

提取：`**阶段 2: 认证** — 带刷新令牌的 JWT 登录流程`

### 用于计划（从 ROADMAP.md）：

```markdown
计划:
- [ ] 02-03: 添加刷新令牌轮换
```

或从 PLAN.md `<objective>`：

```xml
<objective>
添加带滑动过期窗口的刷新令牌轮换。

目的: 在不影响安全性的前提下延长会话生命周期。
</objective>
```

提取：`**02-03: 刷新令牌轮换** — 添加带滑动过期的 /api/auth/refresh`

## 反模式

### 不要：仅命令（无上下文）

```
## 继续

运行 `/clear`，然后粘贴：
/gsd:execute-phase 2
```

用户不知道 02-03 是关于什么的。

### 不要：缺少 /clear 说明

```
`/gsd:plan-phase 3`

先运行 /clear。
```

没有解释原因。用户可能跳过。

### 不要："其他选项" 措辞

```
其他选项：
- 审查路线图
```

听起来像是事后补充。用"也可选："替代。

### 不要：用围栏代码块展示命令

```
```
/gsd:plan-phase 3
```
```

模板内的围栏代码块会造成嵌套歧义。用内联反引号替代。