@leejungkiin/awkit 1.5.5 → 1.6.0

package/README.md

@@ -1,6 +1,6 @@
-# AWKit — Antigravity Workflow Kit v1
+# AWKit — Antigravity Workflow Kit v12.5
 
-> **v1.5.0** · Single Source of Truth · Symphony-First · Ambient Memory
+> **v12.5.0** · Single Source of Truth · Symphony-First · Mindful Execution
 
 AWKit là framework điều phối AI agent chuyên nghiệp. Đây là **nơi duy nhất** chứa toàn bộ workflows, skills, GEMINI.md và cấu hình — không còn phân tán giữa nhiều repo.
 
@@ -18,6 +18,7 @@ AWKit (Antigravity v12+) thực thi 8 nguyên tắc lõi (Gstack-inspired) nhằ
 6. **Scope Freeze:** Khi debugging: KHÔNG sửa code không liên quan, KHÔNG refactor. Chỉ tập trung root cause.
 7. **Boil-the-Lake Checklist:** Checklist trước khi báo DONE: error handling, edge cases, logging, cleanup, input validation...
 8. **Safety Guardrails:** Chặn auto-run cho các lệnh nguy hiểm (`rm -rf`, `git push --force`, deploy production). Bắt buộc double-confirm.
+9. **Mindful Execution (v12.5+):** Chống AI "brain fry" bằng Iteration Counter (dừng sau 3 lần polish), Scope Guard, và Milestone Rest.
 
 ---
 
@@ -191,10 +192,10 @@ AWKit (từ bản cập nhật tích hợp mới) sử dụng **GitNexus** làm
 
 ```bash
 # 1. Quét toàn bộ project để tạo knowledge graph (chỉ cần chạy lần đầu hoặc khi cấu trúc code thay đổi lớn)
-npx @leejungkiin/gitnexus analyze
+npx @duytransipher/gitnexus analyze
 
 # 2. Setup MCP servers và skills tự động cho Antigravity và các editors khác:
-npx @leejungkiin/gitnexus setup
+npx @duytransipher/gitnexus setup
 ```
 
 AI agent của hệ thống cũng tự động gọi qua cổng GitNexus bằng MCP Tools để tự phân tích rủi ro trước khi commit!
@@ -219,6 +220,7 @@ awkit enable-pack creator-studio
 | 6.x | AWF v6 | main-awf, multiple sources |
 | **1.1.x** | **AWKit v1.1.9** | **Single source of truth, Native CLI, Telegram Integration** |
 | **1.5.x** | **AWKit v1.5.0** | **Unified Orchestration, Symphony 1.5.0, 7-Gate Intelligence** |
+| **12.5.x** | **Antigravity v12.5** | **Mindful Checkpoints (TP-ITER, TP-SCOPE, TP-REST), @duytransipher/gitnexus** |
 
 ---
 

package/bin/awk.js

@@ -38,6 +38,7 @@ const HOME = process.env.HOME || process.env.USERPROFILE;
 const { generateClineRules, generateClineWorkflows, generateClineSkills } = require('./cline-generators');
 const { generateCodexAgentsMd, generateCodexSkills, generateCodexAgents } = require('./codex-generators');
 const { generateClaudeRules, generateClaudeSkills } = require('./claude-generators');
+const { cmdGate } = require('../scripts/automation-gate');
 
 // ─── Platform Definitions ──────────────────────────────────────────────────
 
@@ -280,7 +281,8 @@ function readInstallState(platform = activePlatform) {
     const fallback = {
         version: 1,
         profile: getDefaultSkillProfileName(),
-        enabledPacks: []
+        enabledPacks: [],
+        activeMode: null
     };
     return readJsonFile(getInstallStatePath(platform), fallback) || fallback;
 }
@@ -725,8 +727,7 @@ function cmdInstall(args = []) {
         }
 
         writeInstallState({
-            version: 1,
-            profile: getDefaultSkillProfileName(),
+            ...previousState,
             enabledPacks: activePacks
         }, platform);
         ok(`Install state saved (${desiredSkills.size} active skills)`);
