关于 develop-design-rationale
用于记录 UX 设计决策依据的技能，帮助设计团队整理背景、约束、备选方案、评估标准、取舍及后续事项。
主要功能
- 01概述设计决策
- 02记录背景与约束
- 03比较考虑过的备选方案
- 04说明评估标准和决策理由
- 05记录取舍与后续事项
适用场景
- 01为设计评审做准备
- 02解释多个可行 UX 方案中的选择
- 03帮助新成员了解既有设计决策
- 04重新审视过往决策的理由
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/develop-design-rationale确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
HISTORY.mdevals/trigger-fixtures.jsonreferences/EXAMPLE.mdTEMPLATE.md详细介绍
设计决策依据
设计决策依据文档记录设计决策背后的“原因”，包括促成特定解决方案的背景、限制条件、考虑过的替代方案和推理过程。设计本身展示了构建了什么，而决策依据文档则保留了为什么这样构建的组织知识。
适用场景
- 做出会影响用户体验的重要 UX 决策时
- 设计评审前，为利益相关方讨论做准备
- 存在多种可行方案，且需要说明选择理由时
- 帮助新团队成员了解现有设计决策时
- 重新审视以往决策，了解当初的推理过程时
- 推进设计系统演进，记录模式选择时
不适用场景
- 决策涉及架构或技术选型 -> 使用
develop-adr（Nygard 格式） - 需要就整体解决方案方向与利益相关方达成共识 -> 使用
develop-solution-brief - 记录的是探索发现，而非决策 -> 使用
develop-spike-summary - 决策很容易撤销且影响较小：编写决策依据文档会增加流程负担；改为在 PR 或工单中记录理由
说明
收到编写设计决策依据文档的要求时，请按以下步骤操作：
-
说明决策 先用一句清晰的话概括已做出的设计决策。它将作为文档标题和参考要点。
-
描述背景 说明促成这项决策的情况。你要解决什么问题？有哪些限制条件？哪些用户需求影响了方向？请纳入相关研究发现。
-
列出考虑过的方案 记录至少 2-3 个经过评估的替代方案。针对每个方案，描述其具体形式和主要特点。公正地呈现所有方案，避免树立稻草人。
-
定义评估标准 指明评估方案的依据：可用性启发式、技术可行性、品牌契合度、用户研究发现、业务需求或设计原则。
-
说明推理过程 逐步说明为何选定方案最符合评估标准。明确权衡取舍：获得了什么，又牺牲了什么。说明该决策是否可逆。
-
记录接受的权衡 每项设计决策都有权衡。指出舍弃了什么，以及为何可以接受。坦诚说明有助于后续团队了解相关限制。
-
记录后续考量 记录日后需要关注的事项：需要监测的指标、可能需要重新审视决策的条件，或需要做出的相关决策。
输出格式
使用 references/TEMPLATE.md 中的模板组织内容。完整的决策依据文档应填写模板中的每个部分：决策摘要；背景；考虑过的方案；评估；决策依据；接受的权衡；可逆性；后续考量；支持材料；以及决策历史。
质量检查清单
定稿前，请确认：
- 用一句话清晰说明决策
- 背景说明了“为何是现在”以及相关限制条件
- 公正地记录了多个替代方案
- 明确列出了评估标准
- 推理说明了为何选定方案优于其他方案
- 坦诚地承认了权衡取舍
- 继承这项设计的读者无需询问他人，就能还原选定方案胜出的原因
示例
请参阅 references/EXAMPLE.md 中的完整示例。