Checklist prompt Windsurf: tôi kiểm tra gì trước khi gửi task

Vì sao tôi dùng checklist trước khi gửi cho Windsurf

Khi mới dùng AI coding tools, tôi thường gửi cho Windsurf một ý tưởng thô rồi chờ kết quả. Cách đó ổn với màn hình đơn giản, nhưng dễ gây lỗi trong dự án thật. Công cụ có thể tạo đúng trang nhưng sai thư mục, sửa output đã generate thay vì source generator, hoặc thêm CTA không khớp hệ thống route hiện tại.

Checklist khiến tôi chậm lại khoảng năm phút. Nghe có vẻ mất thời gian, nhưng thường tiết kiệm nhiều thời gian sửa lỗi sau đó. Trước khi để Windsurf chạm vào project, tôi muốn biết mục tiêu trang, file liên quan, ràng buộc, internal links, lệnh validate và kiểu báo cáo cuối.

Điều này đặc biệt hữu ích với static SEO site. Một trang có thể nhìn ổn trên trình duyệt nhưng sitemap, canonical URL, hreflang hoặc bản ngôn ngữ lại sai. Checklist giữ task bám vào pipeline publish thật.

Checklist tôi đang dùng

Checklist Windsurf của tôi bắt đầu bằng mục tiêu người dùng. Tôi viết rõ sau thay đổi này người đọc hoặc người dùng phải làm được gì. Với một bài blog, mục tiêu có thể là hiểu workflow và đi tiếp sang bài chính. Với bug fix, mục tiêu có thể là chặn code block bị tràn trên mobile.

Tiếp theo tôi liệt kê nguồn đúng cần sửa. Nếu trang được generate, tôi ghi rõ phải sửa source generator, không chỉ sửa HTML đã sinh ra. Nếu route phải hoạt động trên GitHub Pages, tôi nhắc cả `site_output` và `docs` để công cụ không dừng quá sớm.

Sau đó tôi thêm quy tắc an toàn. Các quy tắc thường dùng là: không deploy, không gọi API ngoài, không tạo affiliate link giả, không thêm secret, không bật auto-posting và không phá hành vi redirect `/go/`.

Cuối cùng tôi đưa lệnh test. Prompt không nên kết thúc bằng câu "hãy sửa". Nó nên yêu cầu build, sync, validate, kiểm tra language integrity, kiểm tra go pages và báo cáo ngắn. Như vậy kết quả dễ tin hơn.

Ví dụ prompt: tạo bài hỗ trợ

Khi yêu cầu Windsurf tạo một bài hỗ trợ, tôi không chỉ đưa tiêu đề. Tôi mô tả cluster, bài chính, internal links và quy tắc chất lượng nội dung. Cách này tránh việc bài mới trở thành một trang rời rạc.

Prompt bên dưới là kiểu chỉ dẫn tôi sẽ gửi khi tạo thêm một trang trong cụm nội dung AI coding workflow này.

Create a supporting SEO blog article for /blog/chatgpt-prompts-for-windsurf/. Keep the current site style and bilingual pipeline. Add clear H1, intro, table of contents, practical sections, prompt examples, common mistakes, Câu hỏi thường gặp, related links, and CTA to the workflow checklist. Link naturally to /blog/chatgpt-prompts-for-windsurf/, /windsurf-review/, /comparisons/cursor-vs-windsurf/, and /free-ai-coding-workflow-checklist/. Do not add fake affiliate links, API calls, or auto-posting logic. Rebuild, sync docs, and run validation.

Ví dụ prompt: sửa một lỗi cụ thể

Với bug fix, tôi cố làm prompt hẹp hơn. Windsurf xử lý tốt hơn khi task có lỗi hiển thị rõ, một nhóm file có khả năng liên quan và định nghĩa thế nào là xong.

Kiểu prompt này hữu ích khi một trang nhìn bị lỗi nhưng tôi chưa biết CSS rule hay generator function nào là nguyên nhân.

The blog page /blog/chatgpt-prompts-for-windsurf/ has long prompt examples inside pre/code blocks that overflow outside the article card. Inspect the shared article CSS in modules/site_builder.py and any generated blog page output. Fix the source CSS so pre, code, .prompt, and .code-block stay inside the content width on desktop and mobile. Do not change article content. Rebuild, sync docs, validate the site, and report the exact files changed.

Những lỗi prompt thường gặp

Lỗi lớn nhất là yêu cầu Windsurf làm chiến lược, viết nội dung, code, SEO, tracking và cleanup deploy trong một lệnh mơ hồ. Nó có thể thử làm, nhưng kết quả rất khó review.

Lỗi thứ hai là không nói rõ file hoặc pipeline. Nếu project generate `docs` từ `site_output`, prompt nên ghi điều đó. Nếu trang tiếng Việt được tạo từ trang tiếng Anh, prompt nên nhắc pipeline localization.

Lỗi thứ ba là bỏ qua validation. Một trang không phải đã xong chỉ vì nó tồn tại. Nó chỉ nên xem là xong khi link chạy, sitemap cập nhật, language integrity pass và nội dung đọc tự nhiên.

Các hướng dẫn liên quan trong workflow này

Nếu muốn xem toàn bộ quy trình, hãy bắt đầu với bài prompt ChatGPT cho Windsurf. Nếu vấn đề của bạn là output song ngữ, đọc tiếp bài xử lý lỗi lẫn ngôn ngữ. Nếu Windsurf đã tạo bản đầu nhưng project cần cleanup kỹ hơn, dùng bài workflow Windsurf sang Codex.

Các bài này được thiết kế để hỗ trợ nhau. Một bài giải thích thói quen viết prompt, một bài đưa checklist, một bài xử lý lỗi ngôn ngữ và một bài giải thích khi nào nên chuyển từ bản build đầu sang sửa tập trung.

Câu hỏi thường gặp

Bước tiếp theo

Nếu bạn muốn áp dụng quy trình này cho static site hoặc ý tưởng app của mình, hãy bắt đầu với bài workflow chính rồi dùng checklist trước khi gửi prompt tiếp theo cho Windsurf.