@@ -1421,8 +1422,7 @@ function cmdEnablePack(packName, { autoMode = false } = {}) {
     const enabledPacks = new Set(state.enabledPacks || []);
     enabledPacks.add(packName);
     writeInstallState({
-        version: 1,
-        profile: getDefaultSkillProfileName(),
+        ...state,
         enabledPacks: [...enabledPacks].sort()
     });
 
@@ -1491,14 +1491,146 @@ function cmdDisablePack(packName) {
 
     const state = readInstallState();
     writeInstallState({
-        version: 1,
-        profile: getDefaultSkillProfileName(),
+        ...state,
         enabledPacks: (state.enabledPacks || []).filter(name => name !== packName)
     });
 
     ok(`Skill pack "${packName}" disabled (skills backed up to ${backupDir})`);
 }
 
+function loadWorkModes() {
+    const defaultsPath = path.join(AWK_ROOT, 'core', 'work-modes.json');
+    const userPath = path.join(HOME, '.awkit_modes.json');
+    const modes = readJsonFile(defaultsPath, { modes: {} }).modes || {};
+
+    if (fs.existsSync(userPath)) {
+        const userModes = readJsonFile(userPath, { modes: {} }).modes || {};
+        for (const [key, val] of Object.entries(userModes)) {
+            modes[key] = { ...modes[key], ...val };
+        }
+    }
+    return modes;
+}
+
+function cmdMode(args = []) {
+    const modes = loadWorkModes();
+    const state = readInstallState();
+
+    if (args.length === 0) {
+        log('');
+        log(`${C.cyan}${C.bold}🔄 AWK Work Modes${C.reset}`);
+        log('');
+
+        const active = state.activeMode;
+        if (active && modes[active]) {
+            log(`Current Mode: ${C.green}${C.bold}${active}${C.reset} - ${modes[active].description}`);
+        } else {
+            log(`Current Mode: ${C.yellow}core-only${C.reset}`);
+        }
+        log('');
+        log(`${C.cyan}Available Modes:${C.reset}`);
+        for (const [modeName, data] of Object.entries(modes)) {
+            if (data.hidden && modeName !== active) continue;
+            const marker = modeName === active ? `${C.green}▶${C.reset}` : ` `;
+            log(` ${marker} ${C.green}${modeName.padEnd(15)}${C.reset} ${C.gray}${data.description}${C.reset}`);
+        }
+        log('');
+        log(`${C.cyan}Commands:${C.reset}`);
+        log(`  awkit mode <name>             Switch to a mode`);
+        log(`  awkit mode --create <name> <pack1,pack2,...>`);
+        log(`  awkit mode --delete <name>`);
+        log(`  awkit mode --reset            Back to core-only`);
+        log('');
+        return;
+    }
+
+    const subCmd = args[0];
+
+    if (subCmd === '--reset') {
+        if (!state.activeMode) {
+            info(`Already in core-only mode.`);
+            return;
+        }
+        const activePacks = modes[state.activeMode]?.packs || [];
+        for (const p of activePacks) cmdDisablePack(p);
+
+        state.activeMode = null;
+        writeInstallState(state);
+        ok(`Disabled mode packs. Back to core-only.`);
+        return;
+    }
+
+    if (subCmd === '--create') {
+        const name = args[1];
+        const packsList = args[2];
+        if (!name || !packsList) {
+            err(`Usage: awkit mode --create <name> <pack1,pack2,...>`);
+            return;
+        }
+        const packs = packsList.split(',').map(s => s.trim()).filter(Boolean);
+        const userPath = path.join(HOME, '.awkit_modes.json');
+        const userConfig = readJsonFile(userPath, { version: 1, modes: {} }) || { version: 1, modes: {} };
+        if (!userConfig.modes) userConfig.modes = {};
+        userConfig.modes[name] = {
+            description: "Custom user mode",
+            packs
+        };
+        fs.writeFileSync(userPath, JSON.stringify(userConfig, null, 2));
+        ok(`Created custom mode: ${name} with packs: ${packs.join(', ')}`);
+        return;
+    }
+
+    if (subCmd === '--delete') {
+        const name = args[1];
+        const userPath = path.join(HOME, '.awkit_modes.json');
+        if (fs.existsSync(userPath)) {
+            const userConfig = readJsonFile(userPath, { version: 1, modes: {} });
+            if (userConfig?.modes?.[name]) {
+                delete userConfig.modes[name];
+                fs.writeFileSync(userPath, JSON.stringify(userConfig, null, 2));
+                ok(`Deleted custom mode: ${name}`);
+            } else {
+                err(`Mode '${name}' not found in user configs.`);
+            }
+        } else {
+            err(`No user modes config found.`);
+        }
+        return;
+    }
+
+    // Switch mode
+    const modeName = subCmd;
+    if (!modes[modeName]) {
+        err(`Work mode '${modeName}' not found.`);
+        return;
+    }
+
+    info(`Switching to mode: ${modeName}`);
+
+    const currentActive = state.activeMode;
+    if (currentActive && currentActive !== modeName && modes[currentActive]) {
+        const oldPacks = modes[currentActive].packs || [];
+        // Disable packs that are not in the new mode to avoid toggling what we want to keep
+        const newPacksSet = new Set(modes[modeName].packs || []);
+        for (const p of oldPacks) {
+            if (!newPacksSet.has(p)) {
+                cmdDisablePack(p);
+            }
+        }
+    }
+
+    const newPacks = modes[modeName].packs || [];
+    for (const p of newPacks) {
+        cmdEnablePack(p, { autoMode: true });
+    }
+
+    const freshState = readInstallState();
+    freshState.activeMode = modeName;
+    writeInstallState(freshState);
+
+    ok(`Successfully switched to mode: ${C.bold}${modeName}${C.reset}`);
+}
+
 function cmdListPacks() {
     const packsDir = path.join(AWK_ROOT, 'skill-packs');
 
@@ -1888,8 +2020,10 @@ function cmdHelp() {
     log('');
 
     // Packs
-    log(`${C.bold}📦  Skill Packs${C.reset}`);
+    log(`${C.bold}📦  Skill Packs & Modes${C.reset}`);
     log(line);
+    log(`  ${C.green}mode${C.reset}                Show active mode & list modes`);
+    log(`  ${C.green}mode <name>${C.reset}         Switch to a work mode`);
     log(`  ${C.green}list-packs${C.reset}          List available skill packs`);
     log(`  ${C.green}enable-pack${C.reset} <name>  Install a skill pack`);
     log(`  ${C.green}disable-pack${C.reset} <name> Uninstall a skill pack (backed up)`);
@@ -2354,6 +2488,32 @@ async function cmdInit(forceFlag = false) {
         } catch (_) { /* ignore */ }
     }
 
+    // ── 3.6. Automation config migration ─────────────────────────────────────────
+    try {
+        const currentIdentity = JSON.parse(fs.readFileSync(identityPath, 'utf8'));
+        if (!currentIdentity.automation) {
+            currentIdentity.automation = {
+                telegram: {
+                    enabled: true,
+                    chatId: "",
+                    topicId: "",
+                    triggers: { git_push: true, task_complete: false, deploy: true }
+                },
+                trello: {
+                    enabled: true,
+                    autoSync: true,
+                    triggers: { task_complete: true, milestone: true, blocked: true }
+                },
+                git: {
+                    autoCommit: true,
+                    autoPush: true
+                }
+            };
+            fs.writeFileSync(identityPath, JSON.stringify(currentIdentity, null, 2) + '\n');
+            ok('Added Automation config placeholder to .project-identity');
+        }
+    } catch (_) { /* ignore */ }
+
     const trelloCred = trelloLoadCredentials();
     if (!trelloCred) {
         log('');
@@ -2700,6 +2860,28 @@ function tgSend(args) {
     let chatId = config.default_chat_id;
     let topicId = config.default_topic_id || null;
     let parseMode = null;
+
+    // Apply .project-identity automation overrides
+    const pjPath = path.join(process.cwd(), '.project-identity');
+    if (fs.existsSync(pjPath)) {
+        try {
+            const pj = JSON.parse(fs.readFileSync(pjPath, 'utf8'));
+            if (pj?.automation?.telegram) {
+                const tgAuto = pj.automation.telegram;
+                if (tgAuto.enabled === false) {
+                    dim('Telegram notifications are disabled for this project (.project-identity).');
+                    return;
+                }
+                if (tgAuto.chatId) {
+                    chatId = tgAuto.chatId;
+                    // Reset topicId when chatId is overridden — global topicId belongs to global chatId
+                    topicId = null;
+                }
+                if (tgAuto.topicId && parseInt(tgAuto.topicId, 10) > 1) topicId = tgAuto.topicId;
+            }
+        } catch (e) { }
+    }
+
     const messageParts = [];
 
     for (let i = 0; i < args.length; i++) {
@@ -3329,6 +3511,9 @@ const [, , command, ...args] = process.argv;
         case 'browser':
             cmdBrowser(args);
             break;
+        case 'mode':
+            cmdMode(args);
+            break;
         case 'enable-pack':
             cmdEnablePack(args[0]);
             break;
@@ -3360,6 +3545,9 @@ const [, , command, ...args] = process.argv;
         case 'serve':
             cmdServe(args);
             break;
+        case 'gate':
+            cmdGate(args);
+            break;
         case 'admin':
             cmdAdmin();
             break;

package/core/GEMINI.md

@@ -49,14 +49,23 @@ Mỗi skill tự xử lý gate logic riêng — xem SKILL.md của từng skill.
 - AI models: Gemini 2.5+ only.
 - Firebase: Firebase AI Logic SDK.
 
-### Auto-Commit After Build (BẮT BUỘC)
-- Build thành công (0 errors) → **TỰ ĐỘNG** `git add` → `git commit` → `git push`.
-- KHÔNG hỏi user, KHÔNG chờ approval cho commit thường.
-- Commit message: conventional format (`fix:`, `feat:`, `refactor:`, `chore:`).
-- `git push` (non-force) được phép `SafeToAutoRun=true`.
-- Sau khi commit & push thành công → tự động gửi thông báo Telegram qua tool hoặc lệnh `awkit tg send` (nếu người dùng đã cấu hình Telegram, có thể bỏ qua nếu chưa).
-- Nếu push fail → retry 1 lần với `git pull --rebase && git push`.
-- Nếu vẫn fail → báo user, KHÔNG force push.
+### Automation Gate (BẮT BUỘC)
+- AI **PHẢI** dùng `awkit gate` thay vì gọi trực tiếp `git commit/push`, `awkit trello`, `awkit tg send`.
+- `awkit gate` tự đọc `.project-identity` → enforce `automation.*` config → execute hoặc block.
+- **Git:**
+  - `awkit gate git auto "message"` — commit + push + telegram notify (nếu enabled).
+  - `awkit gate git commit "message"` — chỉ commit.
+  - `awkit gate git push` — chỉ push.
+  - Commit message: conventional format (`fix:`, `feat:`, `refactor:`, `chore:`).
+  - Push fail → auto-retry 1 lần với `git pull --rebase`. Cấm force push.
+- **Trello:**
+  - `awkit gate trello complete "Task"` — gated trello complete.
+  - `awkit gate trello comment "Note"` — gated trello comment.
+  - `awkit gate trello block "Reason"` — gated trello block.
+- **Telegram:**
+  - `awkit gate telegram send "Message"` — gated telegram send.
+- **Dry-run:** `awkit gate check` — hiển thị trạng thái gate hiện tại (không execute).
+- ⛔ Gọi `git commit/push` hoặc `awkit trello/tg` trực tiếp (bypass gate) = **VI PHẠM**.
 
 ### 7-Gate Autonomous System (v12.3)
 - orchestrator PHẢI triage complexity (TRIVIAL/MODERATE/COMPLEX) trước mọi task.
@@ -124,6 +133,13 @@ Mỗi skill tự xử lý gate logic riêng — xem SKILL.md của từng skill.
 - Double-confirm với user trước khi chạy destructive command.
 - Nếu không chắc command có destructive hay không → hỏi trước.
 
+### Trello Auto-Sync (Per-Project Automation)
+- Nếu `.project-identity` có `automation.trello.autoSync: true` → AI **PHẢI** tự động kích hoạt Trello tại các trigger:
+  - Task complete → `awkit trello complete "<tên>"` + comment progress.
+  - Milestone (gate transition, 40/60/80%) → `awkit trello comment`.
+  - Blocked → `awkit trello block`.
+- Nếu `autoSync: false` hoặc không có config → chỉ sync khi user yêu cầu rõ ràng.
+
 ### 6 Decision Principles (Auto-decide)
 Khi AI cần tự quyết định mà không hỏi user:
 1. **Complete > Shortcuts** — Implement đủ, không bỏ edge cases.

package/core/work-modes.json

@@ -0,0 +1,45 @@
+{
+    "version": 1,
+    "modes": {
+        "mobile": {
+            "description": "Mobile app development (iOS, Android, Flutter)",
+            "packs": [
+                "mobile-ios",
+                "mobile-android",
+                "flutter"
+            ]
+        },
+        "ads": {
+            "description": "Monetization & ads optimization",
+            "packs": [
+                "ads-management"
+            ]
+        },
+        "marketing": {
+            "description": "ASO, UA, app marketing",
+            "packs": [
+                "marketing"
+            ]
+        },
+        "web": {
+            "description": "Web & desktop app development",
+            "packs": [
+                "electron"
+            ]
+        },
+        "game": {
+            "description": "Game & 3D development",
+            "packs": [
+                "cocos2d",
+                "threejs"
+            ]
+        },
+        "mod": {
+            "description": "Reverse engineering & modding",
+            "packs": [
+                "reverse-engineering"
+            ],
+            "hidden": true
+        }
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.5.5",
-  "description": "Antigravity Workflow Kit. Unified AI agent orchestration system.",
+  "version": "1.6.0",
+  "description": "Antigravity Workflow Kit v12.5. Unified AI agent orchestration system with Mindful Checkpoints.",
   "main": "bin/awk.js",
   "bin": {
     "awkit": "bin/awk.js",
@@ -38,6 +38,6 @@
   ],
   "dependencies": {
     "@leejungkiin/awkit-symphony": "^1.5.0",
-    "@leejungkiin/gitnexus": "file:../gitnexus/gitnexus"
+    "@duytransipher/gitnexus": "latest"
   }
 }

package/skill-packs/cocos2d/pack.json

@@ -0,0 +1,8 @@
+{
+    "name": "cocos2d",
+    "auto_install": false,
+    "description": "Game development capabilities using Cocos2d-x",
+    "skills": [
+        "cocos2d-x"
+    ]
+}

package/skill-packs/cocos2d/skills/cocos2d-x/LICENSE.txt

@@ -0,0 +1,8 @@
+This skill is based on the official Cocos2d-x v4 documentation.
+
+Official Documentation: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+Cocos2d-x is licensed under the MIT License.
+
+For complete license terms, please refer to:
+https://github.com/cocos2d/cocos2d-x/blob/v4/LICENSE

package/skill-packs/cocos2d/skills/cocos2d-x/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: cocos2d-x
+description: "Provides comprehensive guidance for Cocos2d-x v4 game engine including scene graph, nodes, sprites, actions, animations, physics, rendering, shaders, and platform deployment. Use when the user asks about Cocos2d-x, needs to create games, implement game features, set up development environments, or deploy games to multiple platforms."
+license: Complete terms in LICENSE.txt
+---
+
+## When to use this skill
+
+Use this skill whenever the user wants to:
+- Create Cocos2d-x v4 games or applications
+- Learn Cocos2d-x v4 core concepts (Node, Sprite, Scene, Action)
+- Set up Cocos2d-x v4 development environment
+- Work with sprites, textures, animations, and labels
+- Implement scene management and node lifecycle
+- Handle input events (touch, mouse, keyboard)
+- Use physics engine (Box2D) and collision detection
+- Implement rendering pipeline, shaders, and particle systems
+- Build and deploy games for multiple platforms (Windows, macOS, Linux, Android, iOS)
+- Use CMake build system and command-line tools
+- Migrate from older Cocos2d-x versions
+- Extend engine with custom rendering and script bindings
+
+## How to use this skill
+
+To work with Cocos2d-x v4:
+
+1. **Identify the topic** from the user's request:
+   - Engine overview/了解引擎 → `examples/getting-started/about-engine.md`
+   - Quick start/快速上手 → `examples/getting-started/quick-start.md`
+   - Installation/安装配置 → `examples/getting-started/installation.md`
+   - Node and Scene/节点和场景 → `examples/core/node-scene.md`
+   - Sprite/精灵 → `examples/core/sprite.md`
+   - Texture/纹理 → `examples/core/texture.md`
+   - Animation/动画 → `examples/core/animation.md`
+   - Action/动作 → `examples/core/action.md`
+   - Label/标签 → `examples/core/label.md`
+   - Scene management/场景管理 → `examples/core/scene.md`
+   - Input handling/输入处理 → `examples/core/input.md`
+   - Event system/事件系统 → `examples/core/event.md`
+   - Physics/物理引擎 → `examples/advanced/physics.md`
+   - Rendering/渲染 → `examples/advanced/rendering.md`
+   - Shaders/着色器 → `examples/advanced/shader.md`
+   - Particle system/粒子系统 → `examples/advanced/particle.md`
+   - Build system/构建系统 → `examples/tools/build-system.md`
+   - Platform deployment/平台部署 → `examples/tools/deployment.md`
+
+2. **Load the appropriate example file** from the `examples/` directory:
+   - `examples/getting-started/about-engine.md` - Engine overview and features
+   - `examples/getting-started/quick-start.md` - Create first project
+   - `examples/getting-started/installation.md` - Environment setup
+   - `examples/core/node-scene.md` - Node and Scene concepts
+   - `examples/core/sprite.md` - Sprite creation and manipulation
+   - `examples/core/texture.md` - Texture loading and management
+   - `examples/core/animation.md` - Animation system
+   - `examples/core/action.md` - Action system and sequences
+   - `examples/core/label.md` - Label and text rendering
+   - `examples/core/scene.md` - Scene management and transitions
+   - `examples/core/input.md` - Touch, mouse, and keyboard input
+   - `examples/core/event.md` - Event system and listeners
+   - `examples/advanced/physics.md` - Physics engine integration
+   - `examples/advanced/rendering.md` - Rendering pipeline
+   - `examples/advanced/shader.md` - Custom shaders
+   - `examples/advanced/particle.md` - Particle effects
+   - `examples/tools/build-system.md` - CMake and build configuration
+   - `examples/tools/deployment.md` - Platform-specific deployment
+
+3. **Follow the specific instructions** in that example file for syntax, structure, and best practices
+
+   Each example file contains:
+   - **Instructions**: Overview and usage guidelines
+   - **Syntax**: API syntax and parameters
+   - **Examples**: Complete code examples with explanations
+   - **Reference**: Links to official documentation
+
+4. **Generate C++ code** following Cocos2d-x v4 conventions:
+   - Use `USING_NS_CC;` for namespace
+   - Use `CREATE_FUNC()` macro for create functions
+   - Follow Cocos2d-x naming conventions
+   - Include proper error handling
+   - Use smart pointers where appropriate
+
+5. **Reference the official documentation**:
+   - Official manual: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+   - API reference: Check `api/` directory for detailed API documentation
+   - Examples: Check `examples/` directory for code examples
+
+6. **Use templates** when creating new projects:
+   - `templates/project-structure.md` - Standard project structure
+   - `templates/cmake-config.md` - CMake configuration examples
+
+
+### Doc mapping (one-to-one with official documentation)
+
+- See examples and API files → https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## Core Concepts
+
+### Node System
+- **Node**: Base class for all display objects
+- **Scene**: Root node of the scene graph
+- **Sprite**: Image display node
+- **Label**: Text display node
+- **Node hierarchy**: Parent-child relationships
+
+### Coordinate System
+- Origin at bottom-left (OpenGL style)
+- Anchor point for positioning
+- Local and world coordinates
+
+### Action System
+- **Action**: Base class for node transformations
+- **Sequence**: Chain multiple actions
+- **Spawn**: Run actions simultaneously
+- **Repeat**: Repeat actions multiple times
+- **Ease**: Apply easing functions
+
+### Scene Management
+- Scene transitions
+- Scene lifecycle (onEnter, onExit)
+- Director for scene management
+
+### Input Handling
+- Touch events (single and multi-touch)
+- Mouse events
+- Keyboard events
+- Event dispatcher system
+
+## Platform Support
+
+Cocos2d-x v4 supports:
+- **Desktop**: Windows, macOS, Linux
+- **Mobile**: Android, iOS
+- **Web**: (via Cocos Creator)
+
+## Build System
+
+- **CMake**: Primary build system
+- **Command-line tools**: `cocos` command
+- **IDE support**: Visual Studio, Xcode, Android Studio
+
+## Migration Guide
+
+For migrating from older versions:
+- Check `examples/migration/` for migration guides
+- API changes and compatibility notes
+- CMake migration from older build systems
+
+## Reference Resources
+
+- **Official Documentation**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **API Reference**: See `api/` directory
+- **Examples**: See `examples/` directory
+- **Templates**: See `templates/` directory
+
+## Keywords
+
+cocos2d-x, cocos2d, game engine, game development, C++ game, 2D game, cross-platform game, sprite, scene, node, action, animation, physics, rendering, shader, particle system, CMake, game framework, 游戏引擎, 游戏开发, 精灵, 场景, 节点, 动作, 动画, 物理引擎, 渲染, 着色器, 粒子系统
+
+## Important Notes
+
+1. **Version**: This skill covers Cocos2d-x v4 specifically
+2. **Language**: C++ is the primary development language
+3. **Build System**: CMake is required for building projects
+4. **Platform**: Ensure platform-specific dependencies are installed
+5. **Examples**: All code examples use C++ syntax
+6. **Memory Management**: Cocos2d-x uses reference counting, be careful with retain/release cycles
+7. **Coordinate System**: Uses OpenGL-style coordinates (origin at bottom-left)
+8. **Thread Safety**: Most Cocos2d-x operations must be performed on the main thread