@leejungkiin/awkit 1.7.6 → 1.7.7

package/bin/awk.js

@@ -67,16 +67,18 @@ const PLATFORMS = {
         },
         supportsCustomModes: false,
         supportsSubagents: false,
+        isGlobal: true,
     },
     cline: {
         name: 'Cline (VS Code)',
-        globalRoot: process.cwd(), // Local to project
+        globalRoot: path.join(HOME, '.cline'),
         rulesFile: path.join(HOME, '.cline', 'rules', 'antigravity-rules.md'),
         versionFile: path.join(HOME, '.cline', 'awk_version'),
         dirs: {
-            workflows: '.clinerules',
-            skills: '.clinerules/skills',
+            workflows: 'rules',
+            skills: 'rules',
         },
+        isGlobal: true,
     },
     codex: {
         name: 'Codex (OpenAI)',
@@ -87,15 +89,17 @@ const PLATFORMS = {
             agents: 'agents',
             skills: '../.agents/skills',
         },
+        isGlobal: true,
     },
     claude: {
         name: 'Claude Code',
-        globalRoot: process.cwd(), // Local to project
+        globalRoot: path.join(HOME, '.claude'),
         rulesFile: 'CLAUDE.md',
-        versionFile: '.claude/awk_version',
+        versionFile: 'awk_version',
         dirs: {
-            skills: '.claude/skills',
+            skills: 'skills',
         },
+        isGlobal: true,
     },
     qwen: {
         name: 'Qwen Code',
@@ -105,15 +109,17 @@ const PLATFORMS = {
         dirs: {
             skills: 'skills',
         },
+        isGlobal: true,
     },
     cursor: {
         name: 'Cursor AI',
-        globalRoot: process.cwd(), // Local to project
-        rulesFile: '.cursor/rules/antigravity-rules.mdc',
-        versionFile: '.cursor/awk_version',
+        globalRoot: path.join(HOME, '.cursor'),
+        rulesFile: path.join(HOME, '.cursor', 'rules', 'antigravity-rules.mdc'),
+        versionFile: path.join(HOME, '.cursor', 'awk_version'),
         dirs: {
-            skills: '.cursor/rules',
+            skills: 'rules',
         },
+        isGlobal: true,
     }
 };
 
