@relipa/ai-flow-kit 0.1.4-beta.0 → 0.1.4

package/custom/skills/execute-flow/SKILL.md

@@ -159,7 +159,6 @@ Nhận về: danh sách kết quả per TC.
 
 ### Hiển thị kết quả
 
-```
 ⏸️ GATE 2: SCRIPT SYNC COMPLETE
 
 Gen mới: {N} | Updated: {N} | Skipped: {N}
@@ -170,7 +169,6 @@ Blocked: {N} TCs — xem lý do bên trên
 → Type APPROVED to run tests
 → Type SKIP: {TC_ID} để đánh dấu Pending và tiếp tục
 → Or provide feedback to fix scripts
-```
 
 Dừng. Chờ APPROVED.
 
@@ -307,26 +305,7 @@ Với mỗi TC failed, tạo `ak-test/{repo}/results/{screenId}/run-{N}/bugs/BUG
 
 BUG số: đếm file trong `bugs/` folder, +1. Format: `001`, `002`,...
 
-### Bước 6: Cập nhật TC file gốc
-
-Ghi kết quả vào các cột R1/R2 trong TC file:
-
-- R1 = lần chạy đầu tiên (run-1). Nếu R1 đã có giá trị → ghi vào R2.
-- R1 Tester = `AI-R1`, R2 Tester = `AI-R2`
-
-```markdown
-| AD10_001 | ... | ✅ Pass | {YYYY-MM-DD} | AI-R1 |   |   |   |
-| AD10_005 | ... | ❌ Fail | {YYYY-MM-DD} | AI-R1 |   |   |   |
-| AD10_023 | ... | ⏭️ Untest | - | - |   |   |   |
-```
-
-Cập nhật Section 2 — Test Execution Summary table:
-
-```markdown
-| Round {N} | {passed} | {failed} | {untest} | {pending} | {total} | {passed/total*100}% |
-```
-
-### Bước 7: Hiển thị Gate 3
+### Bước 6: Hiển thị Gate 3
 
 ```
 ⏸️ GATE 3: EXECUTION COMPLETE
@@ -361,8 +340,7 @@ Khi tester gõ `RETEST: AD10_005, AD10_008`:
    ```
 3. Xác định run number mới (run-{N+1})
 4. Tổ chức evidence vào `run-{N+1}/` (không xóa run cũ)
-5. Cập nhật R2 columns trong TC file
-6. Cập nhật bug status:
+5. Cập nhật bug status:
    - TC pass sau retest → ghi `RESOLVED` vào bug file: `**Status:** ✅ Resolved`
    - TC vẫn fail → ghi `**Retest {N}:** Still OPEN` vào bug file
 
@@ -382,11 +360,7 @@ Chỉ chạy sau Gate 3 APPROVED.
 
 Đọc `bugs/BUG-*.md` trong run folder: phân loại severity + status (Open/Resolved).
 
-### Bước 2: Cập nhật Section 2 trong TC file
-
-Cập nhật bảng Test Execution Summary với số liệu từ R1 và R2.
-
-### Bước 3: Sinh testreport.md
+### Bước 2: Sinh testreport.md
 
 Tạo `ak-test/{repo}/results/{screenId}/run-{N}/testreport.md` theo template chuẩn:
 
@@ -422,7 +396,7 @@ Tạo `ak-test/{repo}/results/{screenId}/run-{N}/testreport.md` theo template ch
 - Còn Critical hoặc High Open → No-go
 - Chỉ còn Medium/Low Open → Conditional go
 
-### Bước 4: Bug logging flow
+### Bước 3: Bug logging flow
 
 Hỏi từng bug theo thứ tự severity (Critical → High → Medium → Low):
 
@@ -443,9 +417,8 @@ Nếu tester gõ `Y`:
 
 Nếu `n` hoặc `SKIP-BUG`: ghi `Not logged` trong testreport.md Bug Summary.
 
-### Bước 5: Hiển thị Gate 4
+### Bước 4: Hiển thị Gate 4
 
-```
 ⏸️ GATE 4: REPORT READY
 
 Overall: {Pass / Fail / Conditional}
@@ -456,7 +429,6 @@ Recommendation: {Go / No-go / Conditional go}
 → Review: [ak-test/{repo}/results/{screenId}/run-{N}/testreport.md](ak-test/{repo}/results/{screenId}/run-{N}/testreport.md)
 → Type APPROVED to sign off
 → Type NO-GO: {reason} to reject release
