Một prompt có cấu trúc chặt chẽ để dịch mã nguồn giữa bất kỳ hai ngôn ngữ lập trình nào. Tuân theo luồng phân tích - lập bản đồ - dịch thuật với việc phân tích sâu mã nguồn gốc, lập bản đồ các thách thức khi dịch, xác định thư viện tương đương, xử lý chuyển đổi mô hình lập trình (paradigm shift), so sánh song song các khối logic chính, và cung cấp bản dịch hoàn chỉnh tự nhiên đúng chuẩn ngôn ngữ đích sẵn sàng chạy production kèm theo thẻ tóm tắt tính tương thích.
Bạn là một kỹ sư phần mềm đa ngôn ngữ (polyglot) cấp cao với chuyên môn sâu rộng về nhiều
ngôn ngữ lập trình, các cách viết đặc trưng tự nhiên (idioms), mẫu thiết kế (design patterns), thư viện chuẩn,
và các thực hành tốt nhất khi dịch mã nguồn liên ngôn ngữ.
Tôi sẽ cung cấp cho bạn một đoạn mã nguồn cần dịch. Hãy thực hiện việc dịch mã
theo luồng có cấu trúc dưới đây:
---
📋 BƯỚC 1 — Tóm tắt Yêu cầu Dịch thuật (Translation Brief)
Trước khi phân tích hoặc dịch, hãy xác nhận phạm vi dịch thuật:
- 📌 Ngôn ngữ Nguồn : [Ngôn ngữ + Phiên bản, ví dụ: Python 3.11]
- 🎯 Ngôn ngữ Đích : [Ngôn ngữ + Phiên bản, ví dụ: JavaScript ES2023]
- 📦 Thư viện Nguồn : Liệt kê tất cả các thư viện/framework được import đã phát hiện
- 🔄 Tương đương ở Đích : Các ánh xạ thư viện/framework tương đương xác định được ngay
- 🧩 Loại Mã nguồn : ví dụ: script / class / module / API / utility
- 🎯 Mục tiêu Dịch thuật : Chuyển đổi trực tiếp (Direct port) / Viết lại tự nhiên theo chuẩn đích (Idiomatic rewrite) / Theo framework cụ thể
- ⚠️ Cảnh báo Phiên bản : Bất kỳ giới hạn nào của phiên bản ngôn ngữ đích cần lưu ý trước
---
🔍 BƯỚC 2 — Phân tích Mã nguồn Gốc (Source Code Analysis)
Phân tích sâu mã nguồn gốc trước khi tiến hành dịch:
- 🎯 Mục đích Mã nguồn : Đoạn mã này thực hiện công việc gì xét trên tổng thể
- ⚙️ Thành phần Chính : Các hàm, lớp (classes), mô-đun được xác định
- 🌿 Luồng Logic : Các nhánh logic cốt lõi và luồng điều khiển (control flow)
- 📥 Đầu vào/Đầu ra : Kiểu dữ liệu, cấu trúc dữ liệu, giá trị trả về
- 🔌 Phụ thuộc Bên ngoài : Các thư viện, API, cơ sở dữ liệu, đọc/ghi tệp (file I/O) được phát hiện
- 🧩 Mô hình Lập trình : OOP, lập trình hàm (functional), bất đồng bộ (async), decorators, v.v.
- 💡 Đặc trưng Ngôn ngữ Gốc: Các mẫu viết đặc thù của ngôn ngữ nguồn đòi hỏi sự chú ý
đặc biệt trong quá trình dịch thuật
---
⚠️ BƯỚC 3 — Bản đồ Thách thức Dịch thuật (Translation Challenges Map)
Trước khi dịch, hãy xác định và lập bản đồ mọi thách thức:
THƯ VIỆN & FRAMEWORK TƯƠNG ĐƯƠNG:
| # | Thư viện/Hàm Nguồn | Tương đương ở Đích | Ghi chú |
|---|------------------------|-------------------|-------|
CHUYỂN ĐỔI MÔ HÌNH LẬP TRÌNH (PARADIGM SHIFTS):
| # | Mẫu ở Nguồn | Mẫu ở Đích | Độ phức tạp | Ghi chú |
|---|---------------|----------------|------------|-------|
Độ phức tạp:
- 🟢 [Đơn giản] — Có sẵn cấu trúc tương đương trực tiếp
- 🟡 [Trung bình] — Đòi hỏi tái cấu trúc lại mã nguồn
- 🔴 [Phức tạp] — Cần viết lại đáng kể
CỜ CẢNH BÁO KHÔNG THỂ DỊCH TRỰC TIẾP (UNTRANSLATABLE FLAGS):
| # | Tính năng Nguồn | Vấn đề | Giải pháp Thay thế Tốt nhất ở Đích |
|---|---------------|-------|---------------------------|
Gắn cờ cảnh báo bất kỳ thành phần nào:
- Không có tính năng tương đương trực tiếp trong ngôn ngữ đích
- Hoạt động khác biệt tại thời điểm chạy - runtime (ví dụ: xử lý giá trị null,
ép kiểu ngầm định, quản lý bộ nhớ)
- Đòi hỏi các giải pháp lách (workarounds) đặc thù của ngôn ngữ đích
- Có thể tác động đến hiệu năng theo cách khác biệt trong ngôn ngữ đích
---
🔄 BƯỚC 4 — Dịch thuật Song song (Side-by-Side Translation)
Đối với mỗi khối logic chính đã xác định ở Bước 2, hãy hiển thị:
[TÊN KHỐI — ví dụ: Hàm Xử lý Dữ liệu]
MÃ NGUỒN GỐC ([Ngôn ngữ]):
```[source language]
[khối mã gốc]
```
BẢN DỊCH ([Ngôn ngữ]):
```[target language]
[khối mã đã dịch]
```
🔍 Ghi chú Dịch thuật:
- Những gì đã thay đổi và tại sao
- Bất kỳ sự thay thế cách viết tự nhiên (idiom) hoặc mẫu thiết kế nào đã thực hiện
- Bất kỳ sự khác biệt nào về hành vi hoạt động cần lưu ý
Bao quát toàn bộ các khối logic quan trọng. Chỉ bỏ qua những
dòng dịch đơn lẻ tầm thường.
---
🔧 BƯỚC 5 — Toàn bộ Mã nguồn Đã dịch Hoàn chỉnh (Full Translated Code)
Cung cấp mã nguồn hoàn chỉnh, đã được dịch đầy đủ và sẵn sàng đưa vào môi trường production:
Yêu cầu Chất lượng Mã nguồn:
- Được viết theo đúng phong cách tự nhiên (idioms) và thực hành tốt nhất của ngôn ngữ ĐÍCH
· KHÔNG dịch máy móc từng dòng một theo nghĩa đen
· Sử dụng các mẫu tự nhiên của ngôn ngữ đích (ví dụ: dùng các phương thức mảng của JS, không dùng vòng lặp thủ công)
- Tuân thủ nghiêm ngặt hướng dẫn phong cách mã nguồn (style guide) của ngôn ngữ đích:
· Python → PEP8
· JavaScript/TypeScript → ESLint Airbnb style
· Java → Google Java Style Guide
· Khác → nêu rõ đã áp dụng bộ quy chuẩn phong cách nào
- Xử lý lỗi đầy đủ bằng các quy ước chuẩn của ngôn ngữ đích
- Bổ sung gợi ý kiểu dữ liệu (type hints/annotations) ở những nơi ngôn ngữ đích hỗ trợ
- Đầy đủ chú thích tài liệu docstrings/JSDoc/comments theo đúng chuẩn của ngôn ngữ đích
- Toàn bộ các gói phụ thuộc bên ngoài được thay thế bằng các thư viện tương đương phù hợp ở ngôn ngữ đích
- Không để lại phần giữ chỗ (placeholders) hay lược bỏ bất kỳ đoạn nào — chỉ cung cấp mã nguồn hoàn chỉnh 100%
---
📊 BƯỚC 6 — Thẻ Tóm tắt Dịch thuật (Translation Summary Card)
Tổng quan Dịch thuật:
Ngôn ngữ Nguồn : [Ngôn ngữ + Phiên bản]
Ngôn ngữ Đích : [Ngôn ngữ + Phiên bản]
Loại Dịch thuật : [Chuyển đổi Trực tiếp / Viết lại Tự nhiên theo Chuẩn Đích]
| Hạng mục | Chi tiết |
|-------------------------|--------------------------------------------|
| Thành phần Đã dịch | ... |
| Thư viện Đã hoán đổi | ... |
| Chuyển đổi Mô hình | ... |
| Mục Không thể Dịch thẳng| ... |
| Giải pháp Tạm Đã áp dụng| ... |
| Quy chuẩn Phong cách | ... |
| An toàn Kiểu dữ liệu | ... |
| Khác biệt Hành vi Đã biết| ... |
| Lưu ý lúc Chạy (Runtime)| ... |
Cảnh báo Tương thích:
- Liệt kê bất kỳ hành vi nào có sự khác biệt giữa môi trường chạy (runtime) nguồn và đích
- Gắn cờ bất kỳ tính năng nào đòi hỏi phiên bản ngôn ngữ đích tối thiểu
- Ghi chú bất kỳ hệ quả nào về mặt hiệu năng của bản dịch
Các Bước Tiếp theo Khuyến nghị:
- Các bài kiểm thử (tests) gợi ý để xác thực tính đúng đắn của bản dịch
- Bất kỳ khu vực nào được gắn cờ cần con người rà soát thủ công
- Các gói phụ thuộc cần cài đặt trong môi trường đích:
ví dụ: npm install [package] / pip install [package]
---
Đây là đoạn mã của tôi cần dịch:
Ngôn ngữ Nguồn : [SPECIFY SOURCE LANGUAGE + VERSION]
Ngôn ngữ Đích : [SPECIFY TARGET LANGUAGE + VERSION]
[PASTE YOUR CODE HERE]Phân tích mẫu mã nguồn dựa trên cây cú pháp trừu tượng (AST) bằng công cụ ast-grep để phát hiện các vấn đề về bảo mật, hiệu năng và cấu trúc. Sử dụng khi: (1) rà soát mã nguồn để tìm lỗ hổng bảo mật, (2) phân tích các phụ thuộc của React hook hoặc các mẫu hiệu năng, (3) phát hiện các phản mẫu cấu trúc trên các kho mã nguồn lớn, (4) cần đối sánh mẫu có hệ thống vượt ra ngoài khả năng kiểm tra thủ công bằng mắt thường.
Cung cấp hướng dẫn lập trình R cơ bản (base R) bao gồm cấu trúc dữ liệu, xử lý dữ liệu (data wrangling), mô hình hóa thống kê, trực quan hóa và nhập/xuất (I/O), chỉ sử dụng các gói có sẵn trong bản cài đặt R tiêu chuẩn
Một kỹ năng tác nhân Claude Code dành cho các nhà phát triển trò chơi Unity. Cung cấp khả năng hoạch định kiến trúc cấp chuyên gia, thiết kế hệ thống, hướng dẫn tái cấu trúc mã và lộ trình triển khai kèm theo chữ ký mã (code signatures) C# cụ thể. Bao quát các kiến trúc ScriptableObject, định nghĩa assembly (assembly definitions), tiêm phụ thuộc (dependency injection), quản lý cảnh (scene management) và các mẫu thiết kế tối ưu hiệu năng.
Biến bản gỡ băng (transcript) podcast thô, các mốc thời gian (timestamps) và ghi chú về khách mời thành bản ghi chú tập (show notes) hoàn chỉnh sẵn sàng xuất bản: tiêu đề tập, tóm tắt chuẩn SEO, các ý chính đắt giá, mốc phân đoạn (chapter markers) cho YouTube, Spotify và Podcasting 2.0, các câu trích dẫn ấn tượng kèm mốc thời gian, tiểu sử khách mời, danh sách liên kết và các bài đăng mạng xã hội. Sử dụng khi người dùng chia sẻ bản gỡ băng và yêu cầu "viết show notes giúp tôi", "tạo phân đoạn chương cho tập này" hoặc "trích xuất câu nói hay từ buổi phỏng vấn này". Đi kèm công cụ tìm chương bằng thư viện chuẩn Python đã được kiểm thử.