@leejungkiin/awkit 1.5.4 → 1.5.6

package/skill-packs/threejs/skills/threejs-webxr/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: threejs-webxr
+description: "WebXR integration for three.js: WebXRManager and XRManager on the renderer, session initialization patterns, VRButton and ARButton helpers, XRControllerModelFactory and hand model families, XREstimatedLight, XRPlanes, and related addon Webxr utilities. Use for immersive sessions and controller/hand tracking—not for standard desktop camera projection (threejs-camera) or composer post effects (threejs-postprocessing)."
+---
+
+## When to use this skill
+
+**ALWAYS use this skill when the user mentions:**
+
+- Entering VR/AR, `navigator.xr`, reference spaces, session `requestAnimationFrame` loop via renderer
+- `VRButton`, `ARButton`, `XRButton` creation patterns from examples
+- Controller models, hand tracking meshes, estimated real-world lighting probes
+
+**IMPORTANT: webxr vs renderers vs camera**
+
+| Topic | Skill |
+|-------|--------|
+| Enable XR on renderer, sizing | **threejs-renderers** (basics) + **threejs-webxr** (session) |
+| Desktop projection | **threejs-camera** |
+
+**Trigger phrases include:**
+
+- "WebXR", "VRButton", "ARButton", "XRControllerModelFactory", "hand tracking"
+- "虚拟现实", "增强现实", "沉浸式"
+
+## How to use this skill
+
+1. **HTTPS** requirement and feature detection for XR availability.
+2. **Buttons**: use official button factories to create DOM entry points; handle session end.
+3. **Renderer**: call `renderer.xr.enabled = true` patterns per docs; prefer `setAnimationLoop` for XR loops.
+4. **Controllers**: attach models via factories; read gamepad axes/buttons carefully with fallbacks.
+5. **Hands**: opt-in hand models when runtime supports; performance implications.
+6. **Lighting**: `XREstimatedLight` for AR realism—combine with **threejs-lights** cautiously.
+7. **Exit**: restore non-XR render loop and resize handling on session end.
+
+### Example: VR session with error handling
+
+```javascript
+import { VRButton } from 'three/addons/webxr/VRButton.js';
+
+// Feature detection and session start
+if ('xr' in navigator) {
+  renderer.xr.enabled = true;
+  document.body.appendChild(VRButton.createButton(renderer));
+
+  renderer.xr.addEventListener('sessionstart', () => {
+    console.log('XR session started');
+  });
+  renderer.xr.addEventListener('sessionend', () => {
+    console.log('XR session ended — restoring desktop view');
+  });
+} else {
+  console.warn('WebXR not supported in this browser');
+}
+```
+
+See [examples/workflow-xr-button.md](examples/workflow-xr-button.md).
+
+## Doc map (official)
+
+| Docs section | Representative links |
+|--------------|----------------------|
+| Renderer XR | https://threejs.org/docs/WebXRManager.html |
+| Webxr addons | https://threejs.org/docs/VRButton.html |
+| Webxr addons | https://threejs.org/docs/ARButton.html |
+| Webxr addons | https://threejs.org/docs/XRControllerModelFactory.html |
+
+## Scope
+
+- **In scope:** Documented WebXR manager + listed addons for buttons/controllers/hands/planes.
+- **Out of scope:** Store submission, OpenXR runtime specifics, custom native layers.
+
+## Common pitfalls and best practices
+
+- Desktop testing requires XR emulation or hardware; fail gracefully.
+- Mismatched reference space causes floor offset—validate stage vs local-floor.
+- Heavy post chains may not meet VR frame time—profile aggressively.
+
+## Documentation and version
+
+WebXR entry points span **Addons → Webxr** and renderer [`WebXRManager`](https://threejs.org/docs/WebXRManager.html) in [three.js docs](https://threejs.org/docs/). Browser and device capabilities vary—answers should cite the official example name and three.js version when possible.
+
+## Agent response checklist
+
+When answering under this skill, prefer responses that:
+
+1. Link `WebXRManager`, `VRButton`, `ARButton`, or controller factories as relevant.
+2. Use `setAnimationLoop` patterns with **threejs-renderers** for XR render loops.
+3. Avoid duplicating desktop **threejs-camera** projection advice for XR eyes.
+4. Mention reference space choice (local-floor, etc.) at a high level with docs link.
+5. Flag performance interaction with **threejs-postprocessing** in VR.
+
+## References
+
+- https://threejs.org/docs/WebXRManager.html
+- https://threejs.org/docs/VRButton.html
+- https://threejs.org/docs/ARButton.html
+- https://threejs.org/docs/XRControllerModelFactory.html
+
+## Keywords
+
+**English:** webxr, vr, ar, xr session, controller, hand tracking, three.js
+
+**中文：** WebXR、VR、AR、VRButton、手柄、手部追踪、沉浸式、three.js

package/skill-packs/threejs/skills/threejs-webxr/examples/workflow-xr-button.md

@@ -0,0 +1,15 @@
+# Workflow: VR entry button
+
+## Steps
+
+1. Ensure site served over HTTPS and `navigator.xr` checked.
+
+2. `document.body.appendChild(VRButton.createButton(renderer));` per [VRButton](https://threejs.org/docs/VRButton.html) for your three version.
+
+3. `renderer.xr.enabled = true;` Use `renderer.setAnimationLoop` callback for render + updates.
+
+4. Handle session end to restore window `resize` behavior if needed.
+
+5. For AR passthrough use `ARButton` instead—see **threejs-webxr** doc map.
+
+Always verify against the official example that matches your three.js revision.

package/skills/codex-conductor/SKILL.md

@@ -38,7 +38,7 @@ Codex CLI         = Inspector — debug, review, verify, test
 
 ```bash
 which codex || command -v codex
-# If not installed: npm i -g @openai/codex
+# NOTE: If not installed, IMMEDIATELY fallback to IDE context. DO NOT ask user to install.
 ```
 
 ## 🎯 Trigger Conditions
@@ -88,9 +88,9 @@ cd <PROJECT_ROOT> && timeout 180 codex exec \
 | Event | Action |
 |-------|--------|
 | Success | Parse → save report → summarize → suggest fixes |
-| Timeout | "⏳ Timed out (>120s)" → fallback Antigravity-only |
-| Error | Check `codex --version` → suggest install |
-| Not installed | Ask user to install |
+| Timeout | "⏳ Timed out (>120s)" → fallback Antigravity-only smoothly |
+| Error | Fallback Antigravity-only smoothly. Do NOT ask user to install |
+| Not installed | Fallback Antigravity-only smoothly. Do NOT ask user to install |
 
 ## 📁 Report Structure
 

package/skills/gemini-conductor/SKILL.md

@@ -194,8 +194,9 @@ on_timeout:
   - Fall back to Antigravity-only analysis
 
 on_error:
-  - Log: "⚠️ CLI invocation failed, continuing without conductor"
-  - Do NOT block the workflow — CLI is enhancement, not dependency
+  - Log: "⚠️ CLI invocation failed or not set up, continuing without conductor"
+  - IMMEDIATELY fallback to Antigravity-only mode
+  - Do NOT ask the user to install or authenticate the CLI. It is strictly optional
 ```
 
 ---

package/skills/telegram-notify/SKILL.md

@@ -55,3 +55,4 @@ awkit tg send --chat -100xxx --topic 456 --parse-mode md "**Done!**"
 3. **Use Markdown** for formatted messages (`--parse-mode md`)
 4. **Config location**: `~/.gemini/antigravity/.tg_config.json`
 5. If `awkit tg send` returns error about config, tell user to run `awkit tg setup`
+6. **Per-Project Automation**: AWKit CLI automatically reads `.project-identity` > `automation.telegram` to override `chatId`/`topicId` per project, or completely skip sending if `enabled: false`.

package/skills/trello-sync/SKILL.md

@@ -90,6 +90,13 @@ Lần 3 (vẫn lỗi): báo user "Trello chưa được cấu hình. Vui lòng c
 ### Tự Động Hóa Qua `awkit trello` (BẮT BUỘC)
 
 AI không cần tự inject ENV hay tìm kiếm cấu hình. Công cụ lệnh `awkit trello` v1.3.0+ sẽ TỰ ĐỘNG đọc từ env vars và `.project-identity`. MỌI thao tác Trello phải đi qua `awkit trello`.
+
+> **Proactive Auto-Sync Rule:** Nếu `.project-identity` có `automation.trello.autoSync: true`, AI **BẮT BUỘC** tự động gọi lệnh Trello tại các trigger points mà không cần user yêu cầu:
+> - Từng task complete → `awkit trello complete "<tên>"` + comment progress.
+> - Đạt milestone (chuyển Gate, đạt 40/60/80%) → `awkit trello comment`.
+> - Gặp lỗi Blocked → `awkit trello block`.
+> *(Nếu `autoSync: false` hoặc không có config, AI tiếp tục chế độ bị động).*
+
 ---
 
 ## 📚 Command Reference

package/templates/project-identity/android.json

@@ -24,5 +24,30 @@
     "lineLength": 120
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "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
+    }
+  }
 }

package/templates/project-identity/backend-nestjs.json

@@ -20,5 +20,30 @@
     "lineLength": 100
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "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
+    }
+  }
 }

package/templates/project-identity/expo.json

@@ -23,5 +23,30 @@
     "lineLength": 100
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "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
+    }
+  }
 }

package/templates/project-identity/ios.json

@@ -23,5 +23,30 @@
     "lineLength": 120
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "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
+    }
+  }
 }

package/templates/project-identity/web-nextjs.json

@@ -20,5 +20,30 @@
     "lineLength": 100
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "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
+    }
+  }
 }