一句话创建 Skill：把达芬奇 OGraf 约定说全，再用对话越用越聪明

你好，我是果子坤（kernelKun）。

目标是：第一句话就把你已经想清楚的项目约定、创建规范、契约说清楚，让智能体据此创建 Skill；缺的、不确定的，继续提问补齐。 建好之后，你每用一次、每纠正一次，就让它把习惯写回菜谱——越用越聪明，这才是 Skill 真正值钱的地方。第一版不求一次完美。

本文面向基础用户，案例始终是：创建一个能生成达芬奇 OGraf 模板的 Skill。约定结构可参考同类 OGraf 创作规范（目录、开发/生产、检查器透出、画布与回写进化）；路径与脚本由你改，不要照抄某仓库内部私有路径。

本文状态（骨架）

主线：一句话建 Skill → 按约定生成模板 → 对话自我进化
已含：可复制「超级第一句」、契约清单、目录结构、进化话术
待补：截图、讲解视频、真实进化前后对比

你将看到

为什么第一句要说全（而不是一点点补）
一段可直接复制的「一句话创建」提示词（内含约定 + 规范 + 契约）
官方文档：帮助→文档→开发人员；Win/Mac 本机路径；如何拷进 references；模板工程放哪
建好后如何用后续对话让 Skill 自我进化
（可选）接到彩虹桥图形动画 / 蓝图工坊

一、用人话理解：Skill + 自我进化

Skill = 给智能体反复使用的做事菜谱。
自我进化 = 每次做完或被你纠正后，把新习惯写回菜谱，下次自动遵守。

只有「能生成」	真正好用的 Skill
每次都要重新交代尺寸、风格、禁区	第一句写进契约，以后默认遵守
错了只改这一次成品	错了还改菜谱，避免再错
人越用越累	菜谱越用越懂你

所以官网这篇要强调两件事：

创建时：一句话把约定说全
使用时：不断回写，越用越聪明

二、第一句要装进什么？（项目约定 × 创建规范 × 契约）

把它想成三层，最好挤在同一段话里：

1）项目约定（东西放哪）

Skill 放哪个目录
模板源码 / 封包分别放哪
分类怎么命名（例如：中文分类 + 英文技术文件夹名）
和官方 Developer 文档的关系（对照，不改系统目录原件）

2）创建规范（做成什么样）

参考实战里常用的 OGraf 规矩（写给人看的版本）：

默认生产模式（成片用）；只有要调试时才单独做开发版
画布固定像素排版（常见 1920 宽画布；主尺寸用 px，避免乱飘的 vw）
剪辑师要改的字和颜色，进达芬奇检查器；不要写死在代码里
进出动画写进约定：入场/出场（或持有段）、时长与检查器可调项；风格未定时先问或用活文档默认
开发版可以有调试面板；生产版不要留调试 UI
交付要有清单：源码一对文件（脚本 + 说明清单）+ 需要时的封包

3）项目契约（何时用、成功标准、非目标、要进化、要校准）

以后怎么一句话触发（例如：「按 OGraf 菜谱做一张促销价签」）
怎样算完成（达芬奇能改参见效、目录清晰、有清单）
明确不做：乱改时间线、绑未说明的内部工具、本版不做的类型
强制约定：每次任务结束后，把新的审美/文案/禁区写回「习惯活文档」
消费时校准：用菜谱做模板时，不确定就先问用户（动效、文案、颜色等），对齐后再做；稳定偏好写回活文档

官方 OGraf 开发文档在哪找？

推荐入口（Win / Mac 通用）： 打开达芬奇 Resolve → 顶部菜单 帮助 → 文档 → 开发人员（英文界面多为 Help → Documentation → Developer）。
从这里可以定位到本机的官方开发者文档库（含 OGraf HTML Templates）。

本机文件夹路径（只读参考，不要改原件）：

系统	OGraf 开发文档常见路径
macOS	`/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/OGraf HTML Templates`
Windows	`C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\OGraf HTML Templates`

