Agent Skills
› barefootford/buttercut
barefootford/buttercut
GitHub视频素材分析工作流，生成音频转录、接触表和摘要。通过防止休眠和进度追踪管理处理流程，协调WhisperX等工具完成媒体数据处理。
Install All Skills
npx skills add barefootford/buttercut --all -g -y
Skills in Collection (16)
视频素材分析工作流，生成音频转录、接触表和摘要。通过防止休眠和进度追踪管理处理流程，协调WhisperX等工具完成媒体数据处理。
需要批量处理视频库并生成元数据
执行媒体资产的分析与转录任务
npx skills add barefootford/buttercut --skill analyze-video -g -y
用于备份和恢复视频编辑器库文件。支持单库或全库备份，生成带时间戳的归档文件，并处理配置读取与用户交互。
用户请求备份库
用户请求恢复库
自动触发库备份流程
npx skills add barefootford/buttercut --skill backup-library -g -y
ButterCut主入口技能，用于欢迎用户并根据需求引导至剪辑、素材处理或杂项任务等子技能，实现意图路由。
用户打开 ButterCut
输入 buttercut 或 bc
询问如何开始或寻求帮助
npx skills add barefootford/buttercut --skill buttercut -g -y
从视频片段生成包含时间戳的网格联系表，支持自动选择帧数和旋转方向。
请求制作 contact sheet
请求生成 grid 或 film strip
需要视频片段的单图概览
npx skills add barefootford/buttercut --skill contact-sheet -g -y
用于初始化并创建新的 ButterCut 视频库。通过引导用户确认项目名称、素材路径、语言及转录校对偏好，完成设置文件的生成与库的脚手架搭建。
用户希望开始一个新的视频项目或库
需要初始化视频库的基本配置和结构
npx skills add barefootford/buttercut --skill create-library -g -y
用于从媒体库构建视频剪辑（如场景、粗剪、脚本编辑等）。首先确认库状态，引导用户选择剪辑类型，随后生成对应的YAML配置以完成时间线搭建。
用户请求构建 'roughcut'
用户请求创建 'scene' 或 'selects'
用户要求基于剧本进行 'edit'
npx skills add barefootford/buttercut --skill cut -g -y
将库中所有片段的对话转录合并为一个文本文件，方便用户获取完整脚本或台词。
请求完整转录本
请求完整脚本
需要库中所有对话
npx skills add barefootford/buttercut --skill full-transcript -g -y
处理无法归入核心工作流的单次生产任务，如提取帧、转录音频或生成文件。明确小文件存库、大文件存桌面或临时目录的规范，并指导对不支持功能的探索性尝试及临时脚本创建。
用户请求不属于核心剪辑流程的一次性任务
需要执行文件转换、数据提取或非原生支持的探索性操作
npx skills add barefootford/buttercut --skill misc-task -g -y
负责视频库的处理流程，包括定位现有或新建库、添加新素材以及执行转录、联系表和摘要等分析任务。支持断点续传和增量处理，协调底层分析技能完成媒体内容解析。
用户需要分析新的视频库
用户希望恢复或继续处理现有的视频库
用户向现有库添加新素材并需进行分析
npx skills add barefootford/buttercut --skill process-library -g -y
用于检测 ButterCut 自身故障并生成匿名 Bug 报告。自动过滤用户隐私数据，根据用户授权偏好决定是否发送错误详情至开发团队，确保仅上报技术故障而非业务内容。
ButterCut 命令失败且疑似软件自身错误
用户明确要求 'report this'、'send a bug report'、'tell the ButterCut team' 或 'this is broken'
npx skills add barefootford/buttercut --skill report-bug -g -y
将旧版视频分析库迁移至新版流程，重置视觉层并重建联系表与摘要，保留音频转录及剪辑数据。
用户希望将旧版处理过的媒体库升级至新的视觉分析管道
需要重新生成联系表和摘要以更新视觉元数据
npx skills add barefootford/buttercut --skill reprocess-with-contact-sheets -g -y
处理用户的功能建议或新特性请求。通过检查现有功能、撰写包含标题和背景的规范描述，经用户确认后发送至开发团队，旨在收集产品改进意见并促进需求落地。
用户希望软件具备当前未提供的功能
用户提出改进建议或新功能想法
npx skills add barefootford/buttercut --skill request-feature -g -y
用于 Mac 环境自动检查并安装 ButterCut 依赖（Homebrew、Ruby、Python 等），支持简单和高级两种安装路径，完成安装后验证状态并询问错误报告偏好。
用户说 'install buttercut'
用户说 'set up my mac'
用户说 'get started'
用户说 'first time setup'
用户说 'install dependencies'
用户说 'check my installation'
npx skills add barefootford/buttercut --skill setup -g -y
基于 WhisperX 转录视频音频，生成带词级时间戳的 JSON 字幕。支持并行处理与多语言配置，为后续视频分析提供数据基础。
需要生成视频音频转录文本
需要提取带时间戳的词级字幕
npx skills add barefootford/buttercut --skill transcribe-audio -g -y
自动更新 ButterCut 软件版本，处理 Git 状态重置、依赖安装及变更摘要。支持 Core/Pro 版差异，确保视频编辑器环境干净并保留库文件。
用户请求检查或安装 ButterCut 最新版本
需要重置工作区并同步上游代码
npx skills add barefootford/buttercut --skill update-buttercut -g -y
ButterCut应用的入口技能，用于欢迎用户并引导其选择新剪辑、添加素材或执行其他任务，通过路由到对应子技能完成操作。
用户输入 buttercut 或 bc
用户询问如何开始或寻求帮助
npx skills add barefootford/buttercut --skill bc -g -y
