hyperframes-student-kit Agent技能架构：.claude/skills与Codex .agents镜像如何同步协作（完整指南）

【免费下载链接】hyperframes-student-kitEdit videos, reels, and YouTube Shorts with Codex or Claude Code. 14 skills, transcript-driven cuts, storytelling, 406 motion-graphics cards, and HyperFrames templates.项目地址https://gitcode.com/gh_mirrors/hy/hyperframes-student-kit点击查看免费下载hyperframes-student-kit 是一个用 Codex 或 Claude Code 剪辑视频、Reels 和 YouTube Shorts 的 AI 视频剪辑套件包含 15 个 Agent 技能、406 张动效卡片和 HyperFrames 模板。它的 Agent 技能架构采用单一事实源 自动生成镜像的设计规范技能存放在 .claude/skills/ 目录再由 scripts/sync-codex-skills.mjs 脚本一键同步为 Codex 可发现的 .agents/skills/ 镜像。理解这套同步协作机制是你自定义或扩展技能的前提。双目录结构谁才是规范源项目根目录下有两份内容几乎相同的技能目录但职责完全不同目录服务对象角色.claude/skills/Claude Code规范源canonical唯一允许手工编辑的位置.agents/skills/Codex镜像副本由脚本自动生成不建议手工修改.codex/Codex项目配置说明含 config.toml两个 Agent 运行时读取的工作区指南也是一对AGENTS.md 供 Codex 读取CLAUDE.md 供 Claude Code 读取。仓库要求两者内容保持一致当前两者逐字节相同其中明确写道Claude Code uses.claude/skills/. Codex uses the generated.agents/skills/.这套设计的核心原则只有一条只改.claude/skills/然后运行同步。技能包解剖一个 SKILL.md 如何组织每个技能是一个独立文件夹以SKILL.md为核心。以完整的视频剪辑技能 edit-video/SKILL.md 为例其结构如下.claude/skills/edit-video/ └── SKILL.md # YAML frontmatter 工作流程指令较大的技能还会携带三类辅助资源scripts/可执行的 Node 辅助脚本例如cut-silences技能内嵌的剪辑脚本references/按需加载的参考文档避免主文件过长NOTICE.txt第三方来源声明来自外部仓库的技能会附带。SKILL.md开头的 YAML frontmatter 是路由关键——name和description会被 Agent 用来判断什么时候该加载这个技能正文才是具体执行步骤。例如edit-video的描述就是对原始口播视频做转写、静音修剪、口误审查、视觉叙事与渲染验证的完整剪辑流程。全部 15 个技能的职责路由表收录在 AGENTS.md 中新手可以对照这张表快速找到对应技能short-form-editReels/Shorts、edit-video完整剪辑、cut-silences静音切除、cut-mistakes口误/重录、video-storytelling叙事弧线、style-library风格与卡片库、gsap时间线动画、hyperframes-cli预览/lint/渲染等。一键镜像同步sync-codex-skills 脚本的核心逻辑整个架构最关键的一环只有约 40 行代码全部在 scripts/sync-codex-skills.mjs 中。它的工作分三步1. 递归遍历规范源从.claude/skills/深度优先遍历所有文件自动跳过node_modules、__pycache__、.DS_Store等噪声当前共 106 个技能文件被纳入同步。2. 复制时做路径感知改写脚本对每类文件采取不同策略.md指令文件把内容中的.claude/skills/统一改写为.agents/skills/。因为技能正文里包含运行时命令如node .claude/skills/cut-silences/scripts/cut-silences.mjs ...Codex 侧执行时路径必须指向镜像目录脚本、数据等资源文件逐字节原样复制保持完全一致。3. 反向检查多余镜像同步完成后脚本还会遍历目标目录报告任何在源中不存在的Extra mirror file防止历史残留文件干扰 Agent 行为。两条 npm 命令完成日常协作package.json 中注册了两个脚本npm run sync:skills # 全量同步 .claude/skills - .agents/skills npm run check:skills # 只检查不同步发现差异或多余文件时以退出码 1 结束--check模式可直接接入 CI只要有人手改了镜像目录或漏跑同步检查就会失败。为什么不用符号链接注释写得很清楚The mirror uses real files so Windows users do not need symlink privileges.——镜像是真实文件Windows 用户无需额外权限即可使用。skills-lock.json外部技能的版本锁15 个技能中有 5 个gsap、hyperframes、hyperframes-cli、hyperframes-registry、website-to-hyperframes并非原创而是从 heygen-com/hyperframes 上游仓库引入的。skills-lock.json 对每个引入技能记录了source、sourceType和一个computedHashSHA-256 摘要{ gsap: { source: heygen-com/hyperframes, sourceType: github, computedHash: bf85f05f3c0146c18d6f6ff23e6a4cd4a7853462a6d637ea389b610f584d55f8 } }这相当于给外部技能上了版本锁内容一旦变化哈希即可用于校验与追溯与仓库中 THIRD_PARTY_NOTICES.md 的来源声明配套。调用技能Codex 的$与 Claude Code 的/镜像存在的意义就是让两个 Agent 都能自动发现技能Codex打开项目后自动发现.agents/skills/下的全部技能包用$edit-video、$cut-silences调用或直接自然语言描述.codex/README.md 说明了这一发现机制Claude Code直接读取规范目录.claude/skills/用/edit-video、/short-form-edit调用。一个常见坑新增技能后 Codex 里看不到按 docs/SETUP.md 的建议确认信任了项目设置并重启 Codex即可另外.codex/config.toml只设置了文档加载上限project_doc_max_bytes 65536和回退文件名刻意不触碰用户的模型、鉴权与沙箱配置。上图为技能链路实际产出的项目画面之一video-projects/linear-promo-30s/从脚本驱动截屏、构图合成到最终渲染全程由技能指令编排完成。技能维护最佳实践更新三步走修改任何技能只需记住标准三步来自 docs/SETUP.md编辑规范源只改.claude/skills/name/下的文件执行同步npm run sync:skills验证镜像npm run check:skills确认 0 差异。再补两条守则修改工作区指南时同步更新 AGENTS.md 与 CLAUDE.md保持逐字一致删除技能后跑一次--check清理.agents/skills/中被报告为多余的镜像文件。总结hyperframes-student-kit 的 Agent 技能架构可以用一句话概括.claude/skills/是唯一的写作台.agents/skills/是自动印刷的分发版sync-codex-skills.mjs是印刷机skills-lock.json是版权登记簿。这套规范源 路径感知镜像 哈希锁的组合让同一套 15 个视频剪辑技能在 Claude Code 与 Codex 中行为一致也为后续自行编写新技能提供了清晰的扩展路径。赞分享【免费下载链接】hyperframes-student-kitEdit videos, reels, and YouTube Shorts with Codex or Claude Code. 14 skills, transcript-driven cuts, storytelling, 406 motion-graphics cards, and HyperFrames templates.项目地址https://gitcode.com/gh_mirrors/hy/hyperframes-student-kit点击查看免费下载相关推荐hyperframes-student-kit 完全指南15项AI剪辑技能406张动效卡片让Codex和Claude Code替你剪视频hyperframes student kit 完全指南15项AI剪辑技能406张动效卡片让Codex和Claude Code替你剪视频 如果你正在找一款OPC Skills 架构解析skills.json、npx skills add 与Claude Code插件市场如何协同工作OPC Skills 架构解析skills.json、npx skills add 与Claude Code插件市场如何协同工作 OPC Skills 是面向3步保存视频号抖音无水印视频res-downloader本地代理嗅探完整指南3步保存视频号抖音无水印视频res downloader本地代理嗅探完整指南 右键一条视频号视频菜单里只有保存图片打开抓包工具满屏带时效参数的 CD桌面应用网络音视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考