@musashishao/agent-kit 1.8.2 → 1.9.1

package/.agent/skills/game-development/spec-ecosystem/templates/SPEC-template.md

@@ -0,0 +1,110 @@
+# SPEC Template for Game Projects
+
+> Template for creating game specifications. Replace placeholders with actual content.
+
+---
+
+## 📝 Problem Statement
+
+### Vấn đề hiện tại
+[Describe the problem this game/feature solves. Include measurable impact if available.]
+
+**Example:**
+> Người chơi mobile thường bỏ game casual sau 3-5 phút vì gameplay lặp lại. 
+> Cần game có core loop hấp dẫn giữ người chơi ít nhất 15 phút/session.
+
+---
+
+## 👥 User Stories
+
+| Priority | User Story |
+|----------|------------|
+| **P0** | Là **[user type]**, tôi muốn **[action]** để **[benefit]**. |
+| **P1** | Là **[user type]**, tôi muốn **[action]** để **[benefit]**. |
+| **P2** | Là **[user type]**, tôi muốn **[action]** để **[benefit]**. |
+
+**Example:**
+| Priority | User Story |
+|----------|------------|
+| **P0** | Là **người chơi casual**, tôi muốn **gameplay one-hand** để **chơi trên bus/metro**. |
+| **P1** | Là **người chơi**, tôi muốn **xem tiến độ rõ ràng** để **biết mình đang ở đâu**. |
+
+---
+
+## ✅ Acceptance Criteria
+
+| ID | Criterion | Testable? |
+|----|-----------|-----------|
+| AC1 | [Specific, measurable criterion] | ✅/❌ |
+| AC2 | [Specific, measurable criterion] | ✅/❌ |
+| AC3 | [Specific, measurable criterion] | ✅/❌ |
+
+**Example:**
+| ID | Criterion | Testable? |
+|----|-----------|-----------|
+| AC1 | Game load trong < 3 giây trên device 2GB RAM | ✅ |
+| AC2 | Tutorial hoàn thành trong < 60 giây | ✅ |
+| AC3 | Core loop rõ ràng: Action → Reward → Progression | ✅ |
+
+---
+
+## 🚫 Out of Scope
+
+| Item | Lý do |
+|------|-------|
+| [Feature NOT included] | [Why deferred] |
+| [Edge case NOT handled] | [Why excluded] |
+| [Platform NOT supported] | [Why not MVP] |
+
+**Example:**
+| Item | Lý do |
+|------|-------|
+| Multiplayer | Quá phức tạp cho MVP, xem xét v2 |
+| Cloud save | Chỉ cần local save cho prototype |
+| IAP | Chưa cần monetization cho soft launch |
+
+---
+
+## 🔧 Technical Constraints
+
+| Constraint | Requirement |
+|------------|-------------|
+| **Target Platform** | [iOS/Android/Web/PC] |
+| **Engine** | [Unity/Godot/Phaser] |
+| **Min Spec** | [Device requirements] |
+| **Integration** | [Must work with X] |
+
+**Example:**
+| Constraint | Requirement |
+|------------|-------------|
+| **Target Platform** | Android 8+ & iOS 14+ |
+| **Engine** | Unity 6 LTS |
+| **Min Spec** | 2GB RAM, GPU OpenGL ES 3.0 |
+| **Integration** | Firebase Analytics |
+
+---
+
+## 🎮 Game-Specific Details
+
+### Core Loop
+```
+[Action] → [Reward] → [Progression]
+```
+
+### Art Direction
+[Brief description of visual style]
+
+### Audio Direction
+[Brief description of sound/music style]
+
+### Monetization (if applicable)
+[F2P/Premium/Hybrid + high-level strategy]
+
+---
+
+## ✅ Approval
+
+> [!IMPORTANT]
+> Spec này cần được User approve trước khi chuyển sang PLAN.
+
+**Approved by:** [Name/Date]

package/.agent/skills/game-development/spec-ecosystem/templates/TASKS-template.md

