Communitygithub.com

code-motion-director

為技術創作者、教育者和開發者生成動畫語法導覽、程式碼解說影片和終端執行重播。支援漸進式打字機效果、焦點行淡化、引導標註和動畫終端標準輸出。

code-motion-director 是什麼?

Code-motion-director 是一款 AI 驅動的技能,專為在 Claude Code、Cursor 等平台上創建高品質的程式碼動畫解說影片而設計。它將靜態程式碼片段轉變為動態的語法導覽,具備打字機效果、焦點行標記和引導標註功能,並可選擇性地包含模擬的終端輸出,非常適合製作教學影片、技術簡報或社群媒體短影音。該技能支援多種程式語言(如 JavaScript、Python、TypeScript)和視訊長寬比(如 9:16 垂直格式),並透過一個 JSON 規範檔案驅動渲染流程,無需依賴外部 AI API 或昂貴的雲端服務。它利用 headless HTML5 Canvas/SVG 進行渲染,並可選用 Playwright、Puppeteer 或 ffmpeg 產生 MP4 影片,為開發者提供了一個輕量級且可自訂的程式碼可視化工具。

相容平台✓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 標題列含檔案路徑
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02   const decoded = await verify(); │  啟用行聚焦
│ 03   if (!decoded.valid) {     ┌─────┼─ 01 Token 驗證
│ 04     throw new AuthError();  │     │
│ 05   }                               │  非啟用行淡化
│ 06   return decoded.user;            │
├──────────────────────────────────────┤
│ > 終端執行                           │  滑動式終端抽屜
│ > POST /api/v1/auth/verify HTTP/1.1  │  動畫標準輸出記錄
│ > Status: 200 OK (14.2ms)            │
└──────────────────────────────────────┘

首次使用

此技能的目錄即為技能套件的基礎目錄。

# 確認已安裝 Python 3
python3 --version || python --version

獨立執行,無需外部 AI API 金鑰、重量級依賴項或付費雲端 API。使用無頭 HTML5 Canvas / SVG,並可選用 Playwright、Puppeteer 或 ffmpeg 進行無頭 MP4 渲染。


代理執行步驟

  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": "非同步驗證",
      "note": "等待密碼簽章",
      "side": "right"
    },
    {
      "line": 4,
      "label": "守衛子句",
      "note": "拒絕過期的 JWT 負載",
      "side": "right"
    }
  ],
  "terminal": {
    "enabled": true,
    "title": "伺服器輸出 (Node.js v22)",
    "commands": [
      "$ curl -X POST https://api.dev/auth/verify",
      "> 驗證 HMAC-SHA256 簽章...",
      "> Token 已驗證: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:可選的底部抽屜,包含標準輸出的命令和回應。
  • 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 毫秒)。終端輸出應在程式碼打完後出現。

相關技能