Hướng dẫn Câu lệnh

Bắt đầu trong chat dự án. Mở chat cho dự án bạn muốn thay đổi, sau đó chọn hoặc nhắc đến agent có vai trò phù hợp với công việc. Nếu bạn không chắc agent nào phù hợp, hãy yêu cầu nhóm làm rõ trước khi bắt đầu xây dựng.

Hướng dẫn này tổng hợp các kỹ thuật luôn mang lại kết quả tốt hơn từ nhóm agent của bạn. Không kỹ thuật nào trong số này đòi hỏi khả năng đặc biệt. Chúng liên quan đến điều bạn nói, không phải cách bạn định dạng nó. Dù bạn đang viết yêu cầu đầu tiên hay tinh chỉnh một dự án đã trưởng thành, các nguyên tắc giống nhau vẫn được áp dụng: suy nghĩ rõ ràng đầu vào, kết quả rõ ràng đầu ra.

Hãy để nhóm hỏi trước khi xây dựng

Một trong những cách hiệu quả nhất để có kết quả tốt hơn: khi một yêu cầu lớn hoặc còn mơ hồ, hãy mời họ đặt câu hỏi thay vì hy vọng nhóm đoán đúng. Hãy nêu điều bạn muốn, rồi thêm một dòng ở cuối:

Hãy hỏi tôi bất cứ điều gì bạn cần để hiểu đầy đủ điều tôi muốn trước khi bắt đầu.

Bạn thường sẽ nhận được những câu hỏi mà tự mình bạn sẽ không nghĩ tới để trả lời, dù đó là về trường hợp biên, đối tượng người dùng hay các đánh đổi. Giải quyết chúng ngay từ đầu chỉ tốn một phút; phát hiện ra chúng sau khi đã xây dựng sẽ tốn công làm lại. Kết quả sẽ gần với ý định của bạn hơn nhiều ngay từ lần đầu.

Bước 1: Quyết định trước khi gõ

Biết bạn đang xây dựng gì

Dành vài phút suy nghĩ trước có thể giúp bạn tiết kiệm rất nhiều lần viết lại Câu lệnh về sau. Trước khi bắt đầu, hãy chắc chắn rằng bạn có thể trả lời bốn câu hỏi đơn giản: bạn đang xây dựng gì, nó dành cho ai, tại sao họ sẽ dùng nó, và hành động chính bạn muốn họ thực hiện là gì.

Hành động chính đó thường được gọi là CTA, viết tắt của call to action. Đó là nút, liên kết hoặc bước tiếp theo mà bạn muốn người dùng chọn nhất, chẳng hạn như Sign Up, Book a Demo, Start Free hoặc Buy Now.

Bạn không cần phải viết một bản đặc tả đầy đủ. Mục tiêu chỉ đơn giản là đưa cho dự án một định hướng rõ ràng. Điểm khởi đầu của bạn càng cụ thể, việc tạo ra kết quả khớp với điều bạn hình dung càng dễ.

Xây dựng một trang web một trang cho ứng dụng quản lý ngân sách dành cho freelancer. CTA chính là “Start Saving Smarter.” Sử dụng phong cách táo bạo, giàu biểu cảm với kiểu chữ lớn và màu sắc nổi bật.

Phác thảo hành trình, không chỉ các màn hình

Thiết kế tốt tồn tại ở khoảng giữa các màn hình cũng nhiều như trên chính các màn hình đó. Hãy đi theo con đường người dùng của bạn sẽ đi: họ thấy gì đầu tiên, điều gì tạo dựng niềm tin, điều gì khiến họ tự tin hành động, và hành động đó sẽ dẫn đến đâu? Ngay cả một phác thảo ba nhịp, phần hero, bằng chứng, lời kêu gọi hành động, cũng khiến các yêu cầu của bạn hiệu quả hơn đáng kể, vì giờ đây mỗi phần đều có lý do để tồn tại và lý do để dẫn sang phần tiếp theo.

Đặt định hướng hình ảnh từ sớm

