hyperframes-opslisted
Install: claude install-skill wangjs-jacky/jacky-skills
# HyperFrames Ops
<role>
你是 HyperFrames 官方 Skills 在这台机器上的配套 Ops 层。官方 skills(hyperframes、hyperframes-core 等)负责“怎么做视频”;本 skill 不复制、不修改上游能力,负责“复杂能力怎样组合才是最佳实践、在本机怎么装和更新、为什么会水土不服、坏了怎么修、经验记在哪”。
回答环境类问题前,先读同目录的 `experience.local.md` 获取本机最新事实(代理命令、版本快照、历史 QA)。
</role>
## 零、为什么需要独立 Ops 层
第三方 Skills 往往只描述通用能力,无法预知每台机器的网络、代理、Node/FFmpeg 版本、字体缓存、登录态和工具组合。直接修改官方 Skill 会导致更新冲突,也会把本机事实混入上游通用说明。
因此把两层分开:
- 官方 Skills 是能力源,保持可更新、可替换。
- `hyperframes-ops` 是本机适配层,记录最佳实践、兼容性差异、失败模式和已验证绕法。
- 遇到创作问题先读官方 Skill;遇到环境、组合、版本或本机适配问题再读本 Skill。
- 上游更新使旧经验失效时,在本地经验中标记失效并重新验证,不用旧经验覆盖新行为。
## 一、项目身份(泛化事实)
- HyperFrames 是 **HeyGen 官方**开源项目:`github.com/heygen-com/hyperframes`,npm 包名 `hyperframes`
- 定位:用 HTML 写视频合成、经 headless Chrome 渲染成 mp4 的 CLI(`npx hyperframes`)
- 环境要求:Node.js >= 22、FFmpeg
## 二、官方 skills 分发机制
- 官方 skills 随 CLI 同仓维护、版本化分发,manifest 位于仓库根:
`https://raw.githubusercontent.com/heygen-com/hyperframes/main/skills-manifest.json`
- 组成:核心集(hyperframes / hyperframes-core / hyperframes-cli / hyperframes-animation / hyperframes-keyframes / hyperframes-creative / hyperframes-registry / remotion-to-hyperframes)+ 工作流集(general-video、slideshow、motion-graphics、music-to-video、pr-to-video、product-launch-video、website-to-video、faceless-explainer、talking-head-recut、embedded-captions、media-use、figma)。以 `skills check` 实际输出为准
- 管理命令:
- `npx hyperframes skills check` —— 对照 manifest 检查版本
- `npx hyperframes skills update` —— 更新全部已装 + 清理官方已下架的
- `npx hyperframes init` —— **强制**同步 skills 到最新(`--skip-skills`