# UI 品牌规范

面向用户的 GSD 输出的视觉模式。编排器通过 @ 引用此文件。

## 阶段横幅

用于主要工作流过渡。

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 GSD ► {阶段名称}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

**阶段名称（大写）：**
- `QUESTIONING`（提问）
- `RESEARCHING`（研究）
- `DEFINING REQUIREMENTS`（定义需求）
- `CREATING ROADMAP`（创建路线图）
- `PLANNING PHASE {N}`（规划阶段 {N}）
- `EXECUTING WAVE {N}`（执行波次 {N}）
- `VERIFYING`（验证）
- `PHASE {N} COMPLETE ✓`（阶段 {N} 完成）
- `MILESTONE COMPLETE 🎉`（里程碑完成）

---

## 检查点框

需要用户操作。62 字符宽度。

```
╔══════════════════════════════════════════════════════════════╗
║  CHECKPOINT: {类型}                                          ║
╚══════════════════════════════════════════════════════════════╝

{内容}

──────────────────────────────────────────────────────────────
→ {操作提示}
──────────────────────────────────────────────────────────────
```

**类型：**
- `CHECKPOINT: 需要验证` → `→ 输入 "approved" 或描述问题`
- `CHECKPOINT: 需要决策` → `→ 选择: option-a / option-b`
- `CHECKPOINT: 需要操作` → `→ 完成后输入 "done"`

---

## 状态符号

```
✓  完成 / 通过 / 已验证
✗  失败 / 缺失 / 阻塞
◆  进行中
○  待处理
⚡ 自动批准
⚠  警告
🎉 里程碑完成（仅在横幅中）
```

---

## 进度显示

**阶段/里程碑级别：**
```
进度: ████████░░ 80%
```

**任务级别：**
```
任务: 2/4 完成
```

**计划级别：**
```
计划: 3/5 完成
```

---

## 生成指示器

```
◆ 正在生成研究员...

◆ 并行生成 4 个研究员...
  → 技术栈研究
  → 功能研究
  → 架构研究
  → 陷阱研究

✓ 研究员完成: STACK.md 已写入
```

---

## 下一步区块

始终在主要完成后。

```
───────────────────────────────────────────────────────────────

## ▶ 下一步

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

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

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

───────────────────────────────────────────────────────────────

**也可选：**
- `/gsd-alternative-1` — 描述
- `/gsd-alternative-2` — 描述

───────────────────────────────────────────────────────────────
```

---

## 错误框

```
╔══════════════════════════════════════════════════════════════╗
║  ERROR                                                       ║
╚══════════════════════════════════════════════════════════════╝

{错误描述}

**修复方法:** {解决步骤}
```

---

## 表格

```
| 阶段 | 状态 | 计划 | 进度 |
|------|------|------|------|
| 1    | ✓    | 3/3  | 100% |
| 2    | ◆    | 1/4  | 25%  |
| 3    | ○    | 0/2  | 0%   |
```

---

## 反模式

- 变化的框/横幅宽度
- 混合横幅样式（`===`、`---`、`***`）
- 横幅中缺少 `GSD ►` 前缀
- 随机 emoji（`🚀`、`✨`、`💫`）
- 完成后缺少下一步区块