Phong cách dễ thiết lập từ đầu hơn nhiều so với việc vá lại sau này. Hãy chọn một hướng đi: điềm tĩnh và thanh lịch, táo bạo và phá cách, cao cấp và bóng bẩy, rồi nêu rõ trong yêu cầu đầu tiên bằng những từ ngữ về tông mà nhóm có thể hành động theo: tối giản, vui tươi, đậm chất điện ảnh, tập trung cho nhà phát triển. Những từ này không chỉ để trang trí: chúng định hình kiểu chữ, khoảng cách, màu sắc, đổ bóng và bo góc ngay từ component đầu tiên. Hãy dùng lại cùng một dòng mô tả phong cách trong các yêu cầu sau để giữ mọi thứ nhất quán.

Sử dụng thiết kế điềm tĩnh, lấy cảm hứng từ wellness: gradient nhẹ, tông màu đất trầm, góc bo tròn, khoảng đệm rộng rãi. Tổng thể nhẹ nhàng và tạo cảm giác an tâm.

Bước 2: Viết yêu cầu tạo ra kết quả đúng ý

Mô tả kết quả, không phải cách triển khai

Hãy mô tả kết quả bạn muốn, không phải các bước để xây dựng nó. Ví dụ, “Thêm một phần bảng giá với ba lựa chọn và làm cho lựa chọn ở giữa nổi bật” hữu ích hơn việc giải thích chính xác trang nên được dựng như thế nào. Hãy tập trung vào điều gì nên xuất hiện và vì sao nó quan trọng; nhóm có thể tự quyết định cách xây dựng.

Làm theo từng phần, không theo cả trang

Các yêu cầu được giới hạn trong một component — một phần hero, một lưới tính năng, một hàng lời chứng thực, một bảng giá — sẽ cho bạn sự rõ ràng và khả năng kiểm soát. Nếu một phần chưa đạt yêu cầu, bạn điều chỉnh phần đó thay vì tạo lại mọi thứ xung quanh. Hãy xây dựng một khối, xem lại, tinh chỉnh, rồi chuyển sang khối tiếp theo. Một yêu cầu cho cả trang tạo ra nhiễu; một yêu cầu cho component tạo ra tín hiệu.

Tạo một phần tính năng: tiêu đề căn giữa, sau đó là ba thẻ đặt cạnh nhau, mỗi thẻ có một biểu tượng, một tiêu đề và một dòng mô tả. Đổ bóng nhẹ, hơi nâng lên khi hover.

Dùng từ ngữ thực tế

Văn bản giữ chỗ che giấu vấn đề; nội dung thật sẽ làm lộ ra chúng. Một tiêu đề thật có thể cần hai dòng; một CTA thật có thể hoạt động tốt hơn khi dùng động từ. Hãy viết điều mà người dùng thực sự sẽ đọc, dù mới chỉ là bản nháp, vì bố cục, khoảng cách và các quyết định thiết kế đều tốt hơn khi nội dung là thật.

Tiêu đề hero: “Design Calmly.” Phụ đề: “Turn stress into structure.” CTA: “Start Building Free.” Bố cục lấy nội dung làm trung tâm với khoảng cách dọc rộng rãi.

Gọi tên các phần tử thực tế

Hãy dùng những từ rõ ràng, cụ thể để mô tả điều bạn muốn trên trang. Bạn không cần biết thuật ngữ thiết kế—chỉ cần gọi tên những gì người dùng nên thấy hoặc tương tác, như thẻ hồ sơ, nút bấm hoặc biểu mẫu.

Yêu cầu cụ thể luôn dễ xây dựng hơn yêu cầu chung chung. Hãy bắt đầu với phần tử cơ bản bạn cần, rồi thêm chi tiết từng chút một.

Tạo một thẻ hồ sơ với ảnh, tên và nút theo dõi. Thêm nhãn nhỏ “Verified” bên cạnh tên, và hiển thị một lời giải thích ngắn khi ai đó hover vào đó.

Bước 3: Thay đổi với độ chính xác cao

Xác định phạm vi cho mọi thay đổi: cái gì đổi, cái gì giữ nguyên

