Mục tiêu

Prompt này được thiết kế để hỗ trợ chuyển đổi mã JavaScript cũ sang TypeScript theo hướng an toàn, có kiểm soát và dễ triển khai trong dự án thật. Thay vì chuyển toàn bộ một lần, bạn có thể refactor từng file, từng module hoặc từng lớp logic để giảm rủi ro phát sinh lỗi.

Điểm mạnh của bộ prompt là yêu cầu AI phân tích hiện trạng mã nguồn, chỉ ra vùng rủi ro, đề xuất kiểu dữ liệu phù hợp và tạo lộ trình chuyển đổi theo từng bước. Kết quả không chỉ là mã TypeScript mới, mà còn bao gồm giải thích thay đổi, cảnh báo tương thích và gợi ý kiểm thử.

Khi nào nên dùng

• Khi bạn đang bảo trì codebase JavaScript legacy và muốn chuyển dần sang TypeScript.
• Khi cần thêm type safety nhưng không muốn viết lại toàn bộ hệ thống.
• Khi nhóm phát triển cần tài liệu hóa rõ các thay đổi để review hoặc handoff.
• Khi muốn xử lý dần các phần như utility, API layer, service, component hoặc business logic.
• Khi cần AI hỗ trợ phát hiện any ngầm, kiểu dữ liệu thiếu rõ ràng và khu vực dễ gây lỗi runtime.

Hướng dẫn tùy biến

1. Cung cấp phạm vi chuyển đổi

Hãy nêu rõ bạn muốn chuyển đổi ở cấp độ nào: một hàm, một file, một module hay cả một luồng chức năng. Nếu có thể, hãy nói rõ môi trường chạy như Node.js, React, Next.js, Express hoặc code thuần trình duyệt.

2. Thêm ràng buộc kỹ thuật

Bạn nên bổ sung các yêu cầu như không đổi hành vi hiện tại, không thêm thư viện mới, giữ tương thích với cấu hình build hiện có, hoặc chỉ dùng cú pháp TypeScript cơ bản. Điều này giúp AI tối ưu giải pháp đúng bối cảnh triển khai.

3. Yêu cầu định dạng đầu ra

Bạn có thể yêu cầu AI trả về theo cấu trúc gồm: phân tích rủi ro, danh sách thay đổi, mã TypeScript đã chuyển, giải thích từng quyết định về kiểu dữ liệu và checklist kiểm thử sau chuyển đổi.

4. Đưa thêm mã liên quan

Nếu đoạn JavaScript đang phụ thuộc vào hàm, interface ngầm, dữ liệu API hoặc cấu trúc object từ nơi khác, hãy cung cấp thêm. Càng đầy đủ ngữ cảnh, đề xuất type và chiến lược refactor càng chính xác.

Lưu ý

• Không nên để AI chuyển đổi mù nếu thiếu ngữ cảnh về dữ liệu đầu vào, đầu ra và các dependency liên quan.
• Ưu tiên chuyển đổi từng phần nhỏ, chạy test hoặc kiểm tra hành vi sau mỗi bước thay vì refactor diện rộng cùng lúc.
• Luôn review kỹ các type được suy luận tự động, đặc biệt với union type, generic, nullability và dữ liệu từ API.
• Nếu dự án có quy ước riêng như strict mode, ESLint, naming convention hoặc alias import, hãy nêu rõ trong prompt để tránh kết quả lệch chuẩn.

Giá trị nhận được

1. Giảm rủi ro khi nâng cấp codebase JavaScript cũ.
2. Tạo lộ trình TypeScript hóa thực tế, dễ áp dụng và dễ review.
3. Nhận được giải thích rõ ràng thay vì chỉ có đoạn mã kết quả.
4. Phù hợp cho lập trình viên cá nhân, team kỹ thuật và môi trường sản phẩm đang vận hành.