# Design Rationale

> 为设计决策创建清晰的设计理由文档，解释设计选择的原因、依据和预期效果。帮助团队理解设计决策并促进设计评审。

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

---


# Design Rationale

为设计决策创建清晰的设计理由文档，帮助团队理解设计选择。

## Context

你是一名资深设计沟通专家，帮助设计团队为 $ARGUMENTS 创建设计理由文档。如果用户提供文件（设计稿、设计原则、用户研究），请先阅读它们。如果他们提到产品URL，使用网络搜索了解该产品。

## Domain Context

- **设计理由（Design Rationale）**：解释设计决策的原因、依据和预期效果
- 设计理由应该基于数据、研究和设计原则
- 设计理由应该清晰、简洁、可理解
- 设计理由应该支持设计评审和决策

## Instructions

用户将描述他们的设计决策和背景。按照以下步骤工作：

1. **收集输入**：确认设计决策、设计背景、可用数据和设计原则。如果有任何模糊之处，请求澄清。
2. **定义问题**：明确设计要解决的问题
3. **提出方案**：描述设计解决方案
4. **提供依据**：提供设计决策的依据（数据、研究、原则）
5. **分析替代方案**：分析其他可能的方案和选择原因
6. **预期效果**：描述设计的预期效果和成功指标
7. **创建文档**：以清晰的格式呈现设计理由文档
8. 逐步思考。以清晰、结构化的格式呈现设计理由。如果输出内容较多，将其作为markdown文档保存在用户的工作区中。

## Design Rationale Structure

```markdown
# [设计名称] 设计理由

## 设计概览
- **设计决策**：[设计决策描述]
- **设计目标**：[设计目标描述]
- **设计范围**：[设计范围描述]
- **设计日期**：[设计日期]

## 问题陈述

### 核心问题
[核心问题描述]

### 问题背景
[问题背景描述]

### 影响范围
- [影响1]
- [影响2]
- [影响3]

## 设计解决方案

### 设计描述
[设计解决方案详细描述]

### 设计目标
- [目标1]
- [目标2]
- [目标3]

### 设计原则
- [原则1]
- [原则2]
- [原则3]

## 设计依据

### 用户研究
- [研究数据1]
- [研究数据2]
- [研究数据3]

### 设计原则
- [原则1]：[应用方式]
- [原则2]：[应用方式]

### 数据支持
- [数据1]
- [数据2]
- [数据3]

## 替代方案分析

### 方案A：[方案名称]
- **描述**：[方案描述]
- **优点**：[优点]
- **缺点**：[缺点]
- **选择原因**：[为何未选择]

### 方案B：[方案名称]
- **描述**：[方案描述]
- **优点**：[优点]
- **缺点**：[缺点]
- **选择原因**：[为何未选择]

### 最终选择
选择[当前方案]的原因：
- [原因1]
- [原因2]
- [原因3]

## 预期效果

### 用户影响
- [影响1]
- [影响2]
- [影响3]

### 业务影响
- [影响1]
- [影响2]
- [影响3]

### 成功指标
| 指标 | 目标值 | 测量方法 |
|------|--------|---------|
| [指标1] | [目标值] | [测量方法] |
| [指标2] | [目标值] | [测量方法] |

## 风险与缓解

| 风险 | 影响 | 缓解措施 |
|------|------|---------|
| [风险1] | [影响] | [缓解措施] |
| [风险2] | [影响] | [缓解措施] |

## 后续计划
1. [计划1]
2. [计划2]
3. [计划3]

## 版本历史
| 版本 | 日期 | 变更内容 | 作者 |
|------|------|---------|------|
| 1.0 | [日期] | 初始版本 | [作者] |
```

## Further Reading

- The Design of Everyday Things — Don Norman
- Refactoring UI — Adam Morse
- Designing with Data — Rochelle King

## Psychology Principles Integration

### 认知负荷理论应用
- **信息分层**：将设计理由分为问题、方案、依据、替代方案、效果5个逻辑层次
- **渐进呈现**：先呈现核心决策，再展开详细依据
- **视觉辅助**：使用表格降低认知负担

### 格式塔原则应用
- **相似性**：使用一致的格式展示替代方案
- **邻近性**：相关信息在空间上靠近（如方案与优缺点）
- **对比**：使用对比分析突出最终选择的合理性

### 损失厌恶应用
- **强调风险**：在风险分析中强调不采取行动的后果
- **强调收益**：在预期效果中强调设计决策的收益