# 规格文档

> 来自7位产品领袖的10条洞察。如何撰写有效的规格和设计文档。

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

---


# 规格文档

## 何时使用此技能

当你需要：
- 撰写功能规格文档
- 创建技术设计文档
- 定义产品交互细节
- 在团队间传达设计意图

## 核心原则

### 1. 原型优于静态文档
高保真原型对于评估产品的"感觉"和可行性至关重要，这是静态设计无法做到的。

### 2. 低保真促进协作
白板上的低保真绘图比高保真线框图更快、更协作。

### 3. 每次交互都珍贵
移动端设计需要极致效率，因为用户注意力高度碎片化，每次交互都是潜在的跳出点。

## 专家洞察

### Nikita Bier
> "移动应用上的每次点击对你作为产品开发者来说都是奇迹，因为用户会很快转向并跳到下一个应用...你获得的每一次点击，每一次都是如此稀缺，你应该优化一切。"

**核心洞察**：移动端设计需要极致效率，因为用户注意力高度碎片化，每次交互都是潜在的跳出点。

**如何应用**：
- 优化用户流程中的每一次点击，确保它提供即时价值
- 观察用户与手机的交互来理解应用切换的频率

### Ryan Singer
> "塑造会议的产出是...某种绘图或图表，工程师、产品和设计都在看着它说，'我们理解这个。我知道要去构建什么。'"

**核心洞察**：一个好的规格是一个低保真图表，提供技术和功能的清晰度而不过度指定 UI 细节。

**如何应用**：
- 瞄准一个团队能看到"墙里的电线"（技术可行性）的详细程度
- 确保规格描述解决方案的"运动部件"（通常不超过 10 个）

### Tamar Yehoshua
> "我从他那里学到最多的是原型的力量。尽管他是如此出色的产品思考者，他总是会说，'我不能告诉你这会不会成功。我必须感受它。我必须尝试它。一个 mockup 不能告诉你它的感觉是什么。'"

**核心洞察**：高保真原型对于评估产品的"感觉"和可行性至关重要，这是静态设计无法做到的。

**如何应用**：
- 推动使用真实数据的原型来真正测试用户体验

### Christina Wodtke
> "我发现如果我在白板上画得很差...其他人会说，'不不不，不是那样的。把这支笔给我'，然后开始画。这能让你非常快地达到共同愿景...我知道设计师花很多时间做线框图，我觉得那是最无聊的..."

**核心洞察**：白板上的低保真绘图比高保真线框图更快、更协作。

**如何应用**：
- 在白板上"画得很差"来邀请其他人参与并纠正愿景
- 在早期设计讨论中使用简单的形状（方块、圆圈）来表示复杂系统

### Noah Weiss
> "我们不再花那么多周期在静态 mockup 或演练的设计探索上，而是说，'我们能多快进入真实软件中原型化这个路径，即使它很乱、你会扔掉它'...你必须生活在软件中、触摸它、闻它。你不能只是看着它。"

**核心洞察**：优先在代码中进行高保真原型，而非静态设计 mockup，以更好地理解软件的实际感觉。

**如何应用**：
- 尽快从静态 mockup 转向真实软件原型
- 使用"乱糟糟的"一次性代码来尽早测试交互的"感觉"

## 常见错误

- 过度依赖静态 mockup 而非可交互原型
- 在早期阶段花太多时间在高保真线框图上
- 忽视每次交互在移动端的珍贵性
- 规格过于详细导致限制了实现灵活性

## 关键战术

| 战术 | 说明 |
|------|------|
| **画得很差** | 用低保真绘图邀请协作 |
| **真实数据原型** | 用真实数据测试体验感觉 |
| **运动部件** | 规格聚焦不超过 10 个核心组件 |
| **一次性代码** | 用可丢弃的原型快速验证 |

## 相关技能

- [[01-北极星指标-north-star-metrics|北极星指标]]
- [[02-产品愿景-product-vision|产品愿景]]
- [[03-路线图优先级-roadmap-prioritization|路线图优先级]]
- [[04-OKR目标设定-okrs-goals|OKR目标设定]]