@leejungkiin/awkit 1.6.6 → 1.7.0

package/skills/storyboard-to-scene-pack/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: storyboard-to-scene-pack
+description: "Create end-to-end storyboard design packs for animation/video projects with continuity-safe per-scene prompts and reviewer-ready previews. Use when Codex needs to: (1) design a storyboard sheet, (2) generate prompts for each scene (default 8s per scene), (3) prepare keyframe image prompts with character/environment continuity, or (4) produce an HTML storyboard preview that shows each frame and its prompt."
+---
+
+# Storyboard To Scene Pack
+
+Build a reusable storyboard pipeline that turns one concept into a continuity-safe scene package and reviewable preview.
+
+## Workflow
+
+1. Collect a compact brief.
+2. Build continuity locks.
+3. Draft storyboard plan and panel prompts.
+4. Generate per-scene keyframe prompts (default `duration: 8s`).
+5. Produce preview output (hand-drawn storyboard prompt + HTML preview data).
+
+## Step 1: Collect Brief
+
+Capture only what is required:
+
+- Project title and one-line premise
+- Visual style (for example: pencil sketch, noir ink, watercolor)
+- Character list (name, role, physical anchors, wardrobe anchors)
+- Environment anchors (layout elements that must persist)
+- Total scene count and target duration per scene (default 8s)
+- Tone and camera language preferences
+
+If input is missing, assume safe defaults and continue.
+
+## Step 2: Build Continuity Locks
+
+Before generating scene prompts, define immutable anchors:
+
+- Character Bible: face/hair/body/clothes/props signatures
+- Environment Bible: spatial map and recurring objects
+- Time/lighting continuity: time-of-day and light direction
+- State continuity tokens: object states carried across scenes
+
+Use [continuity-checklist.md](references/continuity-checklist.md) to validate.
+
+## Step 3: Draft Storyboard Plan
+
+Create a panel plan first, then prompts:
+
+- Use a grid format (`3x4` default) with numbered panels
+- For each panel, define `scene`, `action`, `dialogue`, `camera`
+- Keep camera progression intentional (wide -> medium -> close-up as needed)
+- Include explicit shot/move labels when relevant (`WIDE SHOT`, `PAN LEFT`, `TILT UP`, `ZOOM IN`)
+
+For hand-drawn storyboard sheet generation, use [storyboard-sheet-template.md](references/storyboard-sheet-template.md).
+
+## Step 4: Generate Per-Scene Prompt Pack
+
+For each scene, output one prompt block with this schema:
+
+- `scene_id`
+- `duration_seconds` (default `8`)
+- `goal_of_scene`
+- `visual_prompt`
+- `camera_prompt`
+- `continuity_from_previous`
+- `negative_constraints`
+
+Prefer explicit continuity phrasing, for example: "same wardrobe as Scene 03", "knife remains in right hand", "steam intensity reduced from prior scene".
+
+Use [scene-prompt-template.md](references/scene-prompt-template.md).
+
+## Step 5: Produce Preview Artifacts
+
+Always provide these outputs:
+
+- Hand-drawn storyboard sheet prompt (single-sheet overview)
+- Scene prompt list (JSON or Markdown table)
+- HTML preview mapping each frame to its prompt and continuity notes
+
+Use [preview-template/index.html](assets/preview-template/index.html) as the base layout.
+
+## Output Contract
+
+Return outputs in this structure:
+
+- `storyboard/handdrawn_storyboard_prompt.md`
+- `storyboard/scene_prompts.json`
+- `preview/index.html`
+
+If scene images are already available, reference them in preview as:
+
+- `scenes/scene_01.png`
+- `scenes/scene_02.png`
+- `...`
+
+## Quality Gate
+
+Validate before finalizing:
+
+- Panel numbering is complete and ordered
+- Character and wardrobe continuity is preserved
+- Environment anchors stay consistent
+- Camera sequence supports narrative clarity
+- Every scene has explicit 8s duration (or user-specified override)
+- HTML preview contains both image slot and prompt text per scene

package/skills/storyboard-to-scene-pack/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Storyboard Scene Pack"
+  short_description: "Design storyboard and per-scene prompts"
+  default_prompt: "Use $storyboard-to-scene-pack to design a storyboard, generate per-scene 8s prompts, and produce an HTML preview."

package/skills/storyboard-to-scene-pack/assets/preview-template/index.html

