@leejungkiin/awkit 1.0.6 → 1.0.8

package/skills/context-help/SKILL.md

@@ -1,180 +0,0 @@
----
-name: awf-context-help
-description: >-
-  Context-aware help based on current workflow state. Keywords: help, what,
-  how, confused, stuck, lost, guide, tutorial, explain.
-  Activates on /help or when user asks questions.
-version: 1.0.0
----
-
-# AWF Context Help
-
-Trợ giúp thông minh dựa trên context hiện tại.
-
-## Trigger Conditions
-
-**Activates when:**
-- User runs `/help`
-- User types "?", "giúp", "help", "làm sao"
-- User seems confused (repeated errors, long pause)
-
-## Execution Logic
-
-### Step 1: Read Context
-
-```
-context = {}
-
-if exists(".brain/session.json"):
-    context.workflow = session.working_on.feature
-    context.task = session.working_on.task
-    context.status = session.working_on.status
-    context.pending = session.pending_tasks
-
-if exists(".brain/brain.json"):
-    context.project = brain.project.name
-    context.tech = brain.tech_stack
-```
-
-### Step 2: Detect State
-
-| State | Detection | Response |
-|-------|-----------|----------|
-| `no_project` | No .brain/ folder | Show onboarding |
-| `planning` | workflow contains "plan" | Planning help |
-| `coding` | workflow contains "code" | Coding help |
-| `debugging` | workflow contains "debug" | Debug help |
-| `deploying` | workflow contains "deploy" | Deploy help |
-| `stuck` | status = "blocked" or pending > 5 | Stuck help |
-| `idle` | No active workflow | General help |
-
-### Step 3: Show Contextual Help
-
-## Help Templates
-
-### No Project State
-```
-🆕 Chưa có dự án
-
-Bạn có thể:
-1. /brainstorm - Bàn ý tưởng trước
-2. /init - Tạo dự án mới
-3. Mô tả ý tưởng cho em nghe
-
-Em sẽ hướng dẫn từng bước!
-```
-
-### Planning State
-```
-📋 Đang lập kế hoạch: {context.workflow}
-
-Bạn có thể:
-1. Tiếp tục plan hiện tại
-2. /code - Bắt đầu code phase đầu tiên
-3. Hỏi em về cách thiết kế
-
-💡 Mẹo: Plan tốt = Code nhanh hơn!
-```
-
-### Coding State
-```
-💻 Đang code: {context.task}
-   Status: {context.status}
-
-Bạn có thể:
-1. Tiếp tục code
-2. /test - Kiểm tra code vừa viết
-3. /debug - Nếu gặp lỗi
-4. /save-brain - Lưu tiến độ
-
-💡 Pending tasks: {context.pending.length}
-```
-
-### Debugging State
-```
-🔧 Đang debug: {context.task}
-
-Bạn có thể:
-1. Mô tả lỗi chi tiết hơn
-2. Paste error message
-3. /code - Quay lại code sau khi fix
-
-💡 Mẹo: Copy paste lỗi giúp em hiểu nhanh hơn!
-```
-
-### Deploying State
-```
-🚀 Đang deploy: {context.workflow}
-
-Bạn có thể:
-1. Tiếp tục deploy process
-2. /rollback - Quay về bản trước nếu lỗi
-3. Kiểm tra logs sau deploy
-
-⚠️ Nhớ test kỹ trước khi deploy production!
-```
-
-### Stuck State
-```
-😅 Có vẻ bạn đang bị kẹt
-
-Thử những cách này:
-1. /recap - Xem lại đang làm gì
-2. /debug - Nếu có lỗi
-3. Nghỉ 5 phút rồi quay lại
-4. Hỏi em cụ thể vấn đề
-
-💡 {context.pending.length} tasks đang chờ.
-   Có thể tạm skip task khó, làm cái khác trước?
-```
-
-### Idle/General State
-```
-👋 Em có thể giúp gì?
-
-Lệnh phổ biến:
-┌─────────────────────────────────────┐
-│ /next       │ Gợi ý việc tiếp theo  │
-│ /recap      │ Nhớ lại context       │
-│ /brainstorm │ Bàn ý tưởng mới       │
-│ /plan       │ Lập kế hoạch          │
-│ /code       │ Viết code             │
-└─────────────────────────────────────┘
-
-Hoặc hỏi em bất cứ điều gì!
-```
-
-## Adaptive Language
-
-Help responses adapt to `technical_level`:
-
-**newbie:**
-- Dùng tiếng Việt thuần
-- Giải thích mọi khái niệm
-- Bước nhỏ, chi tiết
-
-**basic:**
-- Mix Việt-Anh
-- Giải thích term lần đầu
-- Bước vừa phải
-
-**technical:**
-- Dùng thuật ngữ chuẩn
-- Không cần giải thích
-- Tập trung action
-
-## Fallback
-
-If context unreadable:
-```
-👋 Em ở đây giúp bạn!
-
-Gõ /next để em gợi ý việc cần làm,
-hoặc mô tả vấn đề cho em nghe.
-```
-
-## Performance
-
-- Context read: < 200ms
-- Response generation: Instant
-- No external API calls