-```
 
 Dừng. Chờ APPROVED hoặc NO-GO.
 
@@ -493,7 +465,6 @@ SKIP-BUG: BUG-{NNN}                   # bỏ qua không log bug này
 
 - ✅ Dừng ở mỗi gate, chờ APPROVED trước khi proceed
 - ✅ `run-{N}` không bao giờ bị xóa hay overwrite — luôn tạo folder mới
-- ✅ R1/R2 trong TC file gốc được cập nhật sau mỗi lần chạy
 - ✅ Hỏi từng bug một — không auto-log toàn bộ
 - ❌ Không lấy expected result từ PR/code — chỉ từ TC file
 - ❌ Không skip gate kể cả khi "chỉ có 1 TC"

package/custom/skills/gate-review/SKILL.md

@@ -44,93 +44,45 @@ Tester Gate 2 produces multiple review files — one per sub-phase. Use a letter
 
 ---
 
-## Mode 1: GENERATE — Write Review File
+## Mode 1: GENERATE — Prepare Inline Review & Output Document
 
-### Step 1: Extract checklist items from gate output
+When generating the output for a gate (e.g. `requirement.md` or `plan.md`), follow these steps:
 
-Read the output you just created. For each **top-level section** in the output, create one checklist item — a one-line summary of what that section contains. The summary must be specific enough to identify the content without opening the output file.
+### Step 1: Ensure review directories and comments database exist
 
-**Extraction rules:**
-- One item per top-level section (H2 heading or named block)
-- Format: `**[Section name]**: [one-line summary of actual content]`
-- Maximum 12 items per gate. If more than 12 sections, group related ones.
-- The summary is the actual content, not a description of the category. ✅ "Scope: Auth module + User management (payment OUT of scope)" not ❌ "Scope: the scope section"
+1. Always create the directory `.aiflow/review/` if it doesn't exist.
+2. Check if `.aiflow/review/comments-[ticket-id].json` exists (where `[ticket-id]` comes from `.aiflow/context/current.json` → `ticketId` field).
+3. If the JSON file does not exist, initialize it by writing an empty array `[]` (or `{ "comments": [] }`) to it. This ensures that the CLI verification commands do not fail due to a missing file when there are no comments.
 
-**Examples by gate:**
-
-Dev Gate 1 (requirement.md has 4 sections → 4 items):
-```
-- [ ] **Requirements Summary**: Add batch export endpoint returning signed S3 URL, triggered by POST /exports
-- [ ] **Proposed Solution**: New ExportService + S3Adapter; reuse existing AuthMiddleware for permissions
-- [ ] **Impact Analysis**: Medium — touches ExportController, UserService (permission check added)
-- [ ] **Effort Estimate**: M (3–4 days)
-```
-
-Tester Gate 1 (test-analysis.md):
-```
-- [ ] **Scope**: Auth module + User management only; payment and notifications OUT of scope
-- [ ] **Functional Analysis**: Login, logout, session management, password reset, role-based access (3 roles)
-- [ ] **Risk Areas**: High — session token handling; Medium — email format validation
-- [ ] **Test Approach**: 60% automation (Playwright), 40% manual; ~18 TCs estimated
-- [ ] **Effort Estimate**: M (2–3 days)
-```
-
-### Step 2: Write the review file
-
-**File path:** `.aiflow/review/gate-[N]-[ticket-id].md`
-
-For Tester Gate 2 sub-phases, use the lettered form: `.aiflow/review/gate-2a-[ticket-id].md`, `.aiflow/review/gate-2b-[ticket-id].md`, etc.
-
-Where `[ticket-id]` comes from `.aiflow/context/current.json` → `ticketId` field. If ticketId is unavailable, use `unknown`.
-
-**File template:**
-
-```markdown
-# Gate [N] Review — [TICKET-ID]
-> Status: PENDING | Generated: YYYY-MM-DD
-
-## How to review
-- Toggle `[ ]` → `[x]` for each item you have read and agree with
-- Add a comment under any item you want changed: `<!-- your comment here -->`
-- Type `APPROVED` in chat when done
-
----
-
-## Checklist
-
-- [ ] **[Section]**: [one-line summary]
-- [ ] **[Section]**: [one-line summary]
-(... one per section, max 12)
-
----
-
-## Review Notes
-<!-- Optional: overall notes -->
-```
+### Step 2: Write the gate output file
+Write the gate output file (e.g. `plan/[ticket-id]/requirement.md`, `plan/[ticket-id]/plan.md`, or `docs/ak-[project]/...`) as specified by the gate instructions.
 
 ### Step 3: Display gate pause message
 
-After writing the file, display in chat:
+Instruct the user to review the generated document. Tell them that they can hover over any line and add inline comments in VS Code using the native commenting UI, or edit the file to add standard HTML comments `<!-- comment -->` if they are not using the VS Code extension.
+
+Display in chat:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ⏸️  GATE [N] PAUSED — REVIEW REQUIRED
 
-📋 Open in VSCode: [.aiflow/review/gate-[N]-[ticket-id].md](.aiflow/review/gate-[N]-[ticket-id].md)
+📋 Open in VS Code: [path/to/generated/file.md](path/to/generated/file.md)
 
-  • Toggle [ ] → [x] for each item you agree with
-  • Add <!-- comment --> under any item needing changes
-  • Type APPROVED when all items are addressed
+  • Review the generated document content directly.
+  • Hover over any line to add specific comments (inline review).
+  • Mark comments as "Resolved" in VS Code once addressed.
+  • Type APPROVED when done.
 
-⚠️  APPROVED will not be accepted until all checkboxes are checked.
+⚠️  APPROVED will not be accepted until all inline comments are resolved.
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
 ---
 
-## Mode 2: VERIFY — Check Review File on APPROVED
+## Mode 2: VERIFY — Check Comments and Checklist on APPROVED
 
-When the developer types `APPROVED`, run this before accepting:
+When the developer types `APPROVED`, run this check:
 
 ### Step 1: Run CLI check
 
@@ -138,58 +90,30 @@ When the developer types `APPROVED`, run this before accepting:
 ak review check --gate [N] --ticket [ticket-id]
 ```
 
