# Design State

> 维护共享的设计状态文档，记录设计决策、开放问题、工件索引和交接链。所有设计agent在开始工作前读取状态，完成后更新状态。

- Skill: `wanghaisheng/design-state` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wanghaisheng/design-state`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wanghaisheng/design-state/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wanghaisheng (https://skillmd.com/u/wanghaisheng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wanghaisheng/design-state

---


# Design State

维护共享的设计状态文档，记录设计决策、开放问题、工件索引和交接链。

## Context

你是一名设计运营专家，帮助设计团队维护设计状态文档。如果用户提供设计状态文件，请先阅读它。如果不存在，需要初始化一个新的设计状态。

## Domain Context

- **设计状态（Design State）**：一个共享的、活的设计文档，随着工作流程的进展累积设计决策
- 设计状态是设计当前状态的单一事实来源
- 每个设计agent在开始工作前读取设计状态，完成后更新设计状态
- 设计状态记录决策、开放问题、工件索引和交接链

## Instructions

用户将描述他们的设计工作需求。按照以下步骤工作：

1. **检查设计状态**：确认设计状态文件是否存在（`design-state.md`）
2. **读取当前状态**：如果存在，读取当前的设计状态
3. **更新设计状态**：根据设计工作更新相应部分
4. **记录决策**：将新的设计决策添加到决策日志
5. **更新工件索引**：更新工件索引中的文档状态
6. **记录交接链**：记录agent之间的交接信息
7. **创建文档**：以清晰的格式呈现设计状态文档
8. 逐步思考。以清晰、结构化的格式呈现设计状态。如果输出内容较多，将其作为markdown文档保存在用户的工作区中。

## Design State Structure

```markdown
# Design State: [项目名称]

_最后更新：[日期] by [agent名称]_

## 简报
- **问题**：[一行问题描述]
- **主要用户画像**：[名称和背景]
- **成功指标**：["完成"的定义]
- **简报文档**：[完整简报的相对路径]

## 用户画像
[链接到用户画像文档]
- [画像1名称] — [一行背景]
- [画像2名称] — [一行背景]
- ...

## 设计原则
1. [原则] — [实践中的含义]
2. [原则] — [实践中的含义]
3. ...

## 品味配置
- **情感目标**：[2-3个词 - 如"平静自信"、"温暖有趣"]
- **质量级别**：[原型 / 生产 / 旗舰]
- **关键参考**：[名称/URL]
- **美学原则**：[列表]
- **品味文档**：[完整品味配置的路径]

_如果没有进行品味校准，注明："无品味配置 - 工艺评估仅使用通用质量标准。"_

## 决策日志
仅追加。每个条目记录谁决定、什么、为什么。

| 日期 | Agent | 决策 | 理由 |
|------|-------|------|------|
| [日期] | design-strategist | 底部标签导航，3个项 | 根据原则#1最小化认知负荷 |
| [日期] | design-lead | 薄荷/薄荷调色板，类别颜色编码 | 温暖、亲切、通过AA对比度 |
| ... | ... | ... | ... |

## 开放问题
需要解决的事项。解决后移除（将决策移至日志）。

- [ ] [问题 - 谁需要回答它]
- [ ] ...

## 工件索引
工作流程中产生的关键文档路径。

| 工件 | 路径 | 状态 |
|------|------|--------|
| 简报 | [路径] | 已批准 |
| 用户画像 | [路径] | 完成 |
| 策略 | [路径] | 完成 |
| 计划 | [路径] | 进行中 |
| 启发式评估 | [路径] | [待定/完成] |
| 合成测试结果 | [路径] | [待定/完成] |
| ... | ... | ... |

## 设计债务登记
从批评、无障碍审查、启发式评估和合成用户测试中推迟的发现。由 `design-debt-tracker` 管理。

_项目：0 | 关键：0 | 最旧：—_

| ID | 日期 | 来源 | 严重性 | 内容 | 受影响者 | 建议修复 | 状态 | 备注 |
|----|------|--------|--------|------|----------|----------|--------|-------|

## 交接链
追踪哪个agent交接给哪个。每个条目包含agent在交接时编写的对话消息。这些消息显示给用户。

### [时间戳] design-strategist → design-lead
> "核心用户是有新小狗的家庭，8-14岁的孩子主导。原则#1说'庆祝努力，而非完美' - 所以不应该感觉像成绩单。设置流程需要渐进式披露。交给你进行视觉方向。"

### [时间戳] design-lead → motion-designer
> "我选择了毛玻璃卡片和薄荷/薄荷绿调色板。进度环是英雄时刻 - 当达到100%时需要感觉像庆祝，而不仅仅是颜色变化。其他地方保持微妙。"

**🎨 用户覆盖**："使用我现有的设计系统代替薄荷/薄荷绿。tokens在 /tokens/colors.json。"

### [时间戳] motion-designer → design-builder
> "进度环获得600ms弹簧填充。复选框获得150ms弹跳。减少运动后备方案切换到不透明度淡入淡出。"

### [时间戳] ...
```

## Rules

1. **每个agent在开始前读取设计状态** - 如果不存在，有问题。回到发现阶段
2. **每个agent在完成时追加到决策日志** - 未记录的决策没有发生
3. **永不从决策日志中删除** - 它是仅追加的。如果决策被反转，添加一个新条目来取代它
4. **开放问题仅在解决时移除** - 解决方案进入决策日志
5. **交接链是强制性的** - 每个agent到agent的转换都记录了传递的内容和需要注意的事项
6. **保持可扫描性** - 这个文件将被每个agent读取。使用表格和单行，而非段落

## 初始化

首次创建设计状态时（在发现之后）：

1. 在项目根目录创建 `design-state.md`
2. 从批准的设计简报填充简报部分
3. 如果用户画像存在，填充用户画像
4. 如果已完成策略，填充设计原则
5. 从已做出的任何决策开始决策日志
6. 添加任何已知的开放问题
7. 使用简报路径启动工件索引

## Agent工作后更新

当agent完成其工作时：

1. 读取当前设计状态
2. 将新决策追加到决策日志（包含日期、agent名称、决策、理由）
3. 解决已回答的任何开放问题
4. 添加出现的任何新开放问题
5. 使用生成的任何新文档更新工件索引
6. 编写交接消息（2-4个对话句子，写给下一个agent）
7. 将消息添加到交接链 - 这显示给用户
8. 更新"最后更新"行

## Further Reading

- Design Systems Handbook — Alla Kholmatova
- Design Ops Handbook — Dave Malouf
- Building Design Systems — Alla Kholmatova

## Psychology Principles Integration

### 认知负荷理论应用
- **信息分区**：将设计状态分为简报、用户画像、原则、品味配置、决策日志、开放问题、工件索引、交接链8个逻辑组块
- **表格格式**：使用表格降低决策日志和工件索引的认知负担
- **追加模式**：决策日志采用追加模式，避免覆盖历史

### 格式塔原则应用
- **相似性**：使用一致的格式展示决策日志条目
- **邻近性**：相关信息在空间上靠近（决策与理由）
- **连续性**：使用时间线展示决策的连续性

### 损失厌恶应用
- **保留历史**：决策日志永不删除，保留设计历史
- **追踪债务**：设计债务登记追踪未解决的问题，避免遗忘