package/skills/error-translator/SKILL.md

@@ -1,153 +0,0 @@
----
-name: awf-error-translator
-description: >-
-  Translate technical errors to human-friendly language. Keywords: error,
-  translate, explain, help, fix, fail, broken, crash, bug.
-  Activates on /debug, /code, /test when errors detected.
-version: 1.0.0
----
-
-# AWF Error Translator
-
-Dịch lỗi kỹ thuật sang ngôn ngữ đời thường cho non-tech users.
-
-## Trigger Conditions
-
-**Post-hook for:** `/debug`, `/code`, `/test`
-
-**When:** Error message detected in output
-
-## Execution Logic
-
-### Step 1: Detect Error
-
-```
-if output contains error patterns:
-    → Activate translation
-else:
-    → Skip (no error)
-```
-
-### Step 2: Match & Translate
-
-Match error against database, return human message + action.
-
-### Step 3: Display
-
-```
-❌ Lỗi: [human message]
-💡 Gợi ý: [action]
-```
-
-## Error Translation Database
-
-### Database Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `ECONNREFUSED` | Database chưa chạy | Khởi động PostgreSQL/MySQL |
-| `ETIMEDOUT` | Database phản hồi chậm quá | Kiểm tra kết nối mạng |
-| `ER_ACCESS_DENIED` | Sai mật khẩu database | Kiểm tra file .env |
-| `relation .* does not exist` | Bảng chưa tồn tại | Chạy migration: `/run migrate` |
-| `duplicate key` | Dữ liệu bị trùng | Kiểm tra unique constraint |
-
-### JavaScript/TypeScript Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `TypeError: Cannot read` | Đang đọc biến chưa có giá trị | Kiểm tra null/undefined |
-| `ReferenceError` | Dùng biến chưa khai báo | Kiểm tra tên biến |
-| `SyntaxError` | Code viết sai cú pháp | Kiểm tra dấu ngoặc, chấm phẩy |
-| `Maximum call stack` | Vòng lặp vô hạn | Kiểm tra điều kiện dừng |
-| `Cannot find module` | Thiếu package | Chạy `npm install` |
-
-### Network Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `fetch failed` | Không kết nối được server | Kiểm tra URL và internet |
-| `CORS` | Website chặn request | Cấu hình CORS trên server |
-| `ERR_CERT` | Chứng chỉ SSL lỗi | Dùng HTTP thay HTTPS (dev only) |
-| `timeout` | Request quá lâu | Tăng timeout hoặc kiểm tra server |
-| `ENOTFOUND` | Domain không tồn tại | Kiểm tra lại URL |
-
-### Package Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `npm ERR!` | Cài package bị lỗi | Xóa node_modules, cài lại |
-| `peer dep` | Phiên bản không tương thích | Cập nhật package.json |
-| `EACCES` | Không có quyền truy cập | Chạy với sudo hoặc sửa quyền |
-| `ENOSPC` | Hết dung lượng ổ đĩa | Dọn dẹp disk |
-| `gyp ERR!` | Lỗi build native module | Cài build tools |
-
-### Test Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `Expected .* but received` | Test thất bại - kết quả sai | Sửa code hoặc update test |
-| `Timeout` | Test chạy quá lâu | Tăng timeout hoặc optimize |
-| `before each hook` | Setup test bị lỗi | Kiểm tra beforeEach |
-| `snapshot` | UI thay đổi | Update snapshot nếu đúng |
-| `coverage` | Thiếu test coverage | Viết thêm test |
-
-### Build Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `tsc.*error` | Lỗi TypeScript | Sửa type errors |
-| `ESLint` | Code không đúng style | Chạy lint fix |
-| `Build failed` | Build thất bại | Đọc log chi tiết |
-| `Out of memory` | Hết RAM | Tăng memory limit |
-| `FATAL ERROR` | Lỗi nghiêm trọng | Restart và thử lại |
-
-### Git Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `conflict` | Code bị xung đột | Merge conflict manually |
-| `rejected` | Push bị từ chối | Pull trước khi push |
-| `detached HEAD` | Không ở branch nào | Checkout về branch |
-| `not a git repo` | Chưa init git | Chạy `git init` |
-
-### Deploy Errors
-
-| Pattern | Human Message | Action |
-|---------|---------------|--------|
-| `502 Bad Gateway` | Server không phản hồi | Restart server |
-| `503 Service` | Server quá tải | Scale up resources |
-| `permission denied` | Không có quyền deploy | Kiểm tra credentials |
-| `quota exceeded` | Hết quota | Nâng cấp plan |
-
-## Output Format
-
-```
-🔍 Translating error...
-
-❌ Lỗi: [human_message]
-   └─ Gốc: [original_error_snippet]
-
-💡 Gợi ý: [action]
-   └─ Hoặc chạy: /debug để tìm hiểu thêm
-
-────────────────────────────────
-```
-
-## Fallback
-
-If no pattern matches:
-```
-❌ Lỗi: Có vấn đề xảy ra
-💡 Gợi ý: Chạy /debug để em phân tích chi tiết
-```
-
-## Performance
-
-- Translation: < 100ms
-- Pattern matching: Simple regex
-- No external API calls
-
-## Security
-
-- Sanitize error messages (remove credentials, paths)
-- Never expose sensitive info in translations

