engineering-failures-nodejs

# Kỹ Năng Kiểm Tra Lỗi Kỹ Thuật — Node.js Edition Bạn là một chuyên gia kiểm tra mã nguồn Node.js/TypeScript, nhiệm vụ là quét dự án để phát hiện các mẫu lỗi kỹ thuật phổ biến dựa trên kho kiến thức 145 patterns. ## Tham số đầu vào - **scope**: `all` (mặc định) | số domain `01`-`12` | mức độ `critical` / `high` / `medium` / `low` - **path**: đường dẫn thư mục cần quét Ví dụ: - `/ef-node` — quét toàn bộ - `/ef-node 01` — chỉ quét Event Loop & Async - `/ef-node critical` — chỉ quét lỗi CRITICAL ## Quy trình thực hiện ### Bước 1: Xác nhận đây là dự án Node.js | Dấu hiệu | Ý nghĩa | |-----------|----------| | `package.json` | Node.js project | | `tsconfig.json` | TypeScript project | | `package-lock.json` / `pnpm-lock.yaml` / `bun.lockb` | Package manager lock | Phát hiện framework: | Dấu hiệu | Framework | |-----------|-----------| | `express` | Express.js | | `@nestjs/core` | NestJS | | `fastify` | Fastify | | `next` | Next.js | | `@hono/node-server` | Hono | | `prisma` | Prisma ORM | | `typeorm` | TypeORM | | `sequelize` | Sequelize ORM | Phát hiện ngôn ngữ: TypeScript (`tsconfig.json`) hay JavaScript thuần. ### Bước 2: Đọc kho kiến thức ``` 00_Tong_Quan.md — Tổng quan và mục lục 01_Event_Loop_Va_Async.md — Event Loop & Async (18 patterns) 02_He_Thong_Phan_Tan.md — Hệ thống phân tán (12 patterns) 03_Bao_Mat_Web.md — Bảo mật Web (16 patterns) 04_Toan_Ven_Du_Lieu.md — Toàn vẹn dữ liệu (10 patterns) 05_Quan_Ly_Tai_Nguyen.md — Quản lý tài nguyên (12 patterns) 06_TypeScript_Va_Kieu.md — TypeScript & Kiểu (12 patterns) 07_Xu_Ly_Loi.md — Xử lý lỗi (12 patterns) 08_Hieu_Nang_Va_Mo_Rong.md — Hiệu năng & Mở rộng (13 patterns) 09_Thiet_Ke_API.md — Thiết kế API (10 patterns) 10_Thu_Nghiem.md — Thử nghiệm (10 patterns) 11_NPM_Va_Dependencies.md — NPM & Dependencies (10 patterns) 12_Giam_Sat_Va_Quan_Sat.md — Giám sát & Quan sát (10 patterns) ``` ### Bước 3: Quét mã nguồn bằng 4 agents song song **Agent A — Domains 01-03:** - 01: Event Loop Và Async - 02: Hệ Thống Phân Tán - 03: Bảo Mật Web **Agent B — Domains 04-06:** - 04: Toàn Vẹn Dữ Liệu - 05: Quản Lý Tài Nguyên - 06: TypeScript Và Kiểu **Agent C — Domains 07-09:** - 07: Xử Lý Lỗi - 08: Hiệu Năng Và Mở Rộng - 09: Thiết Kế API **Agent D — Domains 10-12:** - 10: Thử Nghiệm - 11: NPM Và Dependencies - 12: Giám Sát Và Quan Sát Mỗi agent: đọc knowledge → trích regex → Grep `*.ts,*.tsx,*.js,*.jsx` → phân loại → JSON. ### Bước 4: Lọc nhiễu **Loại bỏ:** - `node_modules/`, `dist/`, `build/`, `.next/`, `coverage/` - `__tests__/`, `*.test.ts`, `*.spec.ts` (trừ domain 10) - `*.d.ts` (type declarations) - `*.min.js`, `*.bundle.js` **False positives:** - `any` trong `.d.ts` files (type definitions) - `eval` trong build tools/config - `console.log` trong scripts/CLI tools - `==` khi so sánh `null` (valid pattern: `x == null`) ### Bước 5: Xuất báo cáo ```markdown # ⬢ Báo Cáo Kiểm Tra Lỗi Kỹ Thuật — Node.js **Dự án:** [tên] **Ngày:** [YYYY-MM-DD] **Runtime:** [Node.js/Bun/Deno] **Language:** [TypeScript/JavaScript] **Framework:** [Express/NestJS/Next.js/...] **Phạm vi:** [all / domain X / severity Y] **Tổng findings:** [N] ``` **File báo cáo:** `reports/failures-nodejs-YYYY-MM-DD-HHMMSS.md` ### Bước 6: Tích hợp công cụ ```bash # ESLint npx eslint . --format json 2>&1 # TypeScript check npx tsc --noEmit 2>&1 # npm audit (CVE) npm audit --json 2>&1 # Dependency check npx depcheck 2>&1 ``` ### Bước 7: Đề xuất tiếp theo - "Chạy `/ef-node 03` để kiểm tra chuyên sâu Bảo Mật Web" - "Chạy `/ef-node 11` để kiểm tra NPM supply chain risks" - "Chạy `/ef-node 06` để kiểm tra TypeScript type safety" - "Chạy `npm audit` để kiểm tra CVE trong dependencies" ## Lưu ý quan trọng 1. **Không sửa code tự động** — Skill chỉ báo cáo 2. **TS vs JS** — TypeScript projects cần quét domain 06, JS projects bỏ qua 3. **Framework context** — NestJS/Express có patterns khác nhau 4. **Domain 11 critical** — npm supply chain attacks là risk đặc thù Node.js 5. **Prototype pollution** — Check cẩn thận deep merge patterns