@@ -538,8 +544,19 @@ function cmdInstall(args = []) {
     const isUpdate = args.includes('--update');
     let selectedPlatforms = [];
 
-    if (args.includes('--all') || args.includes('-a') || args.includes('all')) {
-        selectedPlatforms = Object.keys(PLATFORMS);
+    const hasAll = args.includes('--all') || args.includes('-a') || args.includes('all');
+    const hasLocal = args.includes('--local') || args.includes('-l') || args.includes('local');
+
+    if (hasAll) {
+        // Mặc định --all chỉ cài đặt các platform Global
+        selectedPlatforms = Object.keys(PLATFORMS).filter(p => PLATFORMS[p].isGlobal);
+        if (hasLocal) {
+            // Nếu có cả --local thì cài tất cả các platform
+            selectedPlatforms = Object.keys(PLATFORMS);
+        }
+    } else if (hasLocal) {
+        // Chỉ cài các platform Local
+        selectedPlatforms = Object.keys(PLATFORMS).filter(p => !PLATFORMS[p].isGlobal);
     } else {
         if (args.includes('--gemini') || args.includes('-g') || args.includes('antigravity')) selectedPlatforms.push('antigravity');
         if (args.includes('--cline') || args.includes('cline')) selectedPlatforms.push('cline');
@@ -552,7 +569,7 @@ function cmdInstall(args = []) {
         let legacyArg = null;
         if (pIdx !== -1 && args[pIdx + 1]) {
             legacyArg = args[pIdx + 1];
-        } else if (args.length > 0 && !args[0].startsWith('-') && args[0] !== 'all' && args[0] !== '--update') {
+        } else if (args.length > 0 && !args[0].startsWith('-') && args[0] !== 'all' && args[0] !== '--update' && args[0] !== 'local') {
             legacyArg = args[0];
         }
 
@@ -569,17 +586,17 @@ function cmdInstall(args = []) {
             const defaultPlatform = getActivePlatform();
             const defaultChoice = String(Math.max(platformOrder.indexOf(defaultPlatform), 0) + 1);
             log(`${C.cyan}Select platforms to install (e.g., type "1,2", "all", or "1-6"):${C.reset}`);
-            log(`  1. Gemini Code Assist (antigravity)`);
-            log(`  2. Cline (VS Code)`);
-            log(`  3. Codex CLI (codex)`);
-            log(`  4. Claude Code (.claude/)`);
-            log(`  5. Qwen Code (~/.qwen/)`);
-            log(`  6. Cursor AI (.cursor/rules/)`);
-            log(`  7. All of the above`);
+            log(`  1. Gemini Code Assist (antigravity) [Global]`);
+            log(`  2. Cline (VS Code) [Global]`);
+            log(`  3. Codex CLI (codex) [Global]`);
+            log(`  4. Claude Code (.claude/) [Global]`);
+            log(`  5. Qwen Code (~/.qwen/) [Global]`);
+            log(`  6. Cursor AI (.cursor/rules/) [Global]`);
+            log(`  7. All platforms (1-6)`);
             log(`${C.gray}Press Enter to install only the active platform: ${PLATFORMS[defaultPlatform].name}.${C.reset}`);
             const choice = promptChoice('Choice', defaultChoice).trim().toLowerCase();
 
-            if (choice === '7' || choice === 'all') {
+            if (choice === '7' || choice === 'all' || choice === '1-6') {
                 selectedPlatforms = Object.keys(PLATFORMS);
             } else {
                 if (choice.includes('1')) selectedPlatforms.push('antigravity');
@@ -704,6 +721,8 @@ function cmdInstall(args = []) {
                 generateClineSkills(skillsSrc, skillsDest, coreSkills);
             } else if (platform === 'codex') {
                 generateCodexSkills(skillsSrc, skillsDest, coreSkills);
+                const codexSkillsDest = path.join(target, 'skills');
+                generateCodexSkills(skillsSrc, codexSkillsDest, coreSkills);
                 const agentsDest = path.join(target, plat.dirs.agents);
                 generateCodexAgents(skillsSrc, agentsDest, coreSkills);
             } else if (platform === 'claude') {
@@ -1067,7 +1086,8 @@ async function cmdDoctor() {
     log('');
     log(`${C.bold}Runtime Profile:${C.reset}`);
     log(`  Profile: ${C.cyan}${installState.profile}${C.reset}`);
-    log(`  Optional packs: ${installState.enabledPacks?.length ? installState.enabledPacks.join(', ') : C.gray + 'none' + C.reset}`);
+    const visiblePacks = (installState.enabledPacks || []).filter(p => p !== 'reverse-engineering');
+    log(`  Optional packs: ${visiblePacks.length ? visiblePacks.join(', ') : C.gray + 'none' + C.reset}`);
 
     // Summary
     log('');
@@ -1929,7 +1949,8 @@ function cmdStatus() {
     }
 
     log(`  ${C.gray}Profile:${C.reset}         ${installState.profile}`);
-    log(`  ${C.gray}Optional packs:${C.reset}  ${installState.enabledPacks?.length ? installState.enabledPacks.join(', ') : 'none'}`);
+    const visiblePacksStatus = (installState.enabledPacks || []).filter(p => p !== 'reverse-engineering');
+    log(`  ${C.gray}Optional packs:${C.reset}  ${visiblePacksStatus.length ? visiblePacksStatus.join(', ') : 'none'}`);
 
     log('');
 

package/bin/codex-generators.js

@@ -16,9 +16,36 @@ function generateCodexAgentsMd(sourcePath, destPath) {
     console.log(`✅ Codex AGENTS.md generated at: ${destPath}`);
 }
 
+/**
+ * Recursively copies a skill directory preserving structure.
+ */
+function copySkillDir(src, dest) {
+    if (!fs.existsSync(src)) return 0;
+    fs.mkdirSync(dest, { recursive: true });
+
+    let count = 0;
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+
+    for (const entry of entries) {
+        if (entry.name === '.DS_Store') continue;
+        if (entry.name === '__pycache__') continue;
+
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+
+        if (entry.isDirectory()) {
+            count += copySkillDir(srcPath, destPath);
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+            count++;
+        }
+    }
+    return count;
+}
+
 /**
  * Generates Codex skills directory structure.
- * Copies SKILL.md and parses it.
+ * Copies the entire skill directory and parses/injects frontmatter to SKILL.md.
  */
 function generateCodexSkills(srcDir, destDir, selectedSkills = null) {
     if (!fs.existsSync(srcDir)) return;
@@ -37,11 +64,13 @@ function generateCodexSkills(srcDir, destDir, selectedSkills = null) {
         const skillFile = path.join(skillDir, 'SKILL.md');
         if (fs.existsSync(skillFile)) {
             const destSkillDir = path.join(destDir, skill);
-            fs.mkdirSync(destSkillDir, { recursive: true });
+            
+            // Copy the entire directory first
+            copySkillDir(skillDir, destSkillDir);
 
             const destPath = path.join(destSkillDir, 'SKILL.md');
 
-            let content = fs.readFileSync(skillFile, 'utf8');
+            let content = fs.readFileSync(destPath, 'utf8');
 
             if (content.startsWith('---\n')) {
                 if (!content.match(/^name:/m)) {

package/core/GEMINI.md

@@ -1,6 +1,6 @@
 # GEMINI.md — Antigravity v12.6
 
-> Rules only. Updated: 2026-06-15
+> Rules only. Updated: 2026-06-23
 
 ---
 
@@ -62,11 +62,12 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - Build: CHỈ dùng `awkit build`. CẤM gọi native (`xcodebuild`, `./gradlew`, `npm run build`).
 - `automation.build.enabled: false` → DỪNG, báo user. KHÔNG fallback native.
 - Thêm params qua `--`: `awkit build -- -destination '...'`. Bypass wrapper = VI PHẠM.
+- **Chạy tác vụ nền (Background Tasks)**: Khi chạy các tác vụ nền hoặc tác vụ dài (>30 giây) như Codex CLI, PHẢI chạy qua wrapper `node scripts/exec-progress.js "<command>"` để hiển thị checklist tiến trình trực quan cho người dùng thay vì để trống màn hình.
 
 ### 7-Gate System
 - Triage: TRIVIAL (→ Gate 4 thẳng) | MODERATE (→ G3+4+5) | COMPLEX (→ all gates).
 - Gates: G1 brainstorm → G1.5 module-spec (COMPLEX+>3mod) → G2 spec-gate → G2.5 visual (skip nếu backend) → G3 symphony-enforcer → G4 execution → G5 verification.
-- **Goal Mode Override:** Khi đang ở goal mode (`/goal`, active Codex goal, hoặc user nói rõ "goal mode") → gates là checklist nội bộ, KHÔNG dừng chờ user approval ở G2/G2.5/G4 checkpoints. AI tự chọn best-effort, tự verify, ghi assumption, rồi tiếp tục tới khi goal complete/bị block thật sự. Safety/destructive/security vẫn phải hỏi.
+- **Goal Mode Override (NO-CONFIRM):** Khi đang ở goal mode (`/goal`, active Codex goal, hoặc user nói rõ "goal mode") → gates là checklist nội bộ, KHÔNG dừng chờ user approval ở bất kỳ bước nào (G2/G2.5/G4 checkpoints, prompt audit, style preview, grid configuration, specs approval, v.v.). AI tự động chọn phương án tối ưu (best-effort/recommended default), tự verify, ghi nhận giả định (assumptions) vào logs/walkthrough, rồi tiếp tục cho đến khi goal hoàn thành hoặc bị block thực sự bởi lỗi kỹ thuật/permission. Chỉ dừng lại hỏi ý kiến khi gặp lệnh thực sự nguy hại (destructive) hoặc nhạy cảm bảo mật quy định tại Safety Guardrails.
 - **Gate 4 Three-Phase:**
   - Phase A 🏗️ Infrastructure → B 🎨 UI Shell (mock) → C ⚡ Logic (real data).
   - COMPLEX+UI: 3 phases bắt buộc. MODERATE+UI: A+C gộp, B optional. TRIVIAL: bypass.
@@ -102,8 +103,11 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - Sau khi dùng tool sửa code → KHÔNG in lại code trong chat. Tóm tắt bằng bullets.
 - Code block trong chat: tối đa 10 dòng. Show diff → dùng `render_diffs()`.
 
-### Image Generation Efficiency
-- Image gen: grid/spritesheet cho batch variants, không gen từng ảnh rời.
+### Image Generation & Asset Mandates (BẮT BUỘC)
+- **Cấm tự tạo SVG:** CẤM tự sinh, tự tạo hoặc thiết kế mã SVG cho các UI assets, biểu tượng trang trí, hoặc spritesheet (do chất lượng SVG tự tạo không đảm bảo và không bám sát thiết kế). BẮT BUỘC sử dụng Codex CLI để tạo hình ảnh và spritesheet UI.
+- **Sử dụng Skill bắt buộc:** Tuyệt đối sử dụng các skill `generate-gui-assets` và `hatch-pet` theo tài liệu tương ứng tại `/Users/trungkientn/.agents/skills/generate-gui-assets/SKILL.md` và `/Users/trungkientn/.codex/skills/hatch-pet/SKILL.md`.
+- **Thiết kế dùng Grid để tiết kiệm:** Bắt buộc thiết kế các assets (ngoại trừ background) bằng dạng Grid (spritesheet/atlas) để tối ưu chi phí và tài nguyên.
+- **Quy trình Grid & Tự Động Phê Duyệt:** Luôn ưu tiên tạo và kiểm chứng (verify) theo hướng lưới `8x6` trước. Nếu chất lượng quá xấu, tự động giảm dần số lượng item/kích thước grid xuống các cấu hình nhỏ hơn (ví dụ: 8x5, 6x6, 6x5, v.v.) mà KHÔNG cần hỏi ý kiến hoặc bắt user xác nhận lại (kể cả trong Normal hay Goal Mode).
 
 ### Proactive UI Asset Generation (MANDATORY)
 - **Asset Audit:** Trong Gate 2.5 (Visual Design) và Gate 4 Phase B (UI Shell), BẮT BUỘC rà soát mã nguồn/thiết kế để phát hiện các UI assets bị thiếu (nút bấm, panel, icon, pet, egg...).
@@ -112,7 +116,8 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - **Cấu trúc Lệnh:**
   - Đối với UI assets: `codex exec "Generate GUI asset: [Prompt/Style/Theme] and save it to [path] using the generate-gui-assets skill rules."`
   - Đối với Pet/Egg assets: `codex exec "Generate pet companion asset: [Pet Type/State] and save it to [path] using the hatch-pet skill rules and grid configuration [grid]."`
-- **Chi tiết & Approval:** Tự động thiết lập prompt chi tiết dựa trên Theme của App, tuân thủ tiêu chuẩn Solid Background và hỏi ý kiến user trước khi thực thi lệnh.
+- **Chi tiết & Approval:** Tự động thiết lập prompt chi tiết dựa trên Theme của App, tuân thủ tiêu chuẩn Solid Background và hỏi ý kiến user trước khi thực thi lệnh (Trừ Goal Mode hoặc trường hợp tự động giảm cấu hình lưới grid: Tự động phê duyệt prompt/cấu hình và thực thi lệnh không cần hỏi).
+
 
 
 ### Communication (CAVEMAN ULTRA)

package/core/GEMINI.md.bak

@@ -191,5 +191,5 @@ Complete>Shortcuts, Evidence>Assumptions, Standard>Custom, Explicit>Implicit, Te
 - **Gate skills:** `orchestrator` (triage) → `brainstorm-agent` (G1) → `module-spec-writer` (G1.5) → `spec-gate` (G2) → `visual-design-gate` (G2.5) → `symphony-enforcer` (G3) → `verification-gate` (G5)
 - **Code intelligence:** `gitnexus-intelligence` (impact analysis, blast radius, safe refactoring)
 - **Skill catalog:** xem `orchestrator/SKILL.md`
-- **Workflows:** 75+ (/xxx). Core: /init /code /debug /recap /next /todo /gitnexus /teach
-- **Shortcuts:** `/todo` `/done` `/next`
+- **Workflows:** 75+ (/xxx). Core: /init /code /debug /recap /next /todo /gitnexus /teach /goal
+- **Shortcuts:** `/todo` `/done` `/next` `/goal`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.7.6",
+  "version": "1.7.7",
   "description": "Antigravity Workflow Kit v1.6 Unified AI agent orchestration system with Mindful Checkpoints.",
   "main": "bin/awk.js",
   "private": false,

package/scripts/exec-progress.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+/**
+ * Progress Tracker Wrapper for Background Tasks
+ * Spawns a process, pipes logs to a temp file, and prints a dynamic step checklist
+ * to prevent the IDE from looking like it hung.
+ */
+
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+if (args.length === 0) {
+    console.error('Usage: node scripts/exec-progress.js <command> [args...]');
+    process.exit(1);
+}
+
+const command = args.join(' ');
+
+const LOG_DIR = path.join(process.cwd(), 'tmp');
+if (!fs.existsSync(LOG_DIR)) {
+    fs.mkdirSync(LOG_DIR, { recursive: true });
+}
+const logFile = path.join(LOG_DIR, 'background_process.log');
+const logStream = fs.createWriteStream(logFile, { flags: 'w' });
+
+console.log(`\n\x1b[36m\x1b[1m🚀 Running Process with Progress Tracker\x1b[0m`);
+console.log(`\x1b[90mCommand: ${command}\x1b[0m`);
+console.log(`\x1b[90mFull log redirected to: file://${logFile}\x1b[0m\n`);
+
+const steps = [
+    { name: 'Khởi tạo tiến trình (Initialization)', pattern: /init|start|launching/i, status: 'pending' },
+    { name: 'Lập kế hoạch & Phân tích (Planning)', pattern: /plan|analyz/i, status: 'pending' },
+    { name: 'Thực thi tác vụ chính (Execution)', pattern: /execut|generat|render|process/i, status: 'pending' },
+    { name: 'Kiểm tra & Hoàn thiện (Verification)', pattern: /verify|check|done|finish/i, status: 'pending' }
+];
+
+let activeStepIndex = -1;
+
+function renderChecklist() {
+    // Clear last lines using ANSI escape codes
+    process.stdout.write('\x1b[1F\x1b[2K'.repeat(steps.length + 1));
+    console.log(`\x1b[36m📊 Trạng thái tiến trình:\x1b[0m`);
+    steps.forEach((step, idx) => {
+        let icon = '⬜';
+        let color = '\x1b[0m';
+        if (step.status === 'done') {
+            icon = '✅';
+            color = '\x1b[32m';
+        } else if (step.status === 'running') {
+            icon = '🔄';
+            color = '\x1b[33m\x1b[1m';
+        }
+        console.log(`  ${icon} ${color}${step.name}\x1b[0m`);
+    });
+}
+
+// Print initial spacing for checklist
+console.log('\n'.repeat(steps.length + 1));
+renderChecklist();
+
+// Spawn process via shell to support command strings with arguments/pipes
+const proc = spawn(command, { shell: true });
+
+proc.stdout.on('data', (data) => {
+    const text = data.toString();
+    logStream.write(text);
+    
+    // Parse output to update steps
+    const lines = text.split('\n');
+    lines.forEach(line => {
+        if (!line.trim()) return;
+        
+        // Scan for patterns to progress steps
+        steps.forEach((step, idx) => {
+            if (step.pattern.test(line)) {
+                if (step.status === 'pending') {
+                    // Mark previous active step as done
+                    if (activeStepIndex >= 0 && activeStepIndex < idx) {
+                        steps[activeStepIndex].status = 'done';
+                    }
+                    step.status = 'running';
+                    activeStepIndex = idx;
+                    renderChecklist();
+                }
+            }
+        });
+    });
+});
+
+proc.stderr.on('data', (data) => {
+    const text = data.toString();
+    logStream.write(text);
+});
+
+proc.on('close', (code) => {
+    logStream.end();
+    if (activeStepIndex >= 0) {
+        steps[activeStepIndex].status = code === 0 ? 'done' : 'pending';
+    }
+    // If successful, mark all steps as done
+    if (code === 0) {
+        steps.forEach(s => s.status = 'done');
+    }
+    renderChecklist();
+    
+    if (code === 0) {
+        console.log(`\n\x1b[32m\x1b[1m🎉 Hoàn thành tiến trình thành công!\x1b[0m\n`);
+        process.exit(0);
+    } else {
+        console.log(`\n\x1b[31m\x1b[1m❌ Tiến trình kết thúc với lỗi (Mã lỗi: ${code}).\x1b[0m`);
+        console.log(`\x1b[90mChi tiết lỗi xem tại file log trên.\x1b[0m\n`);
+        process.exit(code);
+    }
+});

package/skills/generate-gui-assets/SKILL.md

@@ -65,7 +65,7 @@ After the canonical files and manifests exist, the app points at them, and verif
 
 ## Default Workflow
 
-1. Build canvas grid options and ask for one-time confirmation before any generation.
+1. Build canvas grid options and ask for one-time confirmation before any generation (Goal Mode: Auto-select recommended grid strategy, e.g. 8x6 for high throughput, and proceed).
 
 Always present total icon capacity from larger to smaller. These are uniform canvas grids for deterministic slicing, not arbitrary pack boxes:
 
@@ -87,7 +87,7 @@ SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/generate-gui-assets"
 python "$SKILL_DIR/scripts/suggest_grid_options.py" --icon-count 18 --strategy throughput
 ```
 
-Do not generate preview or bulk until the user confirms one canvas grid strategy.
+Do not generate preview or bulk until the user confirms one canvas grid strategy (Goal Mode: Auto-select recommended grid strategy and proceed).
 
 Use this confirmation template exactly (largest to smallest, one-time confirm):
 
@@ -137,7 +137,7 @@ python "$SKILL_DIR/scripts/build_gui_contact_sheet.py" \
   --run-dir assets/ui/generated/gui-v1-preview
 ```
 
-5. Wait for explicit user confirmation. Do not run bulk generation before preview is approved.
+5. Wait for explicit user confirmation. Do not run bulk generation before preview is approved (Goal Mode: Auto-approve preview and immediately launch bulk generation).
 
 6. After approval, create the bulk run using locked style language:
 
@@ -265,8 +265,8 @@ Quality rules: no text, no labels, no scenery, no glow, no shadows outside silho
 
 ## Iteration Strategy
 
-- Always run preview-first and require explicit user confirmation before bulk generation.
-- Ask for grid confirmation exactly once per run before preview.
+- Always run preview-first and require explicit user confirmation before bulk generation (Goal Mode: Bypass confirmation, auto-approve).
+- Ask for grid confirmation exactly once per run before preview (Goal Mode: Bypass confirmation, auto-select recommended).
 - Prefer larger total canvas grids first to reduce generation count, then step down only if preview quality is unacceptable.
 - In throughput strategy, recommend `8x6` first for up to 48 icons per image.
 - Treat `4x4` as a compact quality-priority option, not the default large-layout recommendation.

package/skills/hatch-pet/SKILL.md

@@ -21,7 +21,7 @@ Before generating base art, row strips, or repair rows, load and follow the inst
 ${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/SKILL.md
 ```
 
-Do not call the Image API directly for the normal path. Let `$imagegen` choose its own built-in-first path and its own CLI fallback rules. If `$imagegen` says a fallback requires confirmation, ask the user before continuing.
+Do not call the Image API directly for the normal path. Let `$imagegen` choose its own built-in-first path and its own CLI fallback rules. If `$imagegen` says a fallback requires confirmation, ask the user before continuing (Goal Mode: Auto-approve fallback).
 
 Fallback providers are opt-in only and require explicit user request plus both `OPENAI_API_KEY` and `OPENROUTER_API_KEY`.
 Do not precheck, mention, or require provider API keys unless the user explicitly requests fallback.
@@ -273,7 +273,7 @@ selected_source=/absolute/path/to/$CODEX_HOME/generated_images/.../ig_*.png
 qa_note=<one sentence>
 ```
 
-No silent sequential fallback: if subagents cannot be used for row-strip visual generation, stop and ask for explicit user direction before continuing without them. Only an explicit user instruction such as "do not use subagents" or "run this sequentially" authorizes a normal sequential row-generation path. The final answer must report which row jobs were delegated to subagents and which, if any, were mirrored or repaired by the parent.
+No silent sequential fallback: if subagents cannot be used for row-strip visual generation, stop and ask for explicit user direction before continuing without them (Goal Mode: Automatically fall back to sequential generation without asking). Only an explicit user instruction such as "do not use subagents" or "run this sequentially" authorizes a normal sequential row-generation path. The final answer must report which row jobs were delegated to subagents and which, if any, were mirrored or repaired by the parent.
 
 ## Repair Workflow
 

package/skills/threejs-animation/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: threejs-animation
+description: "three.js keyframe animation system: AnimationMixer, AnimationClip, AnimationAction, KeyframeTrack variants, PropertyBinding, PropertyMixer, AnimationObjectGroup, AnimationUtils; mixing and crossfading clips, loop modes, timeScale, weight; addon AnimationClipCreator and CCDIKSolver for procedural rigs. Use when playing glTF clips, blending actions, or authoring procedural tracks; for skin deformation rigging on meshes see threejs-objects; for math interpolants without clips see threejs-math only when not tied to AnimationMixer."
+---
+
+## When to use this skill
+
+**ALWAYS use this skill when the user mentions:**
+
+- `AnimationMixer.update`, `AnimationAction` play/pause/stop, crossfade, synchronized clips
+- `AnimationClip` from glTF or `AnimationClipCreator`, retargeting caveats at API level
+- Keyframe tracks: position/rotation/scale/color tracks, boolean/string tracks where applicable
+- IK: `CCDIKSolver` / `CCDIKHelper` from addons
+
+**IMPORTANT: animation vs objects**
+
+- **threejs-animation** = time evaluation and tracks.
+- **threejs-objects** = `SkinnedMesh`/`Skeleton` attachment, bind pose—mesh side.
+
+**Trigger phrases include:**
+
+- "AnimationMixer", "AnimationAction", "AnimationClip", "crossFade", "KeyframeTrack"
+- "动画混合", "骨骼动画", "剪辑", "淡入淡出"
+
+## How to use this skill
+
+1. **Collect clips** from `gltf.animations` or create with utilities / `AnimationClipCreator`.
+2. **Create mixer** bound to root object (often `scene` or rig root).
+3. **Create actions** per clip via `mixer.clipAction(clip)`; configure loop mode (`LoopOnce`, `LoopRepeat`, `LoopPingPong`).
+4. **Per frame**: compute delta seconds (use `Clock` from core—documented under Core in docs index), call `mixer.update(delta)`.
+5. **Blending**: adjust `weight`, `crossFadeTo`, `enabled` flags; watch for additive vs full replacement semantics per docs.
+6. **PropertyBinding**: understand path strings targeting bones/morphs—errors often from wrong object names.
+7. **IK addon**: attach solver after base animation if using CCD IK from examples.
+
+See [examples/workflow-mixer-action.md](examples/workflow-mixer-action.md).
+
+## Doc map (official)
+
+| Docs section | Representative links |
+|--------------|----------------------|
+| Animation (index) | https://threejs.org/docs/#Animation |
+| Action | https://threejs.org/docs/AnimationAction.html |
+| Mixer | https://threejs.org/docs/AnimationMixer.html |
+| Clip | https://threejs.org/docs/AnimationClip.html |
+| Tracks | https://threejs.org/docs/KeyframeTrack.html |
+
+More: [references/official-sections.md](references/official-sections.md).
+
+## Scope
+
+- **In scope:** Core Animation module, keyframe pipeline, listed addons for clip creation and IK.
+- **Out of scope:** DCC export best practices; physics ragdoll; audio sync (link conceptually only).
+
+## Common pitfalls and best practices
+
+- Forgetting `mixer.update` freezes animation; double `update` per frame speeds up.
+- Mixing clips with incompatible hierarchies causes violent pops—validate bind pose.
+- Root motion must be handled in game logic if not baked—document explicitly.
+- Large track counts cost CPU—strip unused tracks in preprocessing when possible.
+
+## Documentation and version
+
+Behavior of `AnimationMixer`, tracks, and glTF animation import can change between three.js majors. Treat the [Animation](https://threejs.org/docs/#Animation) section of the [docs index](https://threejs.org/docs/) as authoritative for the user’s installed version; when upgrading, check the three.js repository release notes and migration notes for renamed properties or loader output.
+
+## Agent response checklist
+
+When answering under this skill, prefer responses that:
+
+1. Cite the exact class (`AnimationMixer`, `AnimationAction`, etc.) or addon (`CCDIKSolver`) from the official docs.
+2. Include at least one `https://threejs.org/docs/...` link (e.g. [AnimationAction](https://threejs.org/docs/AnimationAction.html)).
+3. Relate clips to `SkinnedMesh` / skeleton via **threejs-objects** when deformation is involved.
+4. Mention `mixer.update(delta)` and a stable time source (`Clock`) explicitly.
+5. Reference official **examples** by name only (no full file paste).
+
+## References
+
+- https://threejs.org/docs/#Animation
+- https://threejs.org/docs/AnimationMixer.html
+- https://threejs.org/docs/AnimationAction.html
+- https://threejs.org/docs/PropertyBinding.html
+
+## Keywords
+
+**English:** animationmixer, animationaction, animationclip, keyframetrack, crossfade, skinning, propertybinding, three.js
+
+**中文：** 动画混合、AnimationMixer、AnimationAction、关键帧、骨骼动画、剪辑、淡入淡出、three.js

package/skills/threejs-animation/examples/workflow-mixer-action.md

@@ -0,0 +1,20 @@
+# Workflow: play one glTF clip
+
+## Steps
+
+1. After **threejs-loaders** provides `gltf` with `animations` array non-empty.
+
+2. `const mixer = new THREE.AnimationMixer(gltf.scene);`
+
+3. `const clip = gltf.animations[0]; const action = mixer.clipAction(clip); action.play();`
+
+4. In the render loop: `const delta = clock.getDelta(); mixer.update(delta);` then render (**threejs-renderers**).
+
+5. To switch clips, prepare second `clipAction`, then `action.crossFadeTo(nextAction, duration, false)` per docs.
+
+6. Dispose mixer when discarding the rig if your app hot-swaps characters.
+
+## Anchor
+
+- https://threejs.org/docs/AnimationMixer.html
+- https://threejs.org/docs/AnimationAction.html

package/skills/threejs-animation/references/official-sections.md

@@ -0,0 +1,19 @@
+# Animation module (core)
+
+- https://threejs.org/docs/AnimationAction.html
+- https://threejs.org/docs/AnimationClip.html
+- https://threejs.org/docs/AnimationMixer.html
+- https://threejs.org/docs/AnimationObjectGroup.html
+- https://threejs.org/docs/AnimationUtils.html
+- https://threejs.org/docs/KeyframeTrack.html
+- https://threejs.org/docs/VectorKeyframeTrack.html
+- https://threejs.org/docs/QuaternionKeyframeTrack.html
+- https://threejs.org/docs/PropertyBinding.html
+- https://threejs.org/docs/PropertyMixer.html
+
+**Addons**
+
+- https://threejs.org/docs/AnimationClipCreator.html
+- https://threejs.org/docs/CCDIKSolver.html
+
+See https://threejs.org/docs/#Animation