/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 执行步骤
- 代码与故事板: 向用户询问代码片段,或从他们的请求中提取。确定核心叙事:
- 使用什么语言?(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": "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 毫秒)。终端输出应在代码输入完成后出现。