# Design Brief Builder

> 为 0→1 产品或产品变更将主观审美词、品牌线索与使用场景转化为有理由、可验证的 UI 设计决策，产出并维护 Design-Brief.md。仅在需要新增或改变视觉/交互规则时使用；不用于恢复既有视觉行为的维护任务。

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

---


# 设计规范技能 (design-brief-builder)

## Purpose

把“高级、简洁、现代”等主观表达转成可实施、可验证且有场景理由的视觉与交互规则。

## Trigger

- 0→1 产品需要建立视觉或交互规则。
- 产品变更需要新增或改变既有视觉、品牌或交互规则。
- 现有 Product Spec 已足以说明产品目标、用户和核心场景。

恢复既有视觉行为属于维护路线，不重新定义风格。

## Required context

- 相关可验收需求，来自现有 Spec、等价文件或用户明确确认。
- 用户、场景、平台和使用环境。
- 用户给出的风格词、品牌线索、截图、参考产品或反例。
- 已有 Design Brief 或设计系统（如果存在）。

## Workflow

1. 先解释主观词在当前产品语境中的具体含义。
2. 存在多种合理方向时，给出 2～3 个差异明确、含理由与代价的候选方向，只追问当前最关键的选择。
3. 将选定方向写成“设计意图 → 决策 → 参数 → 理由/代价 → 验证检查点”。
4. 只更新本次受影响的视觉、交互与可访问性，不为局部改动重做完整设计。
5. 原位更新已有设计规范，标记旧决定替代关系，联动相关需求和活跃任务；不创建重复副本。

## Output

- 已确认设计事实、临时假设和待确认项。
- 被选择及被放弃的方向与原因。
- 可执行的设计变量、关键状态和验收检查点。
- `docs/Design-Brief.md` 或项目约定的等价文件。

## Stop or escalate

- 产品目标或相关行为仍不可验收时补齐需求；已有明确选择时不因缺少同名 Spec 文件阻塞。
- 设计选择会改变产品范围或业务流程：升级为产品变更。
- 参考图未说明喜欢或排斥的具体点：最多追问一个高信息量问题。
- 多个风格要求互相冲突且无法建立临时假设：停止并请求选择。

## References

执行前读取 [stage-contract.md](references/stage-contract.md)。