1155c7564e
- Add language switch link to root README - Translate README.md to docs/zh-CN/README.md - Translate USER-GUIDE.md to docs/zh-CN/USER-GUIDE.md - Translate all 13 reference documents to docs/zh-CN/references/ Key terminology mappings: - context engineering → 上下文工程 - spec-driven development → 规格驱动开发 - context rot → 上下文衰减 - phase → 阶段 - milestone → 里程碑 - roadmap → 路线图 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4.1 KiB
4.1 KiB
续接格式
完成命令或工作流后展示下一步的标准格式。
核心结构
---
## ▶ 下一步
**{标识符}: {名称}** — {单行描述}
`{可复制粘贴的命令}`
<sub>`/clear` 优先 → 全新上下文窗口</sub>
---
**也可选：**
- `{备选项 1}` — 描述
- `{备选项 2}` — 描述
---
格式规则
- 始终展示它是什么 — 名称 + 描述，绝不仅仅是一个命令路径
- 从源文件拉取上下文 — ROADMAP.md 用于阶段，PLAN.md
<objective>用于计划 - 命令用内联代码 — 反引号，易于复制粘贴，渲染为可点击链接
/clear说明 — 始终包含，保持简洁但解释原因- 用"也可选"而非"其他选项" — 听起来更像应用
- 视觉分隔符 — 上下用
---使其突出
变体
执行下一个计划
---
## ▶ 下一步
**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）：
### 阶段 2: 认证
**目标**: 带刷新令牌的 JWT 登录流程
提取：**阶段 2: 认证** — 带刷新令牌的 JWT 登录流程
用于计划（从 ROADMAP.md）：
计划:
- [ ] 02-03: 添加刷新令牌轮换
或从 PLAN.md <objective>：
<objective>
添加带滑动过期窗口的刷新令牌轮换。
目的: 在不影响安全性的前提下延长会话生命周期。
</objective>
提取：**02-03: 刷新令牌轮换** — 添加带滑动过期的 /api/auth/refresh
反模式
不要：仅命令（无上下文）
## 继续
运行 `/clear`，然后粘贴：
/gsd:execute-phase 2
用户不知道 02-03 是关于什么的。
不要：缺少 /clear 说明
`/gsd:plan-phase 3`
先运行 /clear。
没有解释原因。用户可能跳过。
不要："其他选项" 措辞
其他选项：
- 审查路线图
听起来像是事后补充。用"也可选："替代。
不要：用围栏代码块展示命令
/gsd:plan-phase 3
模板内的围栏代码块会造成嵌套歧义。用内联反引号替代。