/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 渲染。
代理執行步驟
- 程式碼與腳本設計: 向使用者索取程式碼片段,或從其請求中提取。識別核心敘事:
- 使用哪種語言?(JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS)。
- 重點是什麼?(例如 async await 呼叫、裝飾器、拋出錯誤、遞迴回傳)。
- 哪個終端輸出或執行結果能證明其運作?
- 規格建立: 在工作目錄中撰寫
<name>.code.json(詳細規格如下)。 - 建置與渲染: 執行建置腳本:
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。
- 若需立即互動式 HTML 播放,請開啟產生的
- 品質檢查:
- 程式碼行數應舒適地容納,避免水平溢出(建議 9:16 行動裝置每行最多 48 字元;16:9 最多 80 字元)。
- 標註簡潔,編號 01 至 03,並清楚指向目標行。
- 終端輸出準確反映實際的執行行為。
- 交接: 將渲染後的 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 毫秒)。終端輸出應在程式碼打完後出現。