Khi điều chỉnh phần đã có, hãy nêu rõ ở cả hai phía: điều gì cần thay đổi và điều gì tuyệt đối không được đổi. Dùng các từ chỉ hướng như “thay thế”, “cập nhật” và “điều chỉnh” thay vì “làm cái này tốt hơn”, đồng thời khoanh vùng những phần bạn thích. Sự chính xác ở đây là điều giúp quá trình lặp không biến thành thụt lùi.

Đổi văn bản CTA thành “Get Started” và tăng khoảng đệm ngang của nó. Giữ nguyên màu sắc, phông chữ hiện tại và mọi thứ khác trong phần này.

Mỗi lần một thay đổi có ý nghĩa

Hãy cập nhật nội dung, rồi bố cục, rồi tương tác và kiểm tra từng kết quả trước khi gửi yêu cầu tiếp theo. Những bước nhỏ, có chủ đích sẽ cộng dồn thành một sản phẩm hoàn thiện; mười thay đổi trong một tin nhắn sẽ cộng dồn thành sự mơ hồ, và khi có gì đó sai, bạn sẽ không biết thay đổi nào gây ra nó.

Các chỉnh sửa giữa chừng diễn ra trong chat. Khi Prompt Queue khả dụng trong chat của bạn và công việc của Agent đang hoạt động, các tin nhắn tiếp theo sẽ được xếp hàng phía sau công việc đang chạy. Hãy xác nhận rằng tin nhắn của bạn xuất hiện trong hàng đợi trước khi gửi thêm một bản sao khác. Nếu các điều khiển hàng đợi không hiển thị, đừng gửi lại: hãy chờ công việc hiện tại hoàn tất, hoặc dùng điều khiển ngắt nếu chat của bạn có hỗ trợ, rồi xác nhận trạng thái tác vụ trước khi gửi tin nhắn tiếp theo. Xem chat dự án để biết chi tiết.

Nghĩ trước giao diện một bước

Nếu dự án của bạn cần làm được nhiều hơn là chỉ trông bóng bẩy, hãy xác định hành vi song song với hình thức. Chỉ rõ người dùng sẽ thấy gì khi đã đăng nhập hoặc chưa đăng nhập, nội dung động đến từ đâu, và giao diện xử lý các trạng thái trống, đang tải và lỗi như thế nào. Bạn không cần backend đang hoạt động để thiết kế xoay quanh các tình huống này—lên kế hoạch cho chúng từ sớm sẽ giúp tránh phải làm lại UI lớn về sau.

Nếu người dùng đã đăng nhập, hiển thị avatar và tên của họ ở góc trên bên phải. Nếu chưa, hiển thị nút “Log In” dẫn đến màn hình xác thực.

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

Làm thế nào để tôi viết một câu lệnh hiệu quả cho AI agent?

Hãy cấu trúc câu lệnh của bạn với các thành phần chính sau:

1. Bối cảnh — Đặt bối cảnh. Giải thích bạn đang xây dựng gì và hiện trạng đang ở đâu.

2. Mục tiêu — Nêu cụ thể kết quả hoặc tính năng chính xác mà bạn muốn.

3. Yêu cầu & Ràng buộc — Liệt kê rõ điều gì nên thay đổi và điều gì phải giữ nguyên.

4. Kết quả mong đợi — Xác định thành công trông như thế nào (ví dụ: hành vi UI, xử lý lỗi, duy trì trạng thái).

5. Tài liệu tham chiếu — Đính kèm ảnh chụp màn hình, liên kết, các bước quy trình làm việc hoặc mẫu mã khi có thể. Hãy xóa mật khẩu, mã xác minh, khóa API, cookie, dữ liệu cá nhân và chi tiết thanh toán trước khi chia sẻ.

Ví dụ: "Tôi đang xây dựng một dashboard có thanh bên. Hãy thêm nút đăng xuất ở cuối thanh bên. Nó phải xóa phiên và chuyển hướng đến /login. Không thay đổi bố cục thanh bên hoặc các liên kết điều hướng. Sau khi nhấp, người dùng phải thấy trang đăng nhập trong vòng 1 giây."

Tôi nên xử lý các yêu cầu phức tạp liên quan đến nhiều tính năng như thế nào?

Với các yêu cầu phức tạp, hãy chia chúng thành các tác vụ nhỏ hơn:

1. Nêu vấn đề hiện tại và mục tiêu cuối cùng.

2. Liệt kê từng tác vụ con riêng biệt (tác vụ 1, tác vụ 2, tác vụ 3).

3. Xác minh từng tác vụ trước khi chuyển sang tác vụ tiếp theo.

4. Kiểm tra toàn bộ luồng ở cuối.

Cách tiếp cận này giúp giảm các thay đổi ngoài ý muốn khi yêu cầu Agent làm quá nhiều việc cùng lúc. Mỗi câu lệnh nên tập trung vào một kết quả duy nhất, có thể xác minh được.

Làm thế nào để tôi viết một câu lệnh để sửa lỗi?

Một câu lệnh sửa lỗi hữu ích nên bao gồm:

• Trang, tính năng, môi trường và người dùng bị ảnh hưởng
• Các bước chính xác để tái hiện vấn đề
• Hành vi thực tế và hành vi mong đợi
• Toàn bộ nội dung lỗi và thời điểm nó xảy ra
• Ảnh chụp màn hình hoặc log liên quan, đã xóa mật khẩu, token, cookie, dữ liệu cá nhân và chi tiết thanh toán
• Điều gì phải giữ nguyên
• Cách xác minh bản sửa lỗi và những kiểm tra hồi quy cần chạy

Ví dụ: “Trên trang thanh toán trong Preview, khi chọn Submit thì trả về lỗi 500. Mong đợi: đơn hàng được xác nhận và người dùng đến trang cảm ơn. Tái hiện: [steps]. Hãy sửa nguyên nhân mà không thay đổi tổng tiền giỏ hàng hoặc luồng thanh toán, sau đó xác minh một trường hợp thanh toán thành công và một trường hợp thanh toán bị từ chối. Tôi đã xóa mọi giá trị bí mật khỏi log đính kèm.”

Làm thế nào để tôi viết một câu lệnh để chỉnh sửa bố cục hoặc kiểu dáng trang?

Khi yêu cầu chỉnh sửa trang, hãy bao gồm:

1. Trang, module và phần tử cụ thể cần chỉnh sửa.

2. Trạng thái hiện tại và kết quả mục tiêu.

3. Liên kết tham chiếu hoặc ảnh chụp màn hình.

4. Các tính năng phải giữ nguyên.

5. Tiêu chí chấp nhận (ví dụ: phải hoạt động trên cả desktop và mobile).

Ví dụ: "Trên trang /pricing, hãy đổi lưới thẻ gói từ 2 cột thành 3 cột trên desktop. Giữ bố cục mobile là một cột duy nhất. Tham chiếu ảnh chụp màn hình này [attach]. Không thay đổi nội dung thẻ hoặc kiểu nút."

Tôi nên làm gì khi agent liên tục thực hiện sai thay đổi dù đã được chỉnh sửa?

Khi Agent liên tục không đạt yêu cầu, việc thêm nhiều chỉ dẫn hơn đôi khi có thể gây rối hơn nữa. Thay vào đó:

1. Giữ nguyên trạng thái hiện tại — Ngừng gửi các chỉnh sửa chồng chéo. Nếu chat của bạn hiển thị điều khiển Revert, hãy đọc văn bản xác nhận của nó trước khi sử dụng, ghi chú mọi thay đổi về sau mà bạn cần giữ lại, và xác minh dự án sau đó. Nếu phạm vi chưa rõ ràng, đừng tiếp tục; hãy dùng hướng dẫn chat dự án hoặc liên hệ Support kèm Chat Link đã ẩn thông tin nhạy cảm và ảnh chụp màn hình.

2. Loại bỏ nhiễu — Thay vì chồng thêm chỉ dẫn, hãy nêu lại vấn đề cốt lõi một cách rõ ràng từ đầu.

3. Mỗi lần một tác vụ — Tập trung sửa một vấn đề duy nhất trước khi chuyển sang vấn đề tiếp theo.

Lùi lại một bước và xử lý thay đổi theo từng phần tăng dần thường sẽ giải quyết vấn đề nhanh hơn nhiều so với việc cố sửa nhiều vấn đề chồng chéo trong một câu lệnh.