JimLiu/baocut / skills/baocut
baocut
Flagged用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。
references/craft/design/references/craft.md
View on GitHub<!-- 由 tools/sync-agent-skill.ts 从 skills/baocut/built-in-skills/design/references/craft.md 生成,不要手改:改源文件后运行 npm run build:agent-skill -->
# 做好设计:完整版
SKILL.md 里是简短的规则;这里是它们背后的理由与细节。用户对某个设计决定有异议时读它,或者为了一件作品需要的具体章节来读:落地页的结构、wireframe 的轮次、手机原型(印刷品:print.md)。跨 family 的内容规则在文末;随附的品牌 kit 在 format.md 里说明。
## 做好设计(讲做法,不讲格式)
本文件末尾那些通用的内容规则(不加凑数的内容、加材料前先问、定点修改只改那一处、沿用已有设计的视觉语汇、AI slop 的俗套、受版权保护设计的规则)在设计稿上全部完整适用。下面讲的是设计本身特有的。
### 审美和用户一起定,不替用户定
用户没给审美、参考或设计系统时,先拿到他们的意见再定下来:问他们,或画 2–4 块真正不同、他们**看得到**的低保真方向画板;而不是自己挑一种审美(slop 就是这么来的)。一个具体的题材、asset 或品牌**就是**意见;没人可问时,定下一个叫得出名字的方向并说出来,而不是以一个问题收尾。决定一旦定下,就一直算数。然后定下一套小体系:
- 一组字体搭配:Google Fonts 能在 artifact 里加载(在 `<helmet>` 里放一个 `fonts.googleapis.com/css2?family=…&display=swap` `<link>`;别的 webfont 托管都不行);1–3 个 family,每个配一个 metrics 相近的系统 fallback(字体加载期间,以及无法嵌入该字体的地方,显示的是它;导出 PNG/PDF 时会嵌入链接的 Google Fonts)。
- 前景/背景:一种色调(暖、冷、中性);白与黑都带一点微妙的色调(白色饱和度低于 0.02)。
- Accent:0–2 个,用 oklch,chroma 和 lightness 相同、hue 不同。优先用品牌或设计系统的颜色;太受限时,从它们派生出协调的 oklch 颜色,而不是另外发明新色。
### 没有品牌或设计系统约束时
设计的作品**不**受现有品牌或设计系统约束时,用这份指引,并在动手前定下一个**大胆**的审美方向:
- **目的**:这个设计解决什么问题?谁在用它?
- **基调**:选一个极端:极致极简、极繁混乱、复古未来、有机/自然、奢华/精致、俏皮/玩具感、editorial/杂志、brutalist/原始、art deco/几何、柔和/粉彩、工业/实用,等等。拿这些找灵感,但设计出一个忠于这个审美方向的作品。
- **差异化**:什么让它**令人难忘**?别人会记住的那一点是什么?
大胆的极繁和精致的极简都行,关键在于有意为之,而不在于用力多猛。然后精准执行:
- **字体排印**:选美观、独特、有趣的字体。避开 Arial、Inter 这类泛用字体;选有辨识度、有个性的。用一款有辨识度的 display 字体搭配一款精致的正文字体。
- **颜色与 theme**:定下一种统一的审美。主导色配鲜明的 accent,胜过畏手畏脚、平均分配的配色。
- **动效**:设计里带动画时(画板里的 CSS),集中在高冲击力的时刻:一次精心编排的 reveal,比零散的微交互更让人愉悦。
- **空间构图**:出人意料的 layout。不对称。重叠。斜向流动。打破 grid 的元素。大片留白,**或者**有控制的密集。
- **背景与视觉细节**:营造氛围和纵深,而不是默认用纯色:gradient mesh、噪点纹理、几何图案、层叠的透明、戏剧化的阴影、装饰性边框、grain overlay。
在浅色与深色 theme、不同字体、不同审美之间变换,**绝不**在多次生成之间收敛到同样的选择。实现的复杂度也要和审美构想相称:极繁的设计需要繁复的效果;极简的设计需要克制、精准,并仔细处理间距和细微之处。
### Anthropic 品牌的作品
底色用 Ivory #FAF9F5,文字用 Slate #141413,Clay #D97757 作 accent,衬线 display 字配无衬线正文(确切的 font stack 在品牌颜色页和字体排印页上)。设计里带有 Claude 或 Anthropic 标志时:Claude Spark 每个 surface 只出现一次,绝不旋转、变形或放进 lockup;Claude logo 在浅色上用深色、在深色上用浅色,留出 clearspace,保持原始宽高比;Claude 与 Anthropic 的标志先后出现,绝不合在一起。
### 高保真 mockup 扎根于上下文
好的高保真设计不是从零开始的,而是扎根于已有的设计上下文:用户的代码库或仓库、品牌 asset、现有产品的截图、附上的设计系统。设计之前先花时间拿到这些上下文,找不到就向用户要。从零开始 mock 一整个产品是**最后的手段**,会做出糟糕的设计。尽早说明你的假设、上下文和设计思路,一有能让用户回应的东西就拿给用户看。
没有某个图标、asset 或组件时,画一个 placeholder:在高保真设计里,placeholder 好过把真东西做砸。
### 画布上的 variation 与备选
多画板的设计稿就是为探索备选而生的,要有意识地用它:
- 方向上的决定还没定时(整体方向、hero layout、字体搭配、配色取向、密度),在做完整交付物**之前**先定下来。给出 2–4 个真正不同的候选,每个探索一条你说得出名字的维度(「Warm editorial」对「Dense data-first」):同一种审美的五种深浅根本算不上选择。做决定所需的保真度不等于交付物的保真度:低保真的草图画板就足以选定方向。
- 在你的回复里(不是在画板上)给每个备选一个如实的动机和它的主要取舍:一组备选里只有你最喜欢的那个有人替它说话,那是一场做过手脚的投票。
- 备选的名字保持稳定:一块画板一旦叫「Option B」或「Warm editorial」,就一直是这个身份;绝不在不同轮次之间给备选重新编号或改名。
- 方向定了、用户想要可以留用的 variation 时,在几个维度上给至少 3 个:既有照章办事、符合现有 pattern 的设计,也有新颖的交互、layout、隐喻和视觉风格;重新组合品牌的视觉 DNA(scale、填充、质感、节奏、层叠、字体处理)。目标是用户可以自由搭配的原子化 variation,而不是那个完美的选项。
- 早期探索时画 wireframe:广度优先于精细,每个想法 3–5 种不同做法,简单形状、placeholder 文字、尽量少的颜色:草图式、低保真,专注于结构和流程。
### 经得起直接拖改的 layout
强烈优先用带 `gap` 的 flex/grid,而不是 inline flow。成组的兄弟元素(按钮、chip、图标、卡片、导航项、工具栏)用 `display: flex`/`grid` 加 `gap:` 来排,而不是让行内兄弟元素靠源码里的空白或逐个元素的外边距隔开:gap 的间距经得起直接操作的编辑(拖动重排、删除、复制,以及编辑器的 drag-out 与 wrap-in-flex 工具),空白文本节点经不起。inline flow 用于成段的文字,句子里偶尔夹一个 `<a>`/`<strong>`/`<em>`,不用于排布 UI 元素。多借助现代 CSS:`text-wrap: pretty`、CSS grid 以及其他高级效果都是你的好帮手。
### 合适的 scale
在生成的 **mockup** 内容里(手机屏画板里的按钮和列表行;不是 appifact 编辑器自己的 chrome,那个有它自己的规则),hit target 绝不应小于 44px。印刷画板的正文字号最小 12pt;任何设计里的文字都应按它实际的观看距离来定字号。
### 画出来就无障碍
即使是静态 mockup,也用真正的元素画控件:`<button>`、`<a href>`,以及配上 `<label>` 的 `<input>`。带 `role` 或 `onClick` 的 div 或 span 看起来一样,但 Tab 键会跳过它,读屏软件也没有东西可读。只有图标的按钮要加 `aria-label`。文字与它背后内容的 contrast 至少 4.5:1(24px 起为 3:1)。最常不达标的是说明文字的灰色,以及白字下面的彩色填充:两者都调深。必须区分开的颜色在 lightness 上也要不同,不能只靠 hue;优先用蓝/橙,而不是红/绿。
### 落地页与营销画板
按营销页的结构来搭:一个 hero,用一句话说清提供什么,配一个明确的 call to action;访客能信得过的证明(用户评价、客户 logo、数字:取自用户的材料,或用显眼标出的 placeholder);回答访客真实疑虑的利益点区块,而不是罗列功能。每页一个主要行动,在页面往下重复出现,而不是三个互相争抢的按钮。
对落地页来说,copy 就是产品。写具体的 copy,扎根于用户告诉你的东西:他们的产品、他们的客户、他们的口吻。绝不用 lorem ipsum,绝不写「欢迎访问我们的网站」,绝不写套在哪家公司身上都成立、可以互换的营销套话。缺少真实信息时(价格、日期、地址),放一个显眼标出的 placeholder,比如 [YOUR PRICE],让用户来填;不要编造。
落地页是 **PAGE**,不是固定尺寸的画板:它的 canvas.json entry 写 `"expand": "fill"`,根元素是 fluid 的(根上不写 px 宽度,用带左右内边距的 `max-width` 容器,用 %/rem/fr,grid 在手机上收成一列),这样在全窗口视图里它按窗口宽度来 layout(在画布上则按 `w`)。高度:在画布上 `100vh` 就是 frame 的 `h`,所以 `vh` 只用于占满整屏的根元素(仪表盘或 web app shell);后面还跟着内容的区块(如 hero)用 `px`/`rem` 的 `min-height`,绝不用 `vh`;根元素高度绝不用 `%`:声明了 `$preview` 时,它的父元素没有设定高度,`height: 100%` 会塌缩到内容高度。frame 的 `w`/`h`(以及 `$preview`)只是它在画布上的尺寸:把 `h` 设成页面在宽度 `w` 下的高度,否则画布会把它裁掉(宁可过高,也别被裁)。行内样式里的 `repeat(N, minmax(0, 1fr))` 在任何宽度下都保持 N 列,所以页面的 grid 用 `repeat(auto-fit, minmax(min(<min>px, 100%), 1fr))`,`<min>` 最多为宽度 `w` 下一列的宽度(算上 gap);`min()` 让手机上的单列可以窄于 `<min>`,而不是溢出。仪表盘、web 应用界面和滚动式讲解页也一样。固定尺寸的根元素只用于固定格式:device mockup、海报、印刷品(包括备忘录和报告:`print.md`)、社交媒体配图。写的时候就按手机宽度来设计:标题不要断得难看,grid 不要被挤扁,文字不要小到看不清。
### 印刷的做法
海报、传单、宣传册、备忘录、报告,任何以 PDF 形式交出去的东西:在画第一块画板之前读 `print.md`(就在本文件旁边)。
### 手机原型
不画假的 chrome:**不要**画假的 iOS 状态栏(那条「9:41 · 电池 · Wi-Fi」)或假的虚拟键盘。在真手机上,真的状态栏和键盘会渲染在你的 layout 上面:画上去的假货看起来会重复一层,显得幼稚。那块空间别动。桌面端的 device-frame 画板里也一样:手机矩形里不画假的状态栏。
### 复刻已有界面
用户要求复刻一个你能拿到源码的界面时(一份仓库 checkout、贴过来的文件、附上的设计系统),从真实源码来做,而不是凭你训练数据里对这个应用的记忆:先看看有什么,读组件和样式,把页面实际加载的 asset 复制过来(图标、字体、图片、样式表;不是只给 bundler 用的组件源码)。确切的数值(内边距、圆角、字号、行高)从源码里照抄;绝不四舍五入,也不吸附到 4/8-px grid 或框架默认值。比起截图,Claude 更擅长根据代码和设计上下文来复刻和编辑界面:有源码时,截图只当作高层次的参考。读不到源码时,停下来说明,而不是凭记忆编造。(至于到底要不要复刻,由共用的受版权保护设计规则决定。)
## 所有 appifact family 共用的内容与设计规则
<!-- The block between the shared:* markers below is generated from
skills/_shared/content-design.md by scripts/inline-shared.ts — edit the
fragment and re-run it; hand edits here fail scripts/shared-inline.test.ts. -->
<!-- shared:content-design -->
这些规则针对的是写进 appifact 的**内容**(幻灯片、画板、仪表盘、预置的卡片和行),而不是它的 chrome(kit、工具栏、文档机制)。它们适用于每一个 family(各 family 的 skill 会在此之上加上自己的做法),而且没有一条会改变 kit 的规则。
- **不要加凑数的内容。** 绝不为了填满空间,用 placeholder 文字、假区块或资料性内容去充实设计。每个元素都应该配得上它的位置。某个区块显得空,那是要用 layout 和构图解决的设计问题,而不是靠编造内容。每一个「要」背后,都有一千个「不要」。避开「data slop」:没用的数字、图标或统计。少即是多;偏向极简。
- **加材料前先问。** 你觉得再加一些区块、页面、copy 或内容会让设计更好时,先问用户,而不是自作主张加上。用户比你更了解他们的受众和目标。
- **定点修改只改那一处。** 用户要求一个小的、定点的修改时(某段文字、一个颜色、一个元素),**只**改那个:其他所有 layout、间距、外边距、字体、尺寸、位置、颜色和内容都原封不动;不要重新设计或「改进」你没被要求碰的部分。重新设计、换新方向或从零开始的请求是另一回事:那时就做他们要求的大改动。你觉得更大范围的改动对一个小请求有帮助时,先完成他们要求的,再**建议**其余部分,而不是不经要求就动手。
- **沿用已有设计的视觉语汇。** 在已有的界面或文档上添加内容时,先理解它的视觉语汇,然后照着来:匹配 copywriting 风格、配色、语气、hover/click state、动画风格、阴影 + 卡片 + layout pattern、密度,等等。
- **避开 AI slop 的俗套:** 包括但不限于:滥用渐变背景、emoji(除非明确是品牌的一部分)、带圆角和左边框 accent 色的容器,以及被用滥的 font family(Inter、Roboto、Arial、Fraunces)。内容里的 emoji:只有品牌或设计系统用它时才用。(Appifact 的 chrome 更严格:绝不用 emoji 当 UI glyph,这条没有前提条件。)
- **从源码复刻,不凭记忆或截图。** 被要求复刻一个你能拿到源码的界面或设计时(仓库、贴过来的文件、附上的设计系统),读真实的源码并据此来做,而不是凭你训练数据里对这个应用的记忆:读组件和样式,复制设计实际用到的 asset,照抄确切的数值(内边距、圆角、字号、行高),而不是四舍五入或吸附到 4/8-px grid 或框架默认值。比起截图,Claude 更擅长根据代码和设计上下文来复刻界面;有源码时,截图只当作高层次的参考。
- **不要复刻受版权保护的设计。** 被要求复刻某家公司有辨识度的 UI pattern、专有的命令结构或带品牌的视觉元素时,你必须拒绝,除非用户的邮箱域名表明他们在那家公司工作。转而去理解用户想做什么,帮他们做出原创设计,同时尊重知识产权。(BaoCut 会话里没有账号邮箱域名这个信号,所以这取决于用户告诉你他们在哪里工作;不清楚时就问。)
<!-- /shared:content-design -->
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |