/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 トークン検証
│ 04 throw new AuthError(); │ │
│ 05 } │ 非アクティブ行(暗転)
│ 06 return decoded.user; │
├──────────────────────────────────────┤
│ > TERMINAL EXECUTION │ スライド式ターミナルドロワー
│ > POST /api/v1/auth/verify HTTP/1.1 │ アニメーション化されたstdoutログ
│ > 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モバイル推奨: 1行最大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",
"> 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: 各行が1行のコードを表す文字列の配列。focusLines: 他の行を暗くする間、100%の明るさを維持する1から始まる行番号の配列。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 を使用してシステム命令で注入 |
テイストと美的基準
- 明確な視覚的階層: コードはクリーンで、フォーマットされ、読みやすい状態に保ちます。ミニファイされたコードを貼り付けないでください。
- 簡潔な吹き出し: 吹き出しの注釈は技術的事実であるべきで、マーケティングの誇大広告ではありません(「スーパークールな機能!」ではなく「プロミスを待機」)。
- コントラストと可読性: コードフォントはモバイルスマートフォン画面で十分なサイズであることを常に確認します(1080x1920キャンバスで最低28px)。
- ペーシング: タイピングは自然に感じられるべきです(1文字あたり25~40ミリ秒)。ターミナル出力は、コードのタイピングが完了した後に表示されるべきです。