Hướng dẫn Câu lệnh
Hãy quyết định trước khi gõ, xây dựng theo từng phần, dùng nội dung thực tế và đưa từng yêu cầu đến đúng agent. Những thói quen này biến các ý tưởng một dòng thành kết quả hoàn chỉnh.
Hãy quyết định trước khi gõ, xây dựng theo từng phần, dùng nội dung thực tế và đưa từng yêu cầu đến đúng agent. Những thói quen này biến các ý tưởng một dòng thành kết quả hoàn chỉ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 vẫn giống nhau: 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 mơ hồ, hãy mời đặt câu hỏi thay vì hy vọng nhóm đoán đúng. 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ề các 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 bạn gõ
Biết bạn đang xây dựng gì
Dành vài phút suy nghĩ từ đầu 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, vì 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 viết một bản đặc tả đầy đủ. Mục tiêu đơ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 một app quản lý ngân sách hướng đến 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 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ì cho họ sự tự tin để hành động, và hành động đó 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.
Thiết lập định hướng hình ảnh từ sớm
Phong cách dễ thiết lập hơn rất nhiều so với việc chắp vá về sau. Hãy chọn một hướng: đ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ừ mô tả sắc thái 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 vào 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ừ chăm sóc sức khỏe: chuyển sắc 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 hiệu quả
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ể quyết định cách xây dựng nó.
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 — phần hero, lưới tính năng, hàng lời chứng thực, 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 đúng ý, bạn chỉnh phần đó thay vì tạo lại mọi thứ xung quanh nó. Xây 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 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 dưới 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, bố cục, khoảng cách và các quyết định thiết kế đều sẽ 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 tập trung vào nội dung với khoảng cách dọc rộng rãi.
Gọi tên các thành phần 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 thứ người dùng nên nhìn thấy hoặc tương tác, chẳng hạn như thẻ hồ sơ, nút bấm hoặc biểu mẫu.
Các yêu cầu cụ thể dễ xây dựng hơn các yêu cầu chung chung. Hãy bắt đầu với thành phần cơ bản bạn cần, rồi thêm chi tiết từng cái 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 giải thích ngắn khi ai đó hover lên đó.
Bước 3: Thay đổi một cách chính xác
Giới hạn 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ì nên thay đổi và điều gì không được thay đổi. Dùng các từ chỉ định hướng như “replace”, “update” và “adjust” thay vì “make this better”, đồng thời khoanh vùng những phần bạn thích. Sự chính xác ở đây chính 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 trước, rồi đến bố cục, rồi đến 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 trau chuốt; 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 không thấy các điều khiển hàng đợi, đừ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 một backend 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.
FAQ
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 yếu tố chính sau:
1. Bối cảnh — Thiết lập ngữ cảnh. Giải thích bạn đang xây dựng gì và hiện tại mọi thứ đang ở trạng thái nào.
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ã bất cứ khi nào có thể. Hãy xóa mật khẩu, mã xác minh, API keys, cookies, 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. Thêm nút đăng xuất vào 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ả đơn lẻ, có thể xác minh.
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 nhật ký liên quan, đã xóa mật khẩu, token, cookies, dữ liệu cá nhân và chi tiết thanh toán
- Những gì phải giữ nguyên
- Cách xác minh bản sửa lỗi và cần chạy những kiểm tra hồi quy nào
Ví dụ: “Trên trang thanh toán trong Preview, việc chọn Submit 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: [các bước]. 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 tất cả giá trị bí mật khỏi nhật ký đí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, mô-đun và thành phần 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, đổ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. Tham chiếu ảnh chụp màn hình này [đính kèm]. 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 làm đúng ý, 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 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 không 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 đã được ẩ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 việc tiếp theo.
Lùi lại một bước và xử lý các thay đổi theo từng phần nhỏ 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.