更新日志片段 是做什么的?
明确的用户指令优先于此工作流程。仅在授权的产品和示例数据上工作。 不要请求密码、API 密钥、支付数据、政府标识符、健康记录或其他敏感数据。 在将缺少的本地依赖安装到工作项目之前,先解释它们。网络访问仅限 授权产品及其许可资产,以及声明的 npm 依赖;遵守访问控制。 一次只渲染一个任务,并等待其完成。将发布、发送和部署保留在此任务之外。
一个原生面板,一个操作,其保持的结果,然后是一个宣布的 Demo 重置。保持摄像机固定,并在整个面板周围留出均匀的边距。在构建之前阅读 style.md,在评判之前阅读 critique.md。
输入和设置
首先阅读发布说明并检查工作产品。只收集他们无法提供的内容:要宣布的变更、演示 URL 或本地应用、安全的示例数据、品牌/字体文件以及请求的尺寸。版本一涵盖可见的 Web 应用变更。对于仅限 API 的变更,请保留而不虚构仪表板。不要仅仅因为即将推出的预览而宣布某个功能已发布。
检查 Node 20+、ffmpeg 和 Chrome(scripts/chrome.mjs 或 CHROME_PATH)。在工作项目中安装 puppeteer-core@^24(它在 Node 20 上运行;更新的主要版本可能需要更新的 Node)。下面的 SKILL_DIR 是包含此文件的文件夹。
mkdir -p changelog-clips
cp -R "$SKILL_DIR/reference" changelog-clips/film
cp -R "$SKILL_DIR/scripts" changelog-clips/scripts
cp -R "$SKILL_DIR/music" changelog-clips/music
cd changelog-clips
npm init -y
npm install -D 'puppeteer-core@^24'
为每个变更创建一个单独的影片文件夹;reference 是外观控制,而 examples/compare-matching-stays/ 显示了一个原生列表。在研究了它们的格式后,移除复制的捕获,并用此产品的捕获替换它们。如果存在,移除复制的 out/ 文件夹。保持每个影片自包含。在后续版本中,重用品牌和未更改的片段;仅重新捕获已更改的操作。
产品和故事
编写 PRODUCT.md,包含实际产品、品牌、数据权限以及每个发布声明的来源。编写 STORY.md,每个片段一个条目:稳定的 ID、发布来源/日期、标题、之前状态、可访问的路由、实际控件/操作、保持的结果、重置方法、捕获边界和预期的播放策略。每个独立的片段必须在其自己的发布文本上下文中合理。不要将两个变更合并到一个时间线中。
使标题与演示的完成状态一致:选择一个回放点并非执行回放,预览已解析的日程并非保存它。当这是实际结果时,说“选择…”或“预览…”;不要将发布的更广泛声明用于更狭窄的演示。
在提交变更之前,测量其完整的原生组件和决定性的结果文本(在实际观看尺寸下)。在故事中记录 CSS 尺寸、文本大小和得到的 358px 尺寸。请求两个片段并不意味着存在两个合适的变更。保留不兼容的项目并说明原因;切勿将其作为精美的电话/社交媒体片段交付并附带小字免责声明。如果存在一个合适的、有其他文档记录的变更,则选择它。当请求了多种形状且用户未指定变更名称时,在做出选择之前,针对每种请求的形状测量每个有文档记录的候选者,并优先选择其完整组件能适配所有请求形状的候选者;仅当没有候选者能适配所有形状时,交付部分家族。如果都不适合,则返回产品限制,而不虚构 UI 或降低下限。
一个组件可能只适配某些形状。在 clip.json 的 heldShapes 中声明每个不支持形状及其测量原因(例如 {"4:3":"原生结果为 10.7 px(在 358 px 处);下限为 12"})。painter、preflight 和 exporter 会忽略该保持的形状,同时检查并交付兼容的形状。manifest 会将其标记为 partial;突出报告每个缺失的请求形状。部分家族并不代表通过了三形状测试。如果每个形状都被保持,则交付测量结果/报告,而非电影。
除非用户要求无人值守工作,否则展示该计划以供审查。默认为 1200×900 横屏、1080×1080 方形和 1080×1350 竖屏。这些是独立的构图,而非一个电影的裁剪。一个简短的静态发布标题位于社交媒体上的 UI 之外;横屏片段使用相邻的发布文本。
捕获和适配
- 找到一个包含操作及其结果的完整原生卡片或面板。在捕获前检查其原生窄布局。在 358px 的观看宽度下,更改的标签、值或结果必须大约为 12px 或更大。如果完整组件无法满足此要求,选择应用实际拥有的紧凑视图,或报告限制。切勿为影片重新绘制或重新设置其样式。
- 复制/适配
film/plans/capture.json及其capture-setup.mjs。设置其 URL、视口、选择器、示例设置和inspect证据。在rects.before中记录piece和target,并在结果之后再次记录。捕获整个表面的before、hover、pressed、changed(仍悬停)和result(指针移除)。使用真实的鼠标按下/释放,以便应用提供其自己的按下状态。在捕获前运行node scripts/centring.mjs film/plans/capture.json --no-crawl。 - 运行
node scripts/screens.mjs film/plans/capture.json film/captures。对于应用自身的 CSS/Web 动画帧,使用animate。包含足够大的边界以适应最大的原生范围;捕获工具在操作前测量该区域。对于即时操作,短暂的显式duration会记录带有found: []的证据:立即切换整个捕获。对于捕获工具无法搜索的 JS 驱动运动,提供确定性的原生录制;切勿用淡入淡出或由静态图片组装的运动来替换它。 - 将产品许可的字体复制到
film/fonts/,设置film/clip.json并运行node scripts/build-clip.mjs film film/clip.json。选项如下所示。它从captures/screens.json派生整个表面的几何形状、光标目标和原生帧绑定,采样原生背景,写入config.js并运行每个形状的原生尺寸检查。失败则保留该项目:在导出前停止。在使用每个捕获之前进行审查。提供的 reference 已经有其配置,因此重新构建是可选的。
{
"id": "new-view", "title": "你的发布标题", "kind": "panel",
"paper": "#F7F4EE", "ink": "#17191F", "groundSource": "你批准的调色板或采样的应用程序界面",
"radius": 20, "clearOnExit": true, "primaryTextPx": 24,
"font": {"family": "ProductSans", "file": "fonts/product.woff2", "weight": "300 900"}
}
primaryTextPx 是决定性的结果文本的测量原生 CSS 大小,而非由影片虚构的目标。paper 来自此产品,而非上面的示例。radius 是组件的原生半径(以 CSS 像素为单位)。clearOnExit 保持悬停状态,直到指针离开真实目标。适配这些字段和 config.js 中可选的 timing 对象;保留 film.js 中的固定相机、整个表面绘制器。原生动画帧以其捕获的 fps 播放。如果操作时间较长,稍后移动光标离开和重置,以便操作完成并且稳定的结果至少阅读一秒钟;reference 留下了超过四秒。不要截断实际处理或将排队的请求描绘为已完成。
保持静止指针远离关键标签。优先选择可见的控件本身作为 rects.target;对于一个
带标签的行,clip.json 可以设置 "targetFraction": [0.72, 0.5] 以在该实际点击区域内选择一个清晰点
(默认为 [0.5, 0.5])。适配 capture-setup.mjs 以在按下/释放前将真实鼠标移动到该目标边界框的相同分数。
捕获和影片必须使用相同的点;仅移动绘制的指针会歪曲原生按下。在解码的电话宽度操作帧中检查它。
审查和交付
node scripts/render.mjs film --all --check --check-fresh --stress --phone --times key --sheet --review --out film/out
node scripts/export-clips.mjs film
这些交付命令会完成。对于无人值守工作,等待两者都完成,完成审查并报告导出的
film/out/index.html 播放器和媒体路径。交互式预览是一个供人工使用的编辑工具:
node scripts/preview.mjs film 启动一个持久服务器,直到用 Ctrl-C 停止。只在有人使用它时运行它;
切勿将其附加到无人值守的前台交付/检查命令之后。
export-clips.mjs 首先检查每个形状,并在影片检查失败时拒绝新的视频导出。然后它渲染静音 30 fps H.264 MP4、VP9 WebM 和结果 PNG 到 film/out/。其可选的 --poster <seconds> 选择一个稳定的结果(默认为 3.5)。它写入一个包含相邻上下文、暂停/播放和减少运动处理的本地播放器。影片的重置有标签;它不是无缝的产品周期。保留静态结果海报用于减少运动。标签在重置前出现并保持可见直到结束;也要检查解码的最后一帧和第一帧。
阅读每个全尺寸的 UI 变更条带、悬停/按下/释放和每个形状中的重置;在这些事件处检查解码的 MP4 帧。用 critique.md 评分,然后如果可能,找一位新的审阅者。修复源文件并仅重复受影响的检查。没有低于 8 的分数;在两次失败的修正轮次后,报告剩余的缺陷而非隐藏它。压力检查涵盖绘制的文字,因此分别在 358 px 处检查捕获的原生文本。
交付可编辑的影片,包含所有本地捕获/字体和许可证、MP4/WebM/海报路径、发布字幕、来源声明、重建命令以及包含分数和限制的 REVIEW.md。打开完成的 MP4 进行审查。目标是横屏片段小于 1 MB,首先保持可读性;报告实际字节数和经过时间。
默认循环是静音的。music/README.md 解释了包含的可选 AI 生成歌曲(选定版本 A)。切勿替换为合成的乐谱。提供的或选择的歌曲使用内置适配器;保留静音导出以供嵌入。
不变规则
- 仅限真实产品捕获和用户自己的/示例数据。没有虚构的 UI、升起的矩形、文本补丁、状态间的交叉淡入淡出或假处理。
- 完整的原生包围盒、均匀的相反边距、固定比例和摄像机。没有额外的点击波纹或设备模拟。
seek(t, values)仅从参数绘制;ctx.reset()每一帧,CPU 支持的主/辅助画布,准备的本地图像。绘制器中没有时钟、随机调用、定时器或网络。- 每个影片单词都是
template.fields的一个条目。关键的原生文本必须独立于绘制的副本压力检查。 - 重置绝不能假装撤销购买、发送或不可逆操作。使用显式标记为示例状态的重置,或播放一次并保留实际结果。
Ostlery 是为 omnigami 的示例而创建的虚构公司。
此技能属于 omnigami,© 2026 Auberon LLC。你可以将由此技能生成的内容用于任何用途, 包括商业工作,并修改此技能供自己使用;但不得重新分发或出售此技能。 完整条款:LICENSE.md