Files
msd-core/docs/zh-CN/references/continuation-format.md
Jakub Zych a9a7a328e6 refactor: hard-fork GSD -> MSD (Make Software Done)
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD
across contents and paths, upstream package/repo coordinates -> @golem15/msd-core
and golem15com/msd-core. Deep links into upstream history, sibling upstream
packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is.

Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line,
package/plugin identity, regenerated lockfile, install-tree fixtures, derived
registries and benchmark baseline; migration checksum baseline re-locked
(MSD keeps its own install state, so no install had applied the old sums);
sort-order and regex-escaped expectations in tests adjusted.
2026-10-06 01:47:40 +02:00

4.2 KiB
Raw Permalink Blame History

续接格式

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

核心结构

---

## ▶ 下一步

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

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

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

---

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

---

格式规则

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

变体

执行下一个计划

---

## ▶ 下一步

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

`/msd-execute-phase 2`

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

---

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

---

执行阶段中最后一个计划

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

---

## ▶ 下一步

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

`/msd-execute-phase 2`

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

---

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

---

规划阶段

---

## ▶ 下一步

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

`/msd-plan-phase 2`

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

---

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

---

阶段完成,准备下一步

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

---

## ✓ 阶段 2 完成

3/3 计划已执行

## ▶ 下一步

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

`/msd-plan-phase 3`

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

---

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

---

多个同等选项

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

---

## ▶ 下一步

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

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

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

**研究未知项:** `/msd-plan-phase --research-phase 3`

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

---

里程碑完成

---

## 🎉 里程碑 v1.0 完成

全部 4 个阶段已发布

## ▶ 下一步

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

`/msd-new-milestone`

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

---

拉取上下文

用于阶段(从 ROADMAP.md):

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

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

用于计划(从 ROADMAP.md):

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

或从 PLAN.md <objective>:

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

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

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

反模式

不要:仅命令(无上下文)

## 继续

运行 `/clear`,然后粘贴:
/msd-execute-phase 2

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

不要:缺少 /clear 说明

`/msd-plan-phase 3`

先运行 /clear。

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

不要:"其他选项" 措辞

其他选项:
- 审查路线图

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

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

/msd-plan-phase 3

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