若版本或安装方式不同导致路径略有差异，以菜单 帮助 → 文档 → 开发人员 打开的位置为准。创建 Skill 时可把该目录的 README 与 Documentation 拷进 references/official-ograf/。

背景图文：达芬奇21：OGraf 与 Lottie

三、直接复制：一句话（其实是一小段）创建 Skill

把下面整段当成第一句发给智能体。请先改掉两处【路径】占位再发送（或用下面的懒人默认）；已知约定尽量一次说全，缺的允许继续问。

操作协议（和「一句话创建」一起用）

一句话 = 信息一次给全，不是零确认。
允许合理默认 → 强制回述三句（触发时机 / 写入目录 / 本版不做）→ 你回「确认」或改路径后再落盘。
路径占位没改时：智能体只出草案，不要声称已写入你的项目。
官方 references 可先「待拷贝」，不阻塞先建 Skill。第一版先落菜谱与空活文档，模板样例可第二轮。

懒人路径（可直接写进第一句）： Skill 用项目下 .cursor/skills/make-davinci-ograf/；模板工程用项目下 ograf-templates/。

text

请为我创建一个「生成达芬奇 Resolve OGraf 模板」的 Skill（可复用菜谱）。
下面【项目约定 / 创建规范 / 契约】我已经说清的，请按操作协议：回述三句 → 我确认后再落盘；
还有不确定、互相冲突、或必须我拍板的，请继续提问，问清再写那一部分。
Skill 会在后面使用中不断优化，第一版先落菜谱与空活文档即可，不必假装一次完美。

【项目约定 · 目录】
- Skill 目录：【改成你的路径，或使用默认 项目/.cursor/skills/make-davinci-ograf/】
- 模板工程：【改成你的路径，或使用默认 项目/ograf-templates/】
  - 源码：源码或 src/ → <中文分类>/<技术名>/ → 技术名.js + 技术名.ograf.json
  - 封包：封包或 packed/ → <中文分类>/ → 技术名.ograf
  - 可选：分类登记表（中文分类 ↔ 技术名）
- 命名：中文分类给人看；技术文件夹用 PascalCase；清单里的显示名用简体中文
- 对照本机官方 OGraf Developer 文档（可用达芬奇「帮助→文档→开发人员」打开；macOS：`/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/OGraf HTML Templates`；Windows：`C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\OGraf HTML Templates`；只参考，不改系统原件）
- 将官方 README + Documentation（或中文要点摘录）放入 references/official-ograf/；也可先放「待拷贝」说明，不阻塞先建 Skill

【创建规范】
- 默认交付「生产模式」：无调试面板、无开发日志；需要调试时另做开发版
- 画布按 1920 固定 px 排版，主尺寸禁止用 vw 乱漂
- 剪辑师可能改的文案、颜色、开关必须进达芬奇检查器；禁止写死在代码里当唯一数据源
- 字体策略写进菜谱：未知则在活文档留占位，并问一句「检查器里能否改字体」；再按你的产品能力划分检查器 vs 预览宿主
- 【进出动画 · 须写入 Skill】默认需支持入场/出场（或循环持有段）；时长与 `animDuration` / 成片时长对齐写进约定；检查器可调「动画时长」等；用户未指定动效风格时先问清（滑入/淡入/弹入等）或采用活文档默认并回述；禁止只有静帧却声称有完整进出动画
- 创作前可参考公开 HTML/CSS 示例，但交付物不要写「参考来源」痕迹
- 交付清单写进 Skill：源码文件、封包（如需）、自检项

【项目契约】
- 触发话术：以后我说「按 OGraf 菜谱做××」就启用本 Skill
- 成功标准：目录符合约定；达芬奇时间线改检查器见效；有人话交付清单
- 非目标：不自动改时间线/工程；不绑未说明的内部路径；本版不做 Lottie 互转
- 自我进化（必须写入 Skill）：
  1. 每次接任务先读「习惯与风格」活文档
  2. 我纠正版式/文案/禁区后，交付末尾必须回写进活文档
  3. 只记可复用偏好，不写密钥、不写本机私密绝对路径到分享稿
