$npx -y skills add anhtester/codex-testing-kit --skill generate-requirements-from-websiteGenerate Requirements content from a provided website module
| 1 | # Workflow: Generate Requirements from Website Module |
| 2 | |
| 3 | > **BẮT BUỘC (MANDATORY SKILL):** Bạn PHẢI nạp và đọc kỹ nội dung của skill **`$requirements-analyzer`** (tại `.agents/skills/requirements-analyzer/SKILL.md`) để biết định dạng chuẩn của tài liệu Requirements trước khi bắt đầu thực hiện tác vụ này. |
| 4 | |
| 5 | Workflow này giúp bạn phân tích một module hoặc trang web được cung cấp và sinh ra tài liệu Yêu cầu (Requirements) chi tiết, chuẩn xác, phục vụ cho quá trình kiểm thử hoặc phát triển. |
| 6 | |
| 7 | ## Các bước thực hiện: |
| 8 | |
| 9 | 1. **Tiếp nhận thông tin (Information Gathering):** |
| 10 | - Đọc kỹ hướng dẫn từ kỹ năng (skill) **`$requirements-analyzer`** để nắm bắt chuẩn đầu ra. |
| 11 | - Lấy thông tin URL của trang web, tên module, hoặc mô tả/hình ảnh mà người dùng cung cấp. |
| 12 | - Nếu cần thiết, hỏi người dùng về thông tin đăng nhập hoặc các trạng thái đặc biệt cần lưu ý. |
| 13 | |
| 14 | 2. **Khảo sát hệ thống (Recon & Investigation):** |
| 15 | - Sử dụng các công cụ duyệt web (Browser tools/MCP) hoặc `read_url_content` để truy cập vào module trang web được yêu cầu. |
| 16 | - Inspect kỹ lưỡi cấu trúc HTML, DOM, các form nhập liệu, các nút tương tác (buttons, links), và các thông báo lỗi (validation messages). |
| 17 | - *Lưu ý: Không tự đoán các trường thông tin nếu không nhìn thấy trên giao diện thực tế.* |
| 18 | |
| 19 | 3. **Phân tích chức năng và tương tác (Analyze UI & Interactions):** |
| 20 | - Phân tích luồng thao tác (User Flows). |
| 21 | - Ghi nhận các trường dữ liệu tĩnh và động (Ví dụ: TextBox, Dropdown, Checkbox). |
| 22 | - Ghi nhận các quy tắc nghiệp vụ hiển thị ở giao diện (Business Rules) như: trường bắt buộc (mandatory fields), định dạng hợp lệ (email, số điện thoại), hoặc giới hạn ký tự. |
| 23 | |
| 24 | 4. **Biên soạn tài liệu Yêu cầu (Draft Requirements):** |
| 25 | - Dựa trên dữ liệu thu thập được, tạo một tài liệu mô tả bao gồm: |
| 26 | * **Tổng quan (Overview):** Mục đích của module/trang. |
| 27 | * **Yêu cầu chức năng (Functional Requirements):** Danh sách các tính năng người dùng có thể thực hiện (vd: Đăng nhập, Thêm mới, Xóa...). |
| 28 | * **Quy tắc trường dữ liệu (Field Specifications):** Bảng chi tiết về từng thành phần UI (Tên trường, Loại, Bắt buộc/Không, Ràng buộc dữ liệu). |
| 29 | * **Luồng xử lý (Business/User Flows):** Các bước để hoàn thành một chức năng chính. |
| 30 | * **Yêu cầu phi chức năng (Non-functional Requirements - Nếu có thể quan sát):** Tính tương thích, hiệu năng tĩnh. |
| 31 | |
| 32 | 5. **Trình bày và Cung cấp (Review & Delivery):** |
| 33 | - Định dạng tài liệu bằng Markdown rõ ràng. |
| 34 | - Trình bày toàn bộ nội dung bằng **Tiếng Việt** có dấu rõ ràng, chuyên nghiệp và dễ hiểu. |
| 35 | - Sử dụng tính năng Artifact nếu tài liệu dài để người dùng tiện lưu trữ hoặc xuất file. |