@@ -0,0 +1,156 @@
+# TASKS Template for Game Projects
+
+> Executable task list generated from PLAN. Track progress with checkboxes.
+
+---
+
+## 📋 Project Info
+
+**Game:** [Game Name]
+**Based on:** `PLAN-{game-slug}.md`
+**Started:** [Date]
+**Target Completion:** [Date]
+
+---
+
+## 📊 Progress Overview
+
+| Phase | Status | Progress |
+|-------|--------|----------|
+| Phase 1: Core Systems | 🔄 | 0/X tasks |
+| Phase 2: Gameplay | ⏳ | 0/X tasks |
+| Phase 3: UI & Polish | ⏳ | 0/X tasks |
+| Phase 4: Audio & Effects | ⏳ | 0/X tasks |
+| Phase X: Verification | ⏳ | 0/X checks |
+
+**Legend:** ✅ Done | 🔄 In Progress | ⏳ Waiting | ❌ Blocked
+
+---
+
+## Phase 1: Core Systems
+
+### 1.1 [Task Name]
+- [ ] **Task:** [Description]
+- **Agent:** `[agent-name]`
+- **Input:** [What's needed]
+- **Output:** [What's produced]
+- **Verify:** [How to check done]
+- **Notes:** [Any additional context]
+
+### 1.2 [Task Name]
+- [ ] **Task:** [Description]
+- **Agent:** `[agent-name]`
+- **Depends on:** 1.1
+- **Input:** [What's needed]
+- **Output:** [What's produced]
+- **Verify:** [How to check done]
+
+---
+
+## Phase 2: Gameplay
+
+### 2.1 [Task Name]
+- [ ] **Task:** [Description]
+- **Agent:** `[agent-name]`
+- **Depends on:** Phase 1
+- **Input:** [What's needed]
+- **Output:** [What's produced]
+- **Verify:** [How to check done]
+
+### 2.2 [Task Name]
+- [ ] **Task:** [Description]
+- **Agent:** `[agent-name]`
+- **Depends on:** 2.1
+- **Input:** [What's needed]
+- **Output:** [What's produced]
+- **Verify:** [How to check done]
+
+---
+
+## Phase 3: UI & Polish
+
+### 3.1 [Task Name]
+- [ ] **Task:** [Description]
+- **Agent:** `[agent-name]`
+- **Depends on:** Phase 2
+- **Input:** [What's needed]
+- **Output:** [What's produced]
+- **Verify:** [How to check done]
+
+---
+
+## Phase 4: Audio & Effects
+
+### 4.1 [Task Name]
+- [ ] **Task:** [Description]
+- **Agent:** `[agent-name]`
+- **Depends on:** None (parallel)
+- **Input:** [What's needed]
+- **Output:** [What's produced]
+- **Verify:** [How to check done]
+
+---
+
+## Phase X: Verification
+
+### Build Verification
+- [ ] **Build compiles without errors**
+  - Command: `[build command]`
+  - Expected: Build artifact created
+
+- [ ] **Build size acceptable**
+  - Target: < [X] MB
+  - Actual: [X] MB
+
+### Performance Verification
+- [ ] **Frame rate stable**
+  - Target: 60 FPS on [device]
+  - Test: Play for 5 minutes
+
+- [ ] **Memory usage acceptable**
+  - Target: < [X] MB peak
+  - Test: Profile for 10 minutes
+
+### Feature Verification
+- [ ] **Core loop works**
+  - Test: [Action] → [Reward] → [Progression]
+
+- [ ] **All AC from SPEC met**
+  - [ ] AC1: [criterion]
+  - [ ] AC2: [criterion]
+  - [ ] AC3: [criterion]
+
+### Quality Verification
+- [ ] **No critical bugs**
+- [ ] **Audio plays correctly**
+- [ ] **Save/Load works**
+- [ ] **UI responsive on all supported devices**
+
+---
+
+## 📝 Session Log
+
+### [Date] - Session 1
+**Completed:**
+- [x] Task 1.1
+- [x] Task 1.2
+
+**Blockers:**
+- [None / Description of blocker]
+
+**Next Session:**
+- [ ] Task 2.1
+
+---
+
+## ✅ Completion
+
+> [!NOTE]
+> Đánh dấu khi TOÀN BỘ tasks và Phase X hoàn thành.
+
+- [ ] **All tasks completed**
+- [ ] **Phase X verification passed**
+- [ ] **CHANGELOG updated**
+
+**Completed on:** [Date]
+**Total time:** [X hours/days]