- 【消费时校准 · 必须写入 Skill】以后每次用本菜谱做模板时：缺信息、互相冲突、或会影响成片的不确定点（文案、颜色、进出动画风格/时长、品类变体、是否封包等）必须先向用户提问对齐，再生成；不要靠猜测硬做。问清后的稳定偏好写回活文档。创建本 Skill 时同样遵守：已知约定落盘，未知继续问。
- 请生成：SKILL.md 主菜谱 + references（官方对照摘要）+ 习惯活文档（可先空白骨架）
- 先用三句话回述：触发时机、写入目录（未填路径则列出将用的默认并请我改）、本版不做；我确认后再落盘；之后可随使用继续改菜谱

为什么要「说全」，又允许继续问？

约定散落在聊天里容易丢，写进 Skill 的才算数——所以第一句尽量把已知约定说全。
但 Skill 是活的：缺信息、不确定、要你拍板时，智能体应该继续问；用起来后再回写优化，而不是第一版装完美。

占位：后补「粘贴第一句 → 生成文件夹」屏幕录像位。

四、Skill 目录怎么划分？（方便扩展 · 参考 · 自我进化）

可以，而且建议：把达芬奇官方 OGraf 参考文档拷贝或摘录进 Skill 的 references/（或 reference/），当本地教材。
系统里的 Developer/OGraf HTML Templates（见上表 Win/Mac 路径，或经「帮助→文档→开发人员」打开）只读对照，不要改原件；拷进 Skill 的是「给你和智能体随时打开的副本/摘要」。

每一层干什么（后期才不乱）

位置	放什么	不放什么
`SKILL.md`	短、可执行的主流程与契约	大段官方原文
`habits-and-style.md`	你纠正后沉淀的偏好（常改）	密钥、一次性临时候选
`references/`	官方拷贝/摘录、长规范、对照表（少改）	正在迭代的成品模板
`snippets/`	可粘贴的小例子	完整业务模板工程
`scripts/`	确定性能跑的脚本	「要不要这样做」的判断流程
`assets/`	说明用图	达芬奇时间线工程

官方文档怎么进 `references/`

第一句里可以直接加一句，例如：

text

请把本机「Developer/OGraf HTML Templates」里的 README 与 Documentation
拷贝（或整理成中文要点）到本 Skill 的 references/official-ograf/，
供以后生成模板时查阅；不要修改系统安装目录里的原件。

要点：

全量拷贝：查阅完整，目录大一些
摘录要点：体积小，适合分享；重要章节（接口 / 检查器 / 封包）不要省
无论哪种，SKILL.md 里写清：「生成前先读 references/official-ograf/…」

模板成品仍与 Skill 分开

text

ograf-templates/                    # 工程产物，不是 Skill 本体
  src/<中文分类>/<技术名>/
    <技术名>.js
    <技术名>.ograf.json
  packed/<中文分类>/
    <技术名>.ograf

Skill = 教怎么做 + 参考教材 + 习惯进化；工程目录 = 做出来的模板。 分开后，菜谱升级不会和成品文件搅在一起。

若智能体生成的结构和你第一句不一致，直接说：「按我第一句的目录约定改 Skill 并改文件夹」，让它改菜谱而不只改一次文件。

五、越用越聪明：自我进化怎么说？

创建只是起点；进化才是日常。 每次做完一条模板，用类似的话收尾：

text

这条已经确认：【例如 天气卡宽约 1280、圆角 36、主色偏天蓝、国内文案省略「中国」前缀】。
请写进本 Skill 的习惯活文档，并保证下次同品类默认遵守；不要只改这一次成品。

或纠正时：

text

不对：生产版不要底部调试信息。请修正当前模板，并把这条写进 Skill 禁区，以后默认生产模式禁止出现。

进化时建议遵守：

要写回	不要写回
版式默认、配色偏好、文案习惯、品类禁区	密钥、token、仅你本机的私密路径
「下次默认怎么做」	一次性的临时候选方案
失败原因 + 正确做法	情绪吐槽（可转成可执行禁区）

自检是否越用越聪明： 隔几天只说「按菜谱做一张同类卡」，它是否还要你重复讲尺寸和风格？如果不问了，说明进化生效。