@@ -0,0 +1,101 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width,initial-scale=1" />
+  <title>Storyboard Preview</title>
+  <style>
+    :root {
+      --bg: #f5f3ee;
+      --panel: #ffffff;
+      --ink: #1f1f1f;
+      --muted: #666;
+      --line: #ddd7cc;
+    }
+    body {
+      margin: 0;
+      font-family: "Avenir Next", "Segoe UI", sans-serif;
+      background: var(--bg);
+      color: var(--ink);
+    }
+    header {
+      padding: 20px;
+      border-bottom: 1px solid var(--line);
+      background: linear-gradient(180deg, #fff, #f7f4ee);
+    }
+    h1 { margin: 0 0 8px; font-size: 24px; }
+    .sub { margin: 0; color: var(--muted); }
+    main {
+      max-width: 1100px;
+      margin: 20px auto;
+      padding: 0 16px 24px;
+      display: grid;
+      grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+      gap: 16px;
+    }
+    article {
+      background: var(--panel);
+      border: 1px solid var(--line);
+      border-radius: 12px;
+      overflow: hidden;
+      box-shadow: 0 2px 8px rgba(0,0,0,0.04);
+    }
+    img {
+      width: 100%;
+      aspect-ratio: 16 / 9;
+      object-fit: cover;
+      background: #ece8de;
+      display: block;
+    }
+    .content { padding: 12px; }
+    .id { font-weight: 700; margin: 0 0 6px; }
+    .meta { color: var(--muted); font-size: 13px; margin: 0 0 10px; }
+    pre {
+      margin: 0;
+      white-space: pre-wrap;
+      font-family: "SF Mono", Consolas, monospace;
+      font-size: 12px;
+      line-height: 1.4;
+      background: #fbfaf7;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      padding: 8px;
+      max-height: 240px;
+      overflow: auto;
+    }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>Storyboard Scene Preview</h1>
+    <p class="sub">Replace `SCENES` in the inline script with your generated scene data.</p>
+  </header>
+  <main id="grid"></main>
+
+  <script>
+    const SCENES = [
+      {
+        scene_id: "SCENE_01",
+        duration_seconds: 8,
+        image: "../scenes/scene_01.png",
+        prompt: "Example prompt for scene 01",
+        continuity: "Initial scene"
+      }
+    ];
+
+    const grid = document.getElementById("grid");
+    SCENES.forEach(scene => {
+      const card = document.createElement("article");
+      card.innerHTML = `
+        <img src="${scene.image}" alt="${scene.scene_id}" />
+        <div class="content">
+          <p class="id">${scene.scene_id}</p>
+          <p class="meta">Duration: ${scene.duration_seconds}s</p>
+          <pre>${scene.prompt}\n\nContinuity: ${scene.continuity}</pre>
+        </div>
+      `;
+      grid.appendChild(card);
+    });
+  </script>
+</body>
+</html>

package/skills/storyboard-to-scene-pack/references/continuity-checklist.md

@@ -0,0 +1,32 @@
+# Continuity Checklist
+
+Use this checklist before approving scene prompts or keyframes.
+
+## Character Continuity
+
+- Face shape, hairstyle, and age cues remain stable
+- Wardrobe palette and core accessories remain stable
+- Signature props stay present or are intentionally removed
+
+## Environment Continuity
+
+- Primary layout remains consistent (major objects do not teleport)
+- Lighting direction and intensity progress logically
+- Background density and style remain coherent
+
+## Action Continuity
+
+- Entry/exit direction between adjacent scenes is consistent
+- Handedness stays stable for held objects
+- Object states evolve logically (raw -> chopped -> cooked)
+
+## Camera Continuity
+
+- Shot changes are motivated, not random
+- Camera move labels match visual intent
+- Close-up inserts still preserve geography from master shots
+
+## Timing Continuity
+
+- Each scene uses `duration_seconds: 8` unless overridden
+- Motion intent is clear for an 8-second beat

package/skills/storyboard-to-scene-pack/references/scene-prompt-template.md

@@ -0,0 +1,19 @@
+# Scene Prompt Template
+
+```yaml
+scene_id: SCENE_01
+duration_seconds: 8
+goal_of_scene: "Introduce conflict at the prep station"
+visual_prompt: >
+  [Describe composition, characters, action, environment details, and style]
+camera_prompt: >
+  [Shot type, lens feel, movement direction, framing priority]
+continuity_from_previous: >
+  [Explicit carry-over from prior scene: wardrobe, prop state, lighting]
+negative_constraints:
+  - "No extra characters"
+  - "No wardrobe change"
+  - "No prop position reset"
+```
+
+Prefer concrete language over abstract adjectives.

package/skills/storyboard-to-scene-pack/references/storyboard-sheet-template.md

@@ -0,0 +1,14 @@
+# Storyboard Sheet Prompt Template
+
+Use this when generating the single-page hand-drawn overview.
+
+```text
+A full, professional storyboard sheet for "{PROJECT_TITLE}", in {STYLE} black-and-white hand-drawn pencil sketch style.
+Layout: clean {GRID} grid with numbered panels.
+Title text: "{TITLE_LINE}".
+Each panel: characters {CHARACTERS} performing key action beats in {ENVIRONMENT}.
+Below each panel: stylized handwritten production notes for SCENE, ACTION, DIALOGUE, CAMERA.
+Include camera labels where relevant: CLOSE-UP, PAN LEFT, WIDE SHOT, TILT UP, ZOOM IN.
+Include a right-side section: "NOTES / PLAN UPDATES" with bullet notes.
+Keep linework consistent, organized layout, white background.
+```

package/skills/verification-gate/SKILL.md

@@ -153,6 +153,10 @@ Trước khi claim DONE, kiểm tra **mỗi item** dưới đây:
 ☐ Backwards compatibility: Breaking changes documented?
 ☐ Localization (I18N): Text UI mới đã được thêm vào Localizable.strings (EN & VI) chưa?
   → Việc bọc `Localized()` trong code là chưa đủ. Phải THỰC SỰ mở file .strings (hoặc chạy update_strings.py) để bổ sung key/value trước khi báo cáo DONE.
+☐ App Store Compliance (iOS Only): Đã tuân thủ App Store Review Guidelines chưa?
+  → Background Modes (VD: UIBackgroundModes `location`) phải hợp lệ và thực sự CẦN THIẾT (Guideline 2.5.4). Khai báo thừa sẽ bị reject.
+  → Thu thập dữ liệu (Track user, Quảng cáo/Sức khoẻ) PHẢI có App Tracking Transparency (`NSUserTrackingUsageDescription`) (Guideline 5.1.2(i)).
+  → Tài sản/API bên thứ 3 (VD: Apple Weather) PHẢI hiển thị đầy đủ trademark attribution và link legal source (Guideline 5.2.5).
 ```
 
 **Nếu thiếu bất kỳ item nào → report DONE_WITH_CONCERNS, không DONE.**

package/templates/help.html

@@ -328,6 +328,27 @@ symphony task block &lt;id&gt; "Lý do"   # Đánh dấu bị chặn vì lỗi</
                 <p>Hệ thống AI AWKit sẽ <strong>luôn tự động</strong> thực hiện các hành động trên cho bạn trong quá trình thực thi hệ thống 7-Gate. Bạn không cần gõ lệnh thủ công trừ khi muốn kiểm tra tiến độ.</p>
             </div>
 
+            <div class="card">
+                <h2>🗣️ Giao Tiếp & Caveman Mode</h2>
+                <p>AWKit hỗ trợ chế độ <strong>Caveman Mode</strong> – giúp AI giao tiếp cực kỳ súc tích, lược bỏ các từ thừa, lời chào hỏi và giải thích dài dòng. Điều này giúp tiết kiệm 75% Token và tăng tốc độ phản hồi.</p>
+                
+                <h3>Cách Cấu Hình (Trong <code>.project-identity</code>):</h3>
+                <pre><code>"communication": {
+  "cavemanMode": {
+    "enabled": true,    // Bật hoặc tắt
+    "level": "full"      // Các mức độ: lite, full, ultra
+  }
+}</code></pre>
+
+                <h3>Các Mức Độ Nén:</h3>
+                <ul>
+                    <li><strong>lite:</strong> Chỉ lược bỏ lời chào và câu sáo rỗng.</li>
+                    <li><strong>full:</strong> Nói cụt lủn, bỏ trợ từ, ưu tiên từ khóa kỹ thuật.</li>
+                    <li><strong>ultra:</strong> Chỉ dùng từ khóa và ký hiệu (e.g. <code>Fix bug A -> Done.</code>).</li>
+                </ul>
+                <p><em>⚠️ Lưu ý: Ở các tác vụ nguy hiểm (Xóa file, Deploy), AI sẽ tự động tắt chế độ này để cảnh báo rõ ràng cho bạn.</em></p>
+            </div>
+
             <div class="card">
                 <h2>🔌 Tích Hợp Dự Án (Trello & Telegram & Neural Memory)</h2>
                 

package/templates/project-identity/android.json

@@ -23,6 +23,12 @@
     "indentation": "spaces-4",
     "lineLength": 120
   },
+  "communication": {
+    "cavemanMode": {
+      "enabled": false,
+      "level": "full"
+    }
+  },
   "createdDate": "{{DATE}}",
   "lastUpdated": "{{DATE}}",
   "automation": {
@@ -50,6 +56,24 @@
     "git": {
       "autoCommit": true,
       "autoPush": true
+    },
+    "obsidian": {
+      "enabled": false,
+      "path": "",
+      "autoSync": false
+    },
+    "mcp": {
+      "pixel-mcp": {
+        "enabled": false
+      }
+    }
+  },
+  "modelPolicy": {
+    "mode": "auto",
+    "defaultTier": "STANDARD",
+    "tierOverrides": {
+      "*.plist|*.json|*.env": "LIGHT",
+      "docs/*": "LIGHT"
     }
   }
 }

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

@@ -19,6 +19,12 @@
     "indentation": "spaces-2",
     "lineLength": 100
   },
+  "communication": {
+    "cavemanMode": {
+      "enabled": false,
+      "level": "full"
+    }
+  },
   "createdDate": "{{DATE}}",
   "lastUpdated": "{{DATE}}",
   "automation": {
@@ -46,6 +52,24 @@
     "git": {
       "autoCommit": true,
       "autoPush": true
+    },
+    "obsidian": {
+      "enabled": false,
+      "path": "",
+      "autoSync": false
+    },
+    "mcp": {
+      "pixel-mcp": {
+        "enabled": false
+      }
+    }
+  },
+  "modelPolicy": {
+    "mode": "auto",
+    "defaultTier": "STANDARD",
+    "tierOverrides": {
+      "*.plist|*.json|*.env": "LIGHT",
+      "docs/*": "LIGHT"
     }
   }
 }

package/templates/project-identity/expo.json

@@ -22,6 +22,12 @@
     "indentation": "spaces-2",
     "lineLength": 100
   },
+  "communication": {
+    "cavemanMode": {
+      "enabled": false,
+      "level": "full"
+    }
+  },
   "createdDate": "{{DATE}}",
   "lastUpdated": "{{DATE}}",
   "automation": {
@@ -49,6 +55,24 @@
     "git": {
       "autoCommit": true,
       "autoPush": true
+    },
+    "obsidian": {
+      "enabled": false,
+      "path": "",
+      "autoSync": false
+    },
+    "mcp": {
+      "pixel-mcp": {
+        "enabled": false
+      }
+    }
+  },
+  "modelPolicy": {
+    "mode": "auto",
+    "defaultTier": "STANDARD",
+    "tierOverrides": {
+      "*.plist|*.json|*.env": "LIGHT",
+      "docs/*": "LIGHT"
     }
   }
 }

package/templates/project-identity/ios.json

@@ -22,6 +22,12 @@
     "indentation": "spaces-4",
     "lineLength": 120
   },
+  "communication": {
+    "cavemanMode": {
+      "enabled": false,
+      "level": "full"
+    }
+  },
   "createdDate": "{{DATE}}",
   "lastUpdated": "{{DATE}}",
   "automation": {
@@ -49,6 +55,24 @@
     "git": {
       "autoCommit": true,
       "autoPush": true
+    },
+    "obsidian": {
+      "enabled": false,
+      "path": "",
+      "autoSync": false
+    },
+    "mcp": {
+      "pixel-mcp": {
+        "enabled": false
+      }
+    }
+  },
+  "modelPolicy": {
+    "mode": "auto",
+    "defaultTier": "STANDARD",
+    "tierOverrides": {
+      "*.plist|*.json|*.env": "LIGHT",
+      "docs/*": "LIGHT"
     }
   }
 }

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

@@ -19,6 +19,12 @@
     "indentation": "spaces-2",
     "lineLength": 100
   },
+  "communication": {
+    "cavemanMode": {
+      "enabled": false,
+      "level": "full"
+    }
+  },
   "createdDate": "{{DATE}}",
   "lastUpdated": "{{DATE}}",
   "automation": {
@@ -46,6 +52,24 @@
     "git": {
       "autoCommit": true,
       "autoPush": true
+    },
+    "obsidian": {
+      "enabled": false,
+      "path": "",
+      "autoSync": false
+    },
+    "mcp": {
+      "pixel-mcp": {
+        "enabled": false
+      }
+    }
+  },
+  "modelPolicy": {
+    "mode": "auto",
+    "defaultTier": "STANDARD",
+    "tierOverrides": {
+      "*.plist|*.json|*.env": "LIGHT",
+      "docs/*": "LIGHT"
     }
   }
 }