Communitygithub.com

代码动效导演

为技术创作者、教育者和开发者生成动画语法讲解、代码讲解视频和终端执行录像。支持逐字打字效果、聚焦行变暗、引导标注和终端输出动画。用户运行/code-motion或要求动画化代码、创建编程视频、制作语法讲解或可视化代码执行时使用。

代码动效导演 是什么?

代码动效导演是一个AI智能体技能,允许开发者、教育工作者和技术内容创作者直接从代码片段生成精美的动画导览视频。它主要针对现代社交媒体平台(如TikTok、Shorts和Instagram)优化,输出垂直(9:16)视频,但也支持水平宽屏(16:9)格式。 该技能通过一个阶段性的Agent工作流运作:首先与用户协作确定代码叙事重点(如async/await、错误处理、递归等),然后在结构化JSON规范(`.code.json`)中定义动画参数,最后调用一个独立的Python构建脚本来渲染最终的HTML或MP4文件。生成的动画包含专业级特性,如代码逐字打字效果、聚焦/变暗行高亮、带引导线的标注以及模拟的终端标准输出执行日志。 该技能不依赖于外部AI API密钥或付费云服务——它利用HTML5 Canvas/SVG以及可选的Playwright、Puppeteer或ffmpeg进行无头MP4渲染,确保完全离线且免费运行。它能够适配多个AI Agent平台,包括Claude Code、Google Gemini和ChatGPT。 对于希望通过动态、视觉上吸引人的代码讲解来提升教程、演讲稿或演示的开发者来说,该技能消除了手动屏幕录制或复杂的视频编辑工作,将交互式、专业质量的代码动画创建自动化。

兼容平台✓Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/ishtiyaq8811/code-motion-director/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

/code-motion-director

┌──────────────────────────────────────┐
│ 🔴 🟡 🟢  src/auth/session.ts   [9:16]│  mac title bar with file path
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02   const decoded = await verify(); │  active line focused
│ 03   if (!decoded.valid) {     ┌─────┼─ 01 Token validation
│ 04     throw new AuthError();  │     │
│ 05   }                               │  inactive lines dimmed
│ 06   return decoded.user;            │
├──────────────────────────────────────┤
│ > TERMINAL EXECUTION                 │  sliding terminal drawer
│ > POST /api/v1/auth/verify HTTP/1.1  │  animated stdout logging
│ > Status: 200 OK (14.2ms)            │
└──────────────────────────────────────┘

首次使用

此技能的目录为技能包的基目录。

# 检查 Python 3 是否已安装
python3 --version || python --version

独立运行,无需外部 AI API 密钥、重型依赖项或付费云 API。使用无头 HTML5 Canvas / SVG,并可选择 Playwright、Puppeteer 或 ffmpeg 进行无头 MP4 渲染。


Agent 执行步骤

  1. 代码与故事板: 向用户询问代码片段,或从他们的请求中提取。确定核心叙事:
    • 使用什么语言?(JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS)。
    • 焦点是什么?(例如,一个 async/await 调用、装饰器、错误抛出、递归返回)。
    • 哪些终端输出或执行结果可以证明其工作?
  2. 规范创建: 在工作目录中编写 <name>.code.json(详细规范如下)。
  3. 构建与渲染: 运行构建脚本:
    python build.py <name>.code.json
    
    • 如需立即交互式 HTML 播放,打开生成的 <name>.motion.html。
    • 检查静态帧快照:python build.py <name>.code.json --snap 4.5。
    • 验证模式语法:python build.py <name>.code.json --validate。
  4. 质量检查:
    • 代码行应舒适放置,无需水平滚动(建议 9:16 移动端每行最多 48 个字符;16:9 每行最多 80 个字符)。
    • 标注应简洁,编号为 01 到 03,并清晰指向目标行。
    • 终端输出准确反映真实的执行行为。
  5. 交接: 向用户提供渲染后的 HTML / 视频路径和规范摘要。

规范格式 (<name>.code.json)

{
  "title": "src/auth/session.ts",
  "language": "typescript",
  "aspectRatio": "9:16",
  "theme": "obsidian",
  "code": [
    "async function verifyToken(token: string) {",
    "  const session = await auth.verify(token);",
    "  if (!session.isValid) {",
    "    throw new UnauthorizedError('Expired');",
    "  }",
    "  return session.user;",
    "}"
  ],
  "focusLines": [2, 3],
  "typingSpeed": 35,
  "callouts": [
    {
      "line": 2,
      "label": "Async Verification",
      "note": "Awaits cryptographic signature",
      "side": "right"
    },
    {
      "line": 4,
      "label": "Guard Clause",
      "note": "Rejects expired JWT payloads",
      "side": "right"
    }
  ],
  "terminal": {
    "enabled": true,
    "title": "Server Output (Node.js v22)",
    "commands": [
      "$ curl -X POST https://api.dev/auth/verify",
      "> Verifying HMAC-SHA256 signature...",
      "> Token Verified: user_id=4092 [200 OK]"
    ]
  },
  "sound": {
    "typewriterClicks": true,
    "completionChime": true
  },
  "durationSeconds": 8.0
}

参数定义

  • title: 显示在窗口标题栏中的字符串(例如文件名或模块路径)。
  • language: "javascript", "typescript", "python", "rust", "go", "sql", "bash"。
  • aspectRatio: "9:16"(用于 TikTok/Shorts/Instagram 的垂直视频)或 "16:9"(水平宽屏)。
  • theme: "obsidian"(深暗紫色), "onedark"(Atom 风格), "monokai"(经典高对比度), 或 "cyberpunk"(霓虹青/洋红)。
  • code: 字符串数组,每个字符串代表一行代码。
  • focusLines: 基于 1 的行号数组,这些行保持 100% 亮度,而其他行变暗。
  • callouts: 可选的注释列表。建议最多 3 个标注。
    • line: 基于 1 的行号,用于锚定引导线。
    • label: 简短的大写或粗体标题(最多 18 个字符)。
    • note: 解释性副标题(最多 28 个字符)。
  • terminal: 可选的底部抽屉,包含 stdout 命令和响应。
  • sound: 可选的 Web Audio API 程序化合成设置(打字点击声和提示音)。
  • durationSeconds: 总动画时长(默认:8.0 秒)。

支持的平台

平台集成方法
Claude / Claude Code通过 ~/.claude/skills/code-motion-director/ 或工作区 .claude-plugin/ 中的 SKILL.md 加载
Google Antigravity注册在 .gemini/antigravity/skills/code-motion-director/ 下
ChatGPT / 自定义 GPT使用 adapters/chatgpt-instructions.md 通过自定义指令配置
Google Gemini使用 adapters/antigravity-gemini.md 通过系统指令注入

品味与审美标准

  • 清晰的视觉层次: 保持代码清洁、格式正确且可读。切勿粘贴压缩后的代码。
  • 简洁的标注: 标注注释应为技术事实,而非营销炒作(例如“等待 Promise”,而不是“超酷特性!”)。
  • 对比度与可读性: 始终确保代码字体大小足以在智能手机屏幕上清晰显示(在 1080x1920 画布上最小 28px)。
  • 节奏: 打字速度应感觉自然(每字符 25–40 毫秒)。终端输出应在代码输入完成后出现。

相关技能