六、日常使用：真正的「一句话」

Skill 建好并进化几轮后，日常可以短到：

text

按 OGraf 菜谱，做一张双十一促销价签，主色红，标题「整点抢」，生产模式。

若它又开始忘约定，不要只改成品，追加一句：

text

你漏了检查器透出/目录命名。改完后把这条补进 Skill，避免再漏。

七、（可选）接到彩虹桥

Skill 管规矩与进化；产品侧可选：

能力	文档
本机预览、改参、管理 OGraf/Lottie	图形动画
一句话生成再导入	蓝图工坊 · OGraf 图形生成

八、验收清单

[ ] 只用（一段）第一句话就生成了 Skill，目录符合你的项目约定
[ ] 菜谱里写清了：规范、契约、非目标、必须回写习惯
[ ] 按菜谱做出一条模板，达芬奇改参见效
[ ] 你纠正一次后，习惯被写回；下次同品类不必重讲
[ ] 没有依赖「每次手写整份 Skill」才能开工

九、视频建议分镜

粘贴第三节「超级第一句」
打开生成的 Skill 文件夹，指给观众看「习惯活文档」
做一张模板 → 达芬奇改参
故意纠正一条风格 → 要求写回 Skill
再下一句短指令，展示它已经记住

一句话创建 Skill：把达芬奇 OGraf 约定说全，再用对话越用越聪明

一、用人话理解：Skill + 自我进化

二、第一句要装进什么？（项目约定 × 创建规范 × 契约）

1）项目约定（东西放哪）

2）创建规范（做成什么样）

3）项目契约（何时用、成功标准、非目标、要进化、要校准）

官方 OGraf 开发文档在哪找？

三、直接复制：一句话（其实是一小段）创建 Skill

四、Skill 目录怎么划分？（方便扩展 · 参考 · 自我进化）

推荐划分（可扩展）

每一层干什么（后期才不乱）

官方文档怎么进 `references/`

模板成品仍与 Skill 分开

五、越用越聪明：自我进化怎么说？

六、日常使用：真正的「一句话」

七、（可选）接到彩虹桥

八、验收清单

九、视频建议分镜

延伸阅读

一句话创建 Skill：把达芬奇 OGraf 约定说全，再用对话越用越聪明 ​

一、用人话理解：Skill + 自我进化 ​

二、第一句要装进什么？（项目约定 × 创建规范 × 契约） ​

1）项目约定（东西放哪） ​

2）创建规范（做成什么样） ​

3）项目契约（何时用、成功标准、非目标、要进化、要校准） ​

官方 OGraf 开发文档在哪找？ ​

三、直接复制：一句话（其实是一小段）创建 Skill ​

四、Skill 目录怎么划分？（方便扩展 · 参考 · 自我进化） ​

推荐划分（可扩展） ​

每一层干什么（后期才不乱） ​

官方文档怎么进 references/ ​

模板成品仍与 Skill 分开 ​

五、越用越聪明：自我进化怎么说？ ​

六、日常使用：真正的「一句话」 ​

七、（可选）接到彩虹桥 ​

八、验收清单 ​

九、视频建议分镜 ​

延伸阅读 ​

一句话创建 Skill：把达芬奇 OGraf 约定说全，再用对话越用越聪明

一、用人话理解：Skill + 自我进化

二、第一句要装进什么？（项目约定 × 创建规范 × 契约）

1）项目约定（东西放哪）

2）创建规范（做成什么样）

3）项目契约（何时用、成功标准、非目标、要进化、要校准）

官方 OGraf 开发文档在哪找？

三、直接复制：一句话（其实是一小段）创建 Skill

四、Skill 目录怎么划分？（方便扩展 · 参考 · 自我进化）

推荐划分（可扩展）

每一层干什么（后期才不乱）

官方文档怎么进 `references/`

模板成品仍与 Skill 分开

五、越用越聪明：自我进化怎么说？

六、日常使用：真正的「一句话」

七、（可选）接到彩虹桥

八、验收清单

九、视频建议分镜

延伸阅读