设计研究：专业循环
工具：安装后使用
ddr <command>（python tools/ddr.py install），否则使用python <repo>/tools/ddr.py <command>，其中<repo>是该技能真实（符号链接解析后）文件夹上两级目录。
你在仔细审视过的地方设计得好，在其他地方则差。这个技能是你在为某个领域进行设计之前成为该领域专家的方法，也是让这种专业知识保持真实可靠的方式。输出不是情绪板，而是一个领域：一份你当前理解的档案、一个你真正看过的参考库，以及基于这些证据计算出的置信度分数。
不会改变决策的研究只是浏览。没有记录的研究等于丢失。两者都要做好，否则不要声称你做了研究。
0. 你的位置
ddr domain match "<一句话概括的需求说明>"
它会返回行业（业务或受众的类型）和模式（流程或界面：入门引导、结账、预订、定价、仪表板），并附带各自的置信度。然后运行 ddr domain plan <slug> --stakes low|medium|high：
| 投入级别 | 何时使用 | 目标分数 |
|---|---|---|
| 低 | 现有系统内的一个组件或调整 | 35 |
| 中 | 一个页面、一个流程、一个界面的重新设计 | 55 |
| 高 | 一个新网站、一个品牌、一次发布，任何评判业务的东西 | 70 |
如果达到目标，则阅读 ddr domain brief <sector> <pattern> 并返回设计主管。如果没有达到，则运行下面的循环直到达标，或者直到时间允许且你能清楚说明做到了什么程度。不要等待被询问。向用户说一句话：“独立住宿的置信度是12，所以我先研究这个类别（大约20个参考）。”
新领域
当没有领域匹配时，创建一个。选择参考能迁移的层级：养老院和牙科诊所都属于“医疗保健”，但它们的网站几乎毫无共同点，因此它们是不同的行业。两个领域的最佳参考如果会是同一个列表，那么它们就是一个领域。
ddr domain new independent-stays --kind sector --title "独立住宿" \
--summary "自助式小屋、客栈和直接销售的小型酒店" \
--keywords "自助式小屋,客栈,民宿,b&b,精品酒店,度假租赁" \
--aliases "短期住宿,度假租赁"
关键词是客户会使用的词，而不是设计术语。一个模式是跨行业出现并有自身最佳实践的东西；当需求说明以此为核心时创建它。关联相互影响的领域（ddr domain relate independent-stays booking --how "价格先于可用性"），合并两个实际上是同一个的领域（ddr domain merge <from> <into>，不会删除任何东西），拆分一个已经发展出两个受众的领域（通过创建第二个领域并移动属于它的参考）。
你的工具
按此顺序使用你拥有的最佳工具，并说明你使用了哪些：
| 任务 | 最佳工具 | 备用工具 |
|---|---|---|
| 根据描述寻找候选 | Exa MCP（ddr mcp --research 显示设置） | 你自己的网络搜索、目录 |
| 在某个地方或行业中寻找最佳独立作品 | Brave Search MCP 本地搜索和地点搜索 | 网络搜索 "best <行业> in <城镇>"、评论网站、奖项短名单 |
| 真实产品的截图和流程 | Mobbin 或 Refero MCP（付费） | 公开拆解、亲自走一遍流程 |
| 查看并测量一个参考 | ddr teardown <url> --into <slug> | Playwright 或 Chrome DevTools MCP，然后截图 |
| 安全地走一遍用户旅程 | ddr teardown <url> --walk "立即预订>检查可用性" | Playwright MCP，绝不提交任何内容 |
| 查看设计有多老 | ddr history <url>，然后拆解存档版本 | 网站自己的新闻或发布文章 |
| 并排比较 | ddr sheet --domain <slug> --with yours.png | ddr sheet a.png b.png c.png |
| 提取品牌标记 | Firecrawl MCP 的 branding 格式 | ddr teardown 测量的字体和调色板 |
ddr teardown 会保存桌面和手机的首屏、整页和滚动帧条带，并测量实时页面：根据文本量确定的字体及其大小、根据绘制面积确定的调色板、控件颜色、圆角、阴影、区块内边距、段落宽度、动效（过渡时间、滚动库、视频、画布、减少动效规则）、基础技术栈、导航、行动号召以及其是否位于首屏之上，还有生成式设计痕迹（占位文本、眉毛块、渐变色文字、毛玻璃效果、图标卡片三联组）。这些数字使你的评价变得具体。它们永远不能取代实际查看：打开图片。
1. 映射领域
在打开图库之前，先写下谁才是真正的最佳。一个类别中的最佳是那些在该行业中受人钦佩的企业、那些凭借声誉获胜的企业、以及那些其网站被该类别模仿的企业。通过三种方式找到它们：
- 直接（
--angle direct）：在该确切类别中最强的6到12个，包括市场顶端和那些明显做得好的小型独立企业。使用网络搜索、行业媒体、类别内的奖项短名单以及目录（ddr sources search "<category>" -v）。 - 领导者（
--angle leader）：在相邻类别中解决相同问题但面向更挑剔客户的最佳作品（例如，为小屋参考精品酒店集团，为信用社参考私人银行）。 - 外部（
--angle outside）：至少两个来自完全不同学科的作品，根据主题的世界选择（例如，印刷指南书、建筑专著、菜单、电影片头、标牌）。ddr sources shuffle -n 4会提供一揽子选择。
图库（Awwwards、recent.design、Land-book）是线索，不是证据。优先选择年奖和月奖，而不是每日精选。
2. 认真查看
一个参考的价值只取决于你实际看到了多少：
--evidence | 含义 | 权重 |
|---|---|---|
search | 你读过相关内容或看过缩略图 | 四分之一 |
visited | 你加载了实时网站并阅读了内容 | 一 |
screenshot | 你渲染了它并查看了桌面和手机上的像素 | 更多 |
flow | 你走了一遍真实的用户旅程（预订、注册、结账） | 最多 |
拆解每个重要的候选参考，并打开图片：
ddr teardown https://a.example https://b.example --into <slug>
查看首屏和滚动帧，而不仅仅是数字。对于两三个最佳参考，同时运行 ddr history <url>：一个看起来“新鲜”但设计来自2019年的参考现在可能已经变成了模板，而存档版本则显示了哪些手法是新的。尽可能地走一遍与需求说明匹配的用户旅程，但不要支付或提交任何内容。加载屏幕或Cookie墙不是设计；注意它们并看到它们背后。
如果某个网站的条款禁止自动化访问（目录中 agent_access = "scrape-no"），则以普通人的方式浏览它并记录为 visited。切勿将付费墙后的屏幕截图或他人的摄影作品复制到公共仓库中；截图保留在你的领域主目录中，该目录永远不会被发布。
3. 拆解并记录
对于每一个赢得其位置的参考，立即记录它，使用其 teardown.md 中的测量值：
ddr domain ref add <slug> --name "名称" --url https://... --verdict exemplar \
--angle direct --evidence screenshot --score 4 --shots shots/<host> \
--take "可用性日历是主角，每晚价格显示在每个日期旁边，使用15px的紧缩衬线字体" \
--avoid "自动播放的无人机视频将第一个有用屏幕延迟了4秒" \
--tags layout:calendar-hero,type:serif-condensed
--take 是具体手法，有数值（尺寸、颜色、时间、实际用词）时附上。“干净现代”不是手法。诚实评分：5分会改变你的设计方式，3分是扎实且典型的，任何你评2分的东西都不是典范。
4. 寻找低质量内容
找到3到5个反例（--verdict counter --avoid "..."）：该类别中的模板网站、看起来像生成式设计的东西、过时的东西。它们与范例同样有价值，因为它们展示了该类别的低质量内容具体长什么样，而设计主管中的SLOP.md只能笼统地描述。将模式写入档案的类别低质量内容部分。在该部分存在之前，置信度上限为60。
5. 撰写档案
打开 $(ddr domain path <slug>)/dossier.md 并根据你所看到的内容撰写每个部分，命名所引用的参考。要具体且有主见：
- 目标用户：谁在使用它，他们对什么感到焦虑，他们拿什么与之比较。
- 最佳者的做法：最佳者的共同手法，带有数值。
- 保留的惯例：用户依赖什么。将这些做得特别出色。
- 打破的惯例：这里哪些是懒惰或过时的，用什么替代。
- 类别低质量内容：该类别中生成式和模板化作品长什么样。
- 语言：属于这个世界的字体、颜色、图像、语气和动效，以及原因。
- 开放问题：你仍然不知道什么，以及什么能回答它。
6. 策展
ddr domain audit <slug> --online
它会标记出过时的（一年未查看）、薄弱的（仅搜索）、矛盾的（你评了2分的典范）、失效的、迁移的、或者全部来自一个角度或一个来源的参考。针对每个发现采取行动：重新查看（ddr domain ref seen）、重新评分、或者附上原因淘汰（ddr domain ref retire <slug> <id> --reason "2026年重新设计成模板"）。被淘汰的参考保留在坟场中，这样它们就不会被悄然重新添加。一个库的好坏取决于你愿意扔掉什么。
7. 比较，然后重新评分
制作该领域最佳参考的联系表（ddr sheet --domain <slug> --n 6），并将其作为一个集合来查看。如果它们看起来都一样，说明库已经收敛到一个想法上，下一次搜索应该寻找与之矛盾的参考。
8. 重新评分并决定
ddr domain status <slug>
它会显示分数、分数的每个部分、任何上限以及如何提高它。在最大的差距上重复循环，直到达到投入级别目标。然后告诉用户你的最终位置（一句“独立住宿现在是58分：查看了14个网站，4个反例，低质量内容已记录”），并返回设计主管的步骤1。
深度
根据投入级别调整工作量，并说明你做了什么：
- 低：4到6个参考，1个反例，一行低质量内容记录。几分钟。
- 中：来自所有三个角度的8到12个参考，3个反例，每个档案部分。一小时以内。
- 高：15到25个参考，在最佳3个上走过流程，4个或更多反例，2个外部参考，一次审计。需要多长时间就花多长时间。
项目仍然保留自己的简短台账在 .design/references.md：5到10个改变了这个项目决策的参考，每行一个，附上它改变了哪个决策。领域是你所知道的；项目台账是你所使用的。
规则
- 借用技术和原则，但绝不借用任何可识别的标志、照片、付费字体或专有插图。
- 记录失败的访问（付费墙、机器人墙、死链），而不是猜测后面是什么：
ddr domain log <slug> note "Revolut 阻止了渲染器和普通请求"。 - 绝不记录你没有实际查看过的参考为已查看。分数的存在是为了阻止你声称未能获得的专业知识；夸大分数违背了它唯一的用途。
- 当目录条目失效或错误时，用
ddr sources add修复它，并在那里添加优秀的新来源，这样下一个人就能从更高的起点开始。