JimLiu/baocut / skills/baocut
baocut
Flagged用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。
references/craft/design-system/references/craft.md
View on GitHub<!-- 由 tools/sync-agent-skill.ts 从 skills/baocut/built-in-skills/design-system/references/craft.md 生成,不要手改:改源文件后运行 npm run build:agent-skill -->
# 写好设计系统:规则
SKILL.md 里有检查清单;这里是清单背后的规则。设计系统存在,是为了让后来的 agent 能在这个品牌的基础上构建——从品牌的**真实**来源(代码库、附带的文件、演示文稿、规范)来写它。
- **README 是写给使用它的 agent 看的用法规则**——页面把它显示成品牌手册。用祈使句,**点名** token、样式和素材(「正文用 `body`;`surface-100` 上用 `ink`;Clay 只用于 Claude 自己的声音」)。不写标题(页面会显示设计系统的名字),不写出处、构建笔记或「下一步」——这些写在你的回复里。篇幅随来源而定:只丢来几个文件的,写几条要点;真实的代码库或指南,值得分章节写,配上品牌自己的例子——content fundamentals(语气、大小写、用「我」还是「你」、用不用 emoji;引用真实的 copy)、visual foundations(颜色、字体排印、间距、图像、动效、state、边框、阴影、圆角、layout)、iconography(用哪套图标系统、格式、emoji 还是字形)。绝不注水。
- **素材是复制来的,绝不仿造。** 来源里没有标志 ⇒ 用普通文字排出名字,并注明没有标志;绝不凭记忆画出或复原一家真实公司的标志,绝不用用户没提供的 identity 给品牌改头换面。复制品牌自己的图标(图标字体、sprite、SVG);如果确实拿不到,换成最接近的替代品,并在 Iconography 下**标注**出来。
- **来源决定清单。** Token:来源里真实的名字和值,按它的顺序。组件:恰好是来源定义的那些 family——不加「常见」的额外组件(Toast、Avatar……),除非列在「Intentional additions」下并写明理由;只有从零开始或只有规范文字的品牌才配一套标准组件。先列出**完整**清单,对照它跟踪,全部构建;如果中途停下,确切报告还剩什么并询问——绝不在没做完的情况下悄悄结束。
- **值要精确,取自真实来源。** 来源胜过任何与它相像的组件库(shadcn、MUI……);内边距、圆角、尺寸和行高都照抄——5px 就是 5px,不要吸附到 grid 上。代码是事实,截图是有损的参考;预览是复刻,绝不另起炉灶。如果读取中途失败,说明你读了什么、没读什么——绝不编造名字、结构或值。
- **每个值只有一个来源。** 清理时,进了 `tokens.json` 的值要从预览加载的样式表里**删掉**,这样在页面上改的值才能胜出;页面不会用同一个 `--name` 声明的,保留。这等于重做样式表,别人写的样式表也不例外:先把它的旧版本整份挪到一边(见下文「挪到一边」)。页面只在有人保存时才写 `tokens.css`:设计系统自己没有 `tokens.css` 的,第一份由你来写,按 `format.md` 里「编译出的 tokens.css」那一条的样子排,第一行是 `/* <title> — generated from tokens.json */`(页面只接管第一条注释以这几个词结尾的文件)。如果设计系统的组件把自己包在一个声明了 tokens 的元素里,页面上的值就进不到里面:它们的值照样写进 `tokens.json`,什么都不删,并告诉用户在页面上编辑不会改变那些预览。
- **不留过时的 `manifest.json`。** 清理时**删除**旧的 `manifest.json`,绝不重写它:它列的是已经不存在的路径,而在有人保存一次编辑之前,页面不会写新的。
- **别人做的东西挪到一边。** 清理只删除设计系统顶层的旧 `manifest.json`、`migration-map.json` 和 `publish-progress.json`;在其他任何路径上叫这些名字的文件都是别人的。其他任何文件离开它的路径只能靠**移动**:**一次**改动,把文件写到一个空闲路径(那里没有文件,也没有别的文件写到那里),内容与你最后一次读到的完全一致(复制它,绝不重新敲一遍),并删除旧路径。原样去往 `format.md` 给它的位置的文件,就移到那里。本来你要删掉的文件(你拆分或重做的卡片,不论它在原处还是在去往它位置的途中;一个展示颜色、字体排印、间距或圆角 specimen 的 HTML 页面)要**挪到一边**,挪到 `archived/` + 它在设计系统里的路径。样式表也一样,在从中提取值之前整份挪开:**一次**改动把旧文件挪到一边,并在它的路径上写新文件。在 `README.md` 里修好路径,删掉迁移时在末尾追加的那一节(「## Migrated from …」),然后补充;其他内容一律不删、不改写。不要留下任何仍链接到你已清空路径的保留文件;迁移自己在 `assets/notes/`(或 `docs/`)下的笔记既不移动,也不改指向。
无法移动的文件(没有空闲路径;你的工具不能删除文件)留在原处:点名列出。`archived/` 里原有的东西绝不移动,也绝不提议删除。specimen 页面只有在它展示的每个颜色、尺寸和 `--name` 都已经以相同的值进了 `tokens.json` 之后,才挪到一边(在 specimen 页面里搜 `#`、`rgb`、`hsl`、`lch`、`lab`、`px`、`em`、`%` 和 `var(--`)。展示标志或图标的 HTML 页面不算 specimen 页面:把它重做成 `components/<Comp>/preview.html` 处的预览,然后像其他卡片一样把旧页面挪到一边。保留的文件仍链接着的文件绝不挪开,除非有新文件占用它的路径,或者那些链接已改指向。
- **每个 token 和素材都有用法说明**,写明它用在哪里(只用一种 ink 的 SVG,说明里要点名它的 ink——`<img>` 继承不了颜色)。
- **在每个 theme 里都清晰可读。** 文字颜色的用法说明要点名它所在的底色(「`surface` 和 `surface-raised` 上的正文」),每一对这样的组合在**每个** theme 里都至少达到 4.5:1 的 contrast(WCAG 2;24px+ 或 19px+ 粗体的文字,以及任何承载含义的边框、焦点环、图标或其他标记为 3:1)——要检查后面几个 theme 的值,不只是第一个 theme 的。组件预览和 `bundle.css` 画出来的东西也要达到同样的下限。你自己选的颜色(从零开始的品牌、预览自己的样式、焦点环)直接达标就行:把 accent 调亮的 dark theme,上面通常要用深色文字,所以给这样的填充色一个 `on-…` token,而不是写死白色;你选的焦点环要做成实色,在它落到的每个 surface 上都至少 3:1,并写在 visual foundations 下。真实来源里不达标的配对保持原样——在它的说明里讲明,而不是悄悄给品牌换色。
- **无障碍方面的要求有固定含义。** *high-contrast theme* 是一个**新增**的 theme,绝不是给品牌自己的 theme 换色:每种文字颜色在它的说明点名的底色上至少 7:1(24px+ 或 19px+ 粗体的文字为 4.5:1;WCAG AAA),surface 和控件靠达到 3:1 的边框区分开,而不是只靠 shade。*色盲安全的 status 颜色*:每种 status 还要带一个词或图标,成功和危险绝不能是只靠色相区分的一绿一红——要么两者之间的明度相差至少 3:1,要么成功色离开红绿轴、偏向蓝色(普通绿色旁边配一个橙色的危险色不算)。真实来源里不满足这一点的绿和红保持原样:安全的那一对放进品牌自己 theme 旁边的一个**新增** theme 里,就像 high-contrast theme 那样,并在它们的用法说明里写明哪个 theme 是安全的。没有需要保留的品牌色相 ⇒ 从 Okabe & Ito 的配色出发,用作文字的地方调暗。对这两者之一的*检查*,要在改动任何东西之前,按 theme 列出不达标的配对,每一对附一个修改建议。这是每种要求单独出现时的含义——用户的明确指示优先于这些定义,真实来源自己的颜色保持原样,如上所述。本 skill 的 [`references/sample-seazar-tokens.json`](sample-seazar-tokens.json) 是这一切的 worked example(看它的 tokens)。
- **使用指南写明使用方要提供什么**(props、children、容器、数据),以及什么时候用它、该做和不该做的事。
- **填进真材实料:**每个 theme 凡与其他 theme 不同的地方都要填上,type scale 接到品牌真实的字体文件上,每个组件都有实时预览**和** README。
- **避免 AI 套路**,除非来源里真的有:蓝紫色渐变、拿 emoji 当装饰、带彩色左边框 accent 的圆角卡片、凑数的统计数字、用烂了的字体(Inter、Roboto……)。不要凑数的内容;有针对性的改动就保持有针对性;绝不为不在某家公司工作的人复刻这家公司的专有界面。
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 |