package/skills/session-restore/SKILL.md

@@ -1,240 +0,0 @@
----
-name: awf-session-restore
-description: Auto-restore context from Beads + Brain on session start
-trigger: session_start
----
-
-# AWF Session Restore (v5.0 - Beads + Brain)
-
-> **Purpose:** Tự động khôi phục context khi user quay lại sau khi nghỉ.
-
----
-
-## Trigger
-
-Skill này tự động chạy khi:
-- User mở session mới
-- User gõ `/recap`
-- AI detect context loss (conversation reset)
-
----
-
-## Execution Flow
-
-### 1. Multi-Source Context Check
-
-**Priority 1: Beads (Task State)**
-```bash
-bd list --status in_progress
-```
-
-**Output:**
-- Tasks đang làm dở
-- Tasks blocked
-- Tasks ready to start
-
-**Priority 2: Brain (Knowledge & Plans)**
-```bash
-# Check active plans
-cat brain/active_plans.json
-
-# Check recent memories
-ls -lt brain/ | head -5
-```
-
-**Output:**
-- Plan đang active
-- Phase hiện tại
-- Recent decisions/knowledge
-
-**Priority 3: Git (Code State)**
-```bash
-git status
-git log -1
-```
-
-**Output:**
-- Files đang thay đổi
-- Commit gần nhất
-
----
-
-### 2. Context Synthesis
-
-Kết hợp 3 nguồn để tạo summary:
-
-```markdown
-🧠 **SESSION RESTORED**
-
-📿 **Beads Context:**
-- In Progress: Task #123 "Implement Login API" (started 2h ago)
-- Blocked: Task #125 (waiting for #120)
-- Ready: 3 tasks
-
-🧠 **Brain Context:**
-- Active Plan: plans/260130-1025-shopping-cart/
-- Current Phase: Phase 02 - Backend (50% complete)
-- Last Save: 30 minutes ago
-
-📂 **Git Context:**
-- Changed Files: 3 files (src/api/auth/*.ts)
-- Last Commit: "feat: add user model" (1 hour ago)
-
-➡️ **SUGGESTED NEXT STEP:**
-Continue task #123? `/codeExpert` or `/code`
-```
-
----
-
-### 3. Smart Suggestions
-
-Based on context, suggest appropriate action:
-
-**Case 1: Task In-Progress**
-```
-➡️ Tiếp tục task #123? 
-   `/codeExpert` (Fast) or `/code` (Guided)
-```
-
-**Case 2: Task Blocked**
-```
-⚠️ Task #125 bị block bởi #120
-
-➡️ Làm task #120 trước?
-   `/codeExpert` or switch to another task
-```
-
-**Case 3: No Active Task**
-```
-📋 Có 3 tasks ready to start
-
-➡️ Bắt đầu task mới?
-   `/next` để xem gợi ý
-```
-
-**Case 4: Fresh Start**
-```
-🆕 Chưa có context
-
-➡️ Bắt đầu dự án mới?
-   `/planExpert "Feature"` or `/brainstorm`
-```
-
----
-
-### 4. Memory Persistence
-
-Update session state:
-
-```json
-// brain/session.json
-{
-  "last_session": "2026-01-30T10:00:00Z",
-  "working_on": {
-    "feature": "Shopping Cart",
-    "plan_path": "plans/260130-1025-shopping-cart/",
-    "current_phase": "phase-02",
-    "current_task": {
-      "id": 123,
-      "name": "Implement Login API",
-      "status": "in_progress"
-    }
-  },
-  "context_sources": {
-    "beads": true,
-    "brain": true,
-    "git": true
-  }
-}
-```
-
----
-
-## Error Handling
-
-### Beads Unavailable
-```
-⚠️ Beads không khả dụng
-
-Fallback: Dùng Brain + Git context
-```
-
-### Brain Empty
-```
-⚠️ Brain chưa có context
-
-Gợi ý: `/plan` để tạo context mới
-```
-
-### All Sources Fail
-```
-❌ Không thể khôi phục context
-
-➡️ Bắt đầu lại:
-1. `/recap` để quét dự án
-2. `/plan` để tạo plan mới
-3. Kể cho em biết đang làm gì
-```
-
----
-
-## Integration with Workflows
-
-### Auto-Trigger in Workflows
-
-Các workflows tự động gọi session restore:
-
-```markdown
-# In /code workflow
-1. Check session.json
-2. If no context → Trigger awf-session-restore
-3. Resume from restored context
-```
-
-### Manual Trigger
-
-User có thể gọi thủ công:
-
-```bash
-/recap    # Alias for session restore
-```
-
----
-
-## Performance
-
-- **Execution Time:** < 1 second
-- **Sources Checked:** 3 (Beads, Brain, Git)
-- **Output:** Concise summary (< 10 lines)
-
----
-
-## Example Output
-
-```
-🧠 **WELCOME BACK!**
-
-📿 **Beads:** Task #123 "Login API" (in_progress, 2h ago)
-🧠 **Brain:** Plan "Shopping Cart" - Phase 02 (50%)
-📂 **Git:** 3 files changed
-
-➡️ **NEXT:** Continue coding? `/codeExpert`
-
-💡 **TIP:** Gõ `/next` để xem chi tiết hơn
-```
-
----
-
-## Configuration
-
-User có thể customize trong `brain/preferences.json`:
-
-```json
-{
-  "session_restore": {
-    "auto_trigger": true,
-    "verbosity": "concise",  // concise | detailed
-    "sources": ["beads", "brain", "git"]
-  }
-}
-```