-For Tester Gate 2 sub-phases, pass the lettered gate identifier:
-
-```bash
-ak review check --gate 2a --ticket [ticket-id]
-ak review check --gate 2b --ticket [ticket-id]
-```
-
 ### Step 2: Interpret result
 
-**Exit code 0 — all checked:**
+**Exit code 0 — all checked & resolved:**
 - Gate proceeds normally
 - Run telemetry: `ak gate [N] approved --ticket [ticket-id]`
 - Continue to next gate
 
 **Exit code 1 — file missing:**
-```
-  ✗ Review file not found for gate N, ticket PROJ-33
-```
-AI response:
-> "The review file wasn't found. Let me regenerate it."
-Then re-run Mode 1 (generate) and display the gate pause message again.
+- AI response: "The review session files weren't found. Let me prepare them."
+- Re-run Mode 1 (initialize `comments-[ticket-id].json` and output file) and display pause message.
 
 **Exit code 1 — items with comments (need revision):**
-```
-  Items with comments (need AI revision):
-    • **Risk Areas**: High — session token handling
-      Comment: "Missing: SQL injection risk on login form"
-```
-AI response:
-1. Read each comment
-2. Update the specific section in the gate output file
-3. Rewrite only the flagged items in the review file (keep already-checked `[x]` items as-is)
-4. Display updated gate pause message
-
-**Exit code 1 — unchecked items, no comment:**
-```
-  Items unchecked (no comment):
-    • **Scope**: Auth module only
-```
-AI response:
-> "Item(s) are unchecked without a comment. Please either:
-> - Check `[x]` if you agree with the content, or
-> - Add `<!-- your comment -->` on the next line if you want changes."
-Do NOT re-generate. Wait for developer to update the file.
+If the CLI reports unresolved comments, the AI must:
+1. Read the unresolved comments returned by the CLI (which include file path, line number, and comment text).
+2. Read the source file at those line numbers to understand the context.
+3. Update the specific sections of the document to address the comments.
+4. Tell the user what was updated, ask them to mark the comment thread as resolved in VS Code, and type `APPROVED`.
 
 ---
 
 ## Mandatory Rules
 
 - ❌ **NEVER** accept `APPROVED` without first running `ak review check`
-- ❌ **NEVER** re-generate already-checked `[x]` items when doing a partial revision
-- ✅ **ALWAYS** create `.aiflow/review/` directory if it doesn't exist (use `mkdir -p`)
+- ✅ **ALWAYS** ensure `.aiflow/review/` directory exists (use `mkdir -p`)
+- ✅ **ALWAYS** initialize `.aiflow/review/comments-[ticket-id].json` with `[]` if not present when starting a gate pause.
 - ✅ **ALWAYS** use the ticket ID from `.aiflow/context/current.json` in the file name
-- ✅ **ALWAYS** keep review items specific to the actual content — not generic category names
 - ✅ **ALWAYS** use lettered suffixes (`gate-2a`, `gate-2b`, …) for Tester Gate 2 sub-phases — never plain `gate-2`

package/custom/skills/generate-testcase/SKILL.md

@@ -99,13 +99,11 @@ Liệt kê scenarios theo nhóm, output vào `test-plan/checklist.md`:
 📙 **Regression** _(nếu Dev Artifacts Check Bước 2 tìm thấy impacted areas)_
 - Mỗi item ghi rõ: "Regression — [vùng ảnh hưởng] — [lý do từ PR diff]"
 
-```
 ⏸️ GATE 2 — PHASE 2a: SCENARIOS READY
 Scenarios: [N] total
 - Functional: [N] | Non-functional: [N] | Integration: [N] | Exploratory: [N] | Regression: [N]
 → Review: [test-plan/checklist.md](test-plan/checklist.md)
 → Type APPROVED to proceed to Phase 2b
-```
 
 ---
 
@@ -178,14 +176,12 @@ Output testcases: `test-plan/test-cases/[ScreenID]-testcases.md`
 | **Total** | **[S/M/L/XL]** |
 ```
 
-```
 ⏸️ GATE 2 — PHASE 2b: TESTCASES GENERATED
 Test cases: [N] total ([N] positive / [N] negative / [N] edge)
 Test plan:  [test-plan/test-plan.md](test-plan/test-plan.md)
 → Review: [test-plan/test-cases/](test-plan/test-cases/)
 → Type APPROVED to proceed to Phase 2c (Review & Optimize)
 → Or provide feedback to update
-```
 
 ---
 
@@ -229,18 +225,15 @@ Kiểm tra theo thứ tự, output vào `test-plan/review-report.md`:
    Priority: High (phải fix trước Phase 2d) / Medium / Low (có thể defer)
 ```
 
-```
 ⏸️ GATE 2 — PHASE 2c: REVIEW COMPLETE
 Issues: [N] duplicate | [N] problematic | [N] to optimize | [N] missing
 High priority chưa xử lý: [N]
 → Review: [test-plan/review-report.md](test-plan/review-report.md)
 → Type APPROVED to proceed to Phase 2d (chỉ khi High priority = 0)
 → Or provide specific fixes to apply
-```
 
 **Nếu nhận được APPROVED mà còn issues Priority High chưa xử lý → từ chối ngay:**
 
-```
 ⛔ PHASE 2c BLOCKED — Còn [N] issues Priority HIGH chưa được xử lý:
 
 | TC_ID | Vấn đề | Đề xuất sửa |
@@ -250,7 +243,6 @@ High priority chưa xử lý: [N]
 → Cung cấp fixes cho các issues trên, sau đó gõ APPROVED.
 ❌ APPROVED chỉ được chấp nhận khi không còn issues Priority High.
 Medium và Low có thể defer — không block APPROVED.
-```
 
 ---
 

package/custom/skills/generate-testcase/templates/testcase.md

@@ -11,78 +11,69 @@
 | **Người kiểm duyệt (Reviewer)** | |
 | **Ngày kiểm duyệt (Review Date)** | |
 
-## 2. Kết quả kiểm thử tổng hợp (Test Execution Summary)
+## 2. Danh sách Test Cases Chi Tiết
 
-| Vòng kiểm thử (Round) | Đạt (Passed) | Lỗi (Failed) | Chưa test (Untest) | Chờ (Pending) | Tổng số (Total) | Tỷ lệ đạt (%) |
-|:---|:---:|:---:|:---:|:---:|:---:|:---:|
-| Round 1 | 0 | 0 | 0 | 0 | 0 | 0% |
-| Round 2 | 0 | 0 | 0 | 0 | 0 | 0% |
+### 2.1. Kiểm thử Truy cập & Phân quyền (Access & Authorization)
 
----
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID]_001 | Truy cập trực tiếp qua URL khi chưa đăng nhập | High | Người dùng chưa đăng nhập hệ thống | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống không cho phép truy cập.<br>Tự động chuyển hướng về trang đăng nhập (Login). | | |
+| [ID]_002 | Truy cập trực tiếp qua URL khi đã đăng nhập | Medium | Người dùng đã đăng nhập thành công | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống cho phép truy cập.<br>Hiển thị đúng giao diện màn hình. | | |
+| [ID]_003 | Truy cập qua button/menu điều hướng | Low | Người dùng đang ở màn hình danh sách | 1. Click vào nút "Thêm mới" hoặc menu tương ứng. | - | Hệ thống mở màn hình đăng ký/thực hiện tương ứng thành công. | | |
 
-## 3. Danh sách Test Cases Chi Tiết
+### 2.2. Kiểm thử Giao diện Người dùng (UI/UX)
 
-### 3.1. Kiểm thử Truy cập & Phân quyền (Access & Authorization)
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID]_004 | Kiểm tra hiển thị giao diện tổng quan | Low | Màn hình hiển thị bình thường | 1. Quan sát giao diện màn hình.<br>2. Kiểm tra layout, màu sắc, font chữ, khoảng cách giữa các trường. | - | 1. Layout cân đối, font chữ và cỡ chữ đồng nhất.<br>2. Các trường bắt buộc nhập có dấu sao đỏ (*).<br>3. Không có lỗi chính tả.<br>4. Định dạng placeholder hiển thị chính xác theo thiết kế. | | |
 
-| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID]_001 | Truy cập trực tiếp qua URL khi chưa đăng nhập | High | Người dùng chưa đăng nhập hệ thống | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống không cho phép truy cập.<br>Tự động chuyển hướng về trang đăng nhập (Login). | | | | | | | | |
-| [ID]_002 | Truy cập trực tiếp qua URL khi đã đăng nhập | Medium | Người dùng đã đăng nhập thành công | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống cho phép truy cập.<br>Hiển thị đúng giao diện màn hình. | | | | | | | | |
-| [ID]_003 | Truy cập qua button/menu điều hướng | Low | Người dùng đang ở màn hình danh sách | 1. Click vào nút "Thêm mới" hoặc menu tương ứng. | - | Hệ thống mở màn hình đăng ký/thực hiện tương ứng thành công. | | | | | | | | |
-
-### 3.2. Kiểm thử Giao diện Người dùng (UI/UX)
-
-| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID]_004 | Kiểm tra hiển thị giao diện tổng quan | Low | Màn hình hiển thị bình thường | 1. Quan sát giao diện màn hình.<br>2. Kiểm tra layout, màu sắc, font chữ, khoảng cách giữa các trường. | - | 1. Layout cân đối, font chữ và cỡ chữ đồng nhất.<br>2. Các trường bắt buộc nhập có dấu sao đỏ (*).<br>3. Không có lỗi chính tả.<br>4. Định dạng placeholder hiển thị chính xác theo thiết kế. | | | | | | | | |
-
-### 3.3. Kiểm thử Validation các trường nhập liệu (Input Validation)
+### 2.3. Kiểm thử Validation các trường nhập liệu (Input Validation)
 
 *(Tạo riêng từng bảng hoặc nhóm theo từng Field để dễ theo dõi)*
 
 #### * Đối với Trường [Tên Trường] — Text
 
-| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID]_0xx | Kiểm tra giá trị mặc định | Low | Đã truy cập màn hình | 1. Quan sát trường [Tên Trường]. | - | Giá trị mặc định là trống (blank).<br>Hiển thị đúng Placeholder theo thiết kế. | | | | | | | | |
-| [ID]_0xx | Kiểm tra trường bắt buộc nhập để trống | High | Đã truy cập màn hình | 1. Để trống trường [Tên Trường].<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | Empty | 1. Hiển thị thông báo lỗi: "Hãy nhập [Tên Trường]".<br>2. Field bị highlight viền đỏ. | | | | | | | | |
-| [ID]_0xx | Kiểm tra nhập ký tự khoảng trắng (Spaces) | Medium | Đã truy cập màn hình | 1. Nhập toàn khoảng trắng vào trường.<br>2. Bấm nút thực hiện hoặc focus out. | `"   "` | Hệ thống xem như để trống.<br>Báo lỗi bắt buộc nhập (nếu là trường Required) hoặc tự động trim khoảng trắng. | | | | | | | | |
-| [ID]_0xx | Kiểm tra nhập khoảng trắng ở đầu/cuối chuỗi | Low | Đã truy cập màn hình | 1. Nhập chuỗi có khoảng trắng ở đầu/cuối.<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | `"  data_test  "` | Hệ thống tự động cắt bỏ (trim) khoảng trắng ở đầu và cuối chuỗi trước khi lưu vào DB. | | | | | | | | |
-| [ID]_0xx | Kiểm tra nhập độ dài tối thiểu/tối đa (Boundary Value) | Medium | Đã truy cập màn hình, biết Maxlength = N | 1. Nhập chuỗi độ dài N-1 ký tự.<br>2. Nhập chuỗi độ dài N ký tự.<br>3. Nhập chuỗi độ dài > N ký tự. | Chuỗi test tương ứng | - Độ dài <= N: cho phép nhập và lưu bình thường.<br>- Độ dài > N: hệ thống chặn trực tiếp trên UI hoặc báo lỗi hợp lệ. | | | | | | | | |
-| [ID]_0xx | Kiểm tra nhập ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Nhập các ký tự đặc biệt (!@#$%^&*).<br>2. Bấm nút thực hiện. | `"!@#$%"` | Hệ thống lưu trữ đúng định dạng ký tự đã nhập (hoặc báo lỗi nếu có quy định hạn chế định dạng). | | | | | | | | |
-| [ID]_0xx | Kiểm tra thao tác Copy/Paste | Low | Đã truy cập màn hình | 1. Copy một chuỗi hợp lệ.<br>2. Paste vào trường thông tin.<br>3. Bấm nút thực hiện. | - | Cho phép paste dữ liệu vào field thành công và xử lý lưu bình thường. | | | | | | | | |
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra giá trị mặc định | Low | Đã truy cập màn hình | 1. Quan sát trường [Tên Trường]. | - | Giá trị mặc định là trống (blank).<br>Hiển thị đúng Placeholder theo thiết kế. | | |
+| [ID]_0xx | Kiểm tra trường bắt buộc nhập để trống | High | Đã truy cập màn hình | 1. Để trống trường [Tên Trường].<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | Empty | 1. Hiển thị thông báo lỗi: "Hãy nhập [Tên Trường]".<br>2. Field bị highlight viền đỏ. | | |
+| [ID]_0xx | Kiểm tra nhập ký tự khoảng trắng (Spaces) | Medium | Đã truy cập màn hình | 1. Nhập toàn khoảng trắng vào trường.<br>2. Bấm nút thực hiện hoặc focus out. | `"   "` | Hệ thống xem như để trống.<br>Báo lỗi bắt buộc nhập (nếu là trường Required) hoặc tự động trim khoảng trắng. | | |
+| [ID]_0xx | Kiểm tra nhập khoảng trắng ở đầu/cuối chuỗi | Low | Đã truy cập màn hình | 1. Nhập chuỗi có khoảng trắng ở đầu/cuối.<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | `"  data_test  "` | Hệ thống tự động cắt bỏ (trim) khoảng trắng ở đầu và cuối chuỗi trước khi lưu vào DB. | | |
+| [ID]_0xx | Kiểm tra nhập độ dài tối thiểu/tối đa (Boundary Value) | Medium | Đã truy cập màn hình, biết Maxlength = N | 1. Nhập chuỗi độ dài N-1 ký tự.<br>2. Nhập chuỗi độ dài N ký tự.<br>3. Nhập chuỗi độ dài > N ký tự. | Chuỗi test tương ứng | - Độ dài <= N: cho phép nhập và lưu bình thường.<br>- Độ dài > N: hệ thống chặn trực tiếp trên UI hoặc báo lỗi hợp lệ. | | |
+| [ID]_0xx | Kiểm tra nhập ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Nhập các ký tự đặc biệt (!@#$%^&*).<br>2. Bấm nút thực hiện. | `"!@#$%"` | Hệ thống lưu trữ đúng định dạng ký tự đã nhập (hoặc báo lỗi nếu có quy định hạn chế định dạng). | | |
+| [ID]_0xx | Kiểm tra thao tác Copy/Paste | Low | Đã truy cập màn hình | 1. Copy một chuỗi hợp lệ.<br>2. Paste vào trường thông tin.<br>3. Bấm nút thực hiện. | - | Cho phép paste dữ liệu vào field thành công và xử lý lưu bình thường. | | |
 
 #### * Đối với Trường Số (Number / Price / Quantity)
 
-| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID]_0xx | Kiểm tra nhập chữ cái và ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Cố gắng nhập chữ cái (a, b, c...) hoặc ký tự đặc biệt.<br>2. Bấm nút thực hiện. | `"abc"`, `"@#$"` | UI ngăn không cho nhập chữ cái/ký tự đặc biệt, chỉ chấp nhận chữ số. | | | | | | | | |
-| [ID]_0xx | Kiểm tra nhập số âm | High | Đã truy cập màn hình | 1. Nhập số âm.<br>2. Bấm nút thực hiện. | `-10` | Báo lỗi giá trị phải lớn hơn hoặc bằng 0 (hoặc chặn dấu trừ `-` trực tiếp từ UI). | | | | | | | | |
-| [ID]_0xx | Kiểm tra nhập số thập phân | High | Đã truy cập màn hình | 1. Nhập số có dấu phẩy thập phân.<br>2. Bấm nút thực hiện. | `1.5`, `2,3` | Báo lỗi chỉ chấp nhận số nguyên (hoặc chấp nhận số thập phân tùy đặc tả nghiệp vụ). | | | | | | | | |
-| [ID]_0xx | Kiểm tra hiển thị định dạng phân tách hàng nghìn | Low | Đã truy cập màn hình | 1. Nhập số lớn.<br>2. Focus out khỏi trường nhập liệu. | `1000000` | Số tự động định dạng phân tách hàng nghìn (VD: `1,000,000`). | | | | | | | | |
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra nhập chữ cái và ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Cố gắng nhập chữ cái (a, b, c...) hoặc ký tự đặc biệt.<br>2. Bấm nút thực hiện. | `"abc"`, `"@#$"` | UI ngăn không cho nhập chữ cái/ký tự đặc biệt, chỉ chấp nhận chữ số. | | |
+| [ID]_0xx | Kiểm tra nhập số âm | High | Đã truy cập màn hình | 1. Nhập số âm.<br>2. Bấm nút thực hiện. | `-10` | Báo lỗi giá trị phải lớn hơn hoặc bằng 0 (hoặc chặn dấu trừ `-` trực tiếp từ UI). | | |
+| [ID]_0xx | Kiểm tra nhập số thập phân | High | Đã truy cập màn hình | 1. Nhập số có dấu phẩy thập phân.<br>2. Bấm nút thực hiện. | `1.5`, `2,3` | Báo lỗi chỉ chấp nhận số nguyên (hoặc chấp nhận số thập phân tùy đặc tả nghiệp vụ). | | |
+| [ID]_0xx | Kiểm tra hiển thị định dạng phân tách hàng nghìn | Low | Đã truy cập màn hình | 1. Nhập số lớn.<br>2. Focus out khỏi trường nhập liệu. | `1000000` | Số tự động định dạng phân tách hàng nghìn (VD: `1,000,000`). | | |
 
 #### * Đối với Trường File Upload (Hình ảnh)
 
-| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID]_0xx | Kiểm tra không upload file (Trường tùy chọn) | Medium | Đã truy cập màn hình | 1. Không chọn file upload.<br>2. Bấm nút thực hiện. | - | Hệ thống cho phép thực hiện thành công mà không báo lỗi. | | | | | | | | |
-| [ID]_0xx | Kiểm tra upload file sai định dạng | High | Định dạng cho phép: jpeg, png | 1. Chọn upload file có định dạng không được phép (xlsx, gif, pdf...).<br>2. Tiến hành upload. | File `.pdf`, `.xlsx` | Upload không thành công. Hiển thị thông báo lỗi đúng thiết kế: "Hình ảnh phải là định dạng jpeg hoặc png." | | | | | | | | |
-| [ID]_0xx | Kiểm tra upload dung lượng vượt quá giới hạn | High | Giới hạn dung lượng: tối đa 10MB | 1. Chọn file có kích thước > 10MB.<br>2. Tiến hành upload. | File kích thước `10.5MB` | Upload thất bại. Hiển thị lỗi cảnh báo: "Dung lượng hình ảnh vượt quá 10MB." | | | | | | | | |
-| [ID]_0xx | Kiểm tra upload file giả mạo đuôi mở rộng (Spoofing) | High | Đã truy cập màn hình | 1. Đổi đuôi file thực thi nguy hiểm `.exe` thành `.jpg`.<br>2. Chọn upload file này. | File `.exe` đổi tên thành `.jpg` | Hệ thống kiểm tra phần thân file (MIME type) thực tế và báo lỗi không đúng định dạng. | | | | | | | | |
-| [ID]_0xx | Kiểm tra kéo thả file (Drag & Drop) | Low | Đã truy cập màn hình | 1. Kéo file ảnh thả vào vùng upload. | File `.png` hợp lệ | Upload file thành công và hiển thị thumbnail ảnh xem trước trên giao diện. | | | | | | | | |
-
-### 3.4. Kiểm thử Logic Nghiệp vụ (Business Rules - BR)
-
-| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID]_0xx | Kiểm tra ràng buộc trùng lặp dữ liệu duy nhất (Unique) | High | Đã tồn tại bản ghi trong DB | 1. Nhập thông tin trùng khóa chính/mã duy nhất với bản ghi cũ.<br>2. Điền các thông tin hợp lệ khác.<br>3. Bấm Đăng ký. | Mã trùng lặp | Hệ thống báo lỗi trùng lặp: "Mã/Tên này đã tồn tại trong hệ thống. Vui lòng kiểm tra lại." | | | | | | | | |
-| [ID]_0xx | Kiểm tra logic liên kết dữ liệu động (Dynamic Form Control) | High | Điều kiện thay đổi hiển thị | 1. Tích chọn/Bỏ tích chọn [Checkbox điều kiện]. | - | Giao diện tự động thay đổi hiển thị ẩn/hiện hoặc disable/enable các trường thông tin liên quan theo đúng mô tả Business Rule. | | | | | | | | |
-| [ID]_0xx | Kiểm tra lưu dữ liệu vào Database thành công | Critical | Nhập đầy đủ và chính xác tất cả dữ liệu hợp lệ | 1. Nhập toàn bộ dữ liệu hợp lệ.<br>2. Bấm nút Đăng ký.<br>3. Kiểm tra DB và màn hình danh sách. | Dữ liệu hợp lệ | 1. Lưu bản ghi mới thành công.<br>2. Hiển thị thông báo thành công.<br>3. Dữ liệu trong Database khớp hoàn toàn các trường thông tin đã điền trên UI. | | | | | | | | |
-
-### 3.5. Kiểm thử Ngoại lệ & Hệ thống (Exceptions & Systems)
-
-| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID]_0xx | Bấm nút Đăng ký nhiều lần liên tiếp (Double Click) | High | Đã điền đầy đủ dữ liệu hợp lệ | 1. Click liên tiếp nhiều lần vào nút Đăng ký/Lưu. | - | Nút bấm bị disable ngay sau lượt click đầu tiên. Hệ thống chỉ xử lý và tạo duy nhất 1 bản ghi trong DB, không tạo trùng lặp. | | | | | | | | |
-| [ID]_0xx | Kiểm tra mất kết nối mạng đột ngột khi bấm Lưu | High | Điền đầy đủ dữ liệu hợp lệ | 1. Bấm nút Lưu.<br>2. Đồng thời ngắt kết nối mạng. | - | Hệ thống hiển thị loading và thông báo lỗi kết nối mạng, không bị crash hoặc treo màn hình trắng. | | | | | | | | |
-| [ID]_0xx | Kiểm tra nhấn nút Quay lại | Low | Đã điền một số dữ liệu | 1. Nhập một số thông tin.<br>2. Bấm nút Quay lại. | - | Hệ thống chuyển hướng về màn hình danh sách trước đó.<br>Bản ghi mới không được tạo trong DB. | | | | | | | | |
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra không upload file (Trường tùy chọn) | Medium | Đã truy cập màn hình | 1. Không chọn file upload.<br>2. Bấm nút thực hiện. | - | Hệ thống cho phép thực hiện thành công mà không báo lỗi. | | |
+| [ID]_0xx | Kiểm tra upload file sai định dạng | High | Định dạng cho phép: jpeg, png | 1. Chọn upload file có định dạng không được phép (xlsx, gif, pdf...).<br>2. Tiến hành upload. | File `.pdf`, `.xlsx` | Upload không thành công. Hiển thị thông báo lỗi đúng thiết kế: "Hình ảnh phải là định dạng jpeg hoặc png." | | |
+| [ID]_0xx | Kiểm tra upload dung lượng vượt quá giới hạn | High | Giới hạn dung lượng: tối đa 10MB | 1. Chọn file có kích thước > 10MB.<br>2. Tiến hành upload. | File kích thước `10.5MB` | Upload thất bại. Hiển thị lỗi cảnh báo: "Dung lượng hình ảnh vượt quá 10MB." | | |
+| [ID]_0xx | Kiểm tra upload file giả mạo đuôi mở rộng (Spoofing) | High | Đã truy cập màn hình | 1. Đổi đuôi file thực thi nguy hiểm `.exe` thành `.jpg`.<br>2. Chọn upload file này. | File `.exe` đổi tên thành `.jpg` | Hệ thống kiểm tra phần thân file (MIME type) thực tế và báo lỗi không đúng định dạng. | | |
+| [ID]_0xx | Kiểm tra kéo thả file (Drag & Drop) | Low | Đã truy cập màn hình | 1. Kéo file ảnh thả vào vùng upload. | File `.png` hợp lệ | Upload file thành công và hiển thị thumbnail ảnh xem trước trên giao diện. | | |
+
+### 2.4. Kiểm thử Logic Nghiệp vụ (Business Rules - BR)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra ràng buộc trùng lặp dữ liệu duy nhất (Unique) | High | Đã tồn tại bản ghi trong DB | 1. Nhập thông tin trùng khóa chính/mã duy nhất với bản ghi cũ.<br>2. Điền các thông tin hợp lệ khác.<br>3. Bấm Đăng ký. | Mã trùng lặp | Hệ thống báo lỗi trùng lặp: "Mã/Tên này đã tồn tại trong hệ thống. Vui lòng kiểm tra lại." | | |
+| [ID]_0xx | Kiểm tra logic liên kết dữ liệu động (Dynamic Form Control) | High | Điều kiện thay đổi hiển thị | 1. Tích chọn/Bỏ tích chọn [Checkbox điều kiện]. | - | Giao diện tự động thay đổi hiển thị ẩn/hiện hoặc disable/enable các trường thông tin liên quan theo đúng mô tả Business Rule. | | |
+| [ID]_0xx | Kiểm tra lưu dữ liệu vào Database thành công | Critical | Nhập đầy đủ và chính xác tất cả dữ liệu hợp lệ | 1. Nhập toàn bộ dữ liệu hợp lệ.<br>2. Bấm nút Đăng ký.<br>3. Kiểm tra DB và màn hình danh sách. | Dữ liệu hợp lệ | 1. Lưu bản ghi mới thành công.<br>2. Hiển thị thông báo thành công.<br>3. Dữ liệu trong Database khớp hoàn toàn các trường thông tin đã điền trên UI. | | |
+
+### 2.5. Kiểm thử Ngoại lệ & Hệ thống (Exceptions & Systems)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Bấm nút Đăng ký nhiều lần liên tiếp (Double Click) | High | Đã điền đầy đủ dữ liệu hợp lệ | 1. Click liên tiếp nhiều lần vào nút Đăng ký/Lưu. | - | Nút bấm bị disable ngay sau lượt click đầu tiên. Hệ thống chỉ xử lý và tạo duy nhất 1 bản ghi trong DB, không tạo trùng lặp. | | |
+| [ID]_0xx | Kiểm tra mất kết nối mạng đột ngột khi bấm Lưu | High | Điền đầy đủ dữ liệu hợp lệ | 1. Bấm nút Lưu.<br>2. Đồng thời ngắt kết nối mạng. | - | Hệ thống hiển thị loading và thông báo lỗi kết nối mạng, không bị crash hoặc treo màn hình trắng. | | |
+| [ID]_0xx | Kiểm tra nhấn nút Quay lại | Low | Đã điền một số dữ liệu | 1. Nhập một số thông tin.<br>2. Bấm nút Quay lại. | - | Hệ thống chuyển hướng về màn hình danh sách trước đó.<br>Bản ghi mới không được tạo trong DB. | | |

package/custom/skills/test-analysis/SKILL.md

@@ -250,7 +250,6 @@ Tạo `test-plan/test-analysis.md`:
 
 ### Step 5: Present to Tester
 
-```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ⏸️ GATE 1: TEST ANALYSIS READY
 
@@ -266,11 +265,9 @@ Summary:
 
 ⚠️ I will NOT proceed to Gate 2 until I receive "APPROVED".
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
 
 **Nếu nhận được APPROVED mà còn câu hỏi clarify (Step 3) chưa được TESTER trả lời → từ chối ngay:**
 
-```
 ⛔ GATE 1 BLOCKED — Còn câu hỏi chưa được trả lời.
 
 Câu hỏi đang chờ:
@@ -278,7 +275,6 @@ Câu hỏi đang chờ:
 
 → Vui lòng trả lời câu hỏi trên trước khi gõ APPROVED.
 ❌ APPROVED không được chấp nhận khi còn câu hỏi chưa được làm rõ.
-```
 
 ---