clarify

Tổng quan về clarify skill

clarify skill làm gì

clarify giúp cải thiện những phần UX copy chưa rõ ràng: nhãn, helper text, empty state, hướng dẫn onboarding, thông báo xác nhận và đặc biệt là thông báo lỗi. Skill này được tạo ra cho những tình huống người dùng bị rối không phải vì giao diện thiếu tính năng, mà vì câu chữ đang khiến sản phẩm khó hiểu hơn.

Khi nào clarify for UI/UX Design phù hợp nhất

clarify for UI/UX Design phù hợp nhất với product designer, UX writer, team frontend, PM và các AI agent đang rà soát nội dung giao diện trước khi phát hành. Nó phát huy hiệu quả nhất khi màn hình đã có sẵn và mục tiêu là làm câu chữ rõ hơn, dễ hành động hơn và khớp hơn với ngữ cảnh người dùng.

Công việc thực tế mà người dùng cần giải quyết

Người dùng không cài clarify chỉ để “viết lại copy cho hay hơn”. Họ dùng nó để trả lời những câu hỏi thực tế khó hơn: vì sao một thông điệp không phát huy tác dụng, người dùng có thể hiểu sai chỗ nào, nên bổ sung bao nhiêu ngữ cảnh, giọng điệu nào phù hợp với thời điểm đó, và cần viết lại ra sao để người dùng có thể hành động ngay mà không chần chừ.

Điểm khác biệt của clarify so với prompt chung chung

Khác biệt lớn nhất nằm ở quy trình. Skill này không phải kiểu prompt tự do “làm cho đoạn này hay hơn”. Nó buộc bạn đi qua một quy trình review có cấu trúc về:

• trình độ kỹ thuật của đối tượng người dùng
• trạng thái tâm lý của người dùng
• hành động người dùng cần thực hiện
• phần ngữ cảnh còn thiếu trong câu chữ hiện tại
• các lỗi rõ ràng cụ thể như jargon, mơ hồ, giả định ngầm hoặc lệch tone

Nhờ vậy, clarify skill hữu ích hơn nhiều so với một prompt chỉnh câu chữ chung chung khi điều quan trọng là người dùng phải hiểu đúng để thao tác, chứ không chỉ là văn phong đẹp hơn.

Lưu ý quan trọng trước khi áp dụng

Rào cản lớn nhất là skill này phụ thuộc vào ngữ cảnh thiết kế có sẵn. Nó yêu cầu rõ /frontend-design, và nếu chưa có ngữ cảnh thiết kế thì bạn phải chạy /teach-impeccable trước. Vì vậy, clarify install thì đơn giản ở cấp độ cài skill, nhưng chất lượng đầu ra lại phụ thuộc mạnh vào việc bạn có cung cấp trước ngữ cảnh sản phẩm, đối tượng người dùng và bối cảnh giao diện hay không.

Cách dùng clarify skill

clarify install và cách gọi skill

Đoạn repo được cung cấp cho thấy clarify là một skill có thể được người dùng gọi trực tiếp, với gợi ý tham số [target]. Trên thực tế, hãy cài nó từ repository pbakaus/impeccable và gọi clarify cho một màn hình, flow, component hoặc khối copy cụ thể, thay vì đưa ra một yêu cầu mơ hồ ở cấp độ toàn bộ sản phẩm.

Một cách cài và dùng thực tế là:

• thêm skill từ https://github.com/pbakaus/impeccable
• gọi clarify với một target cụ thể như modal, lỗi checkout, bước onboarding hoặc trang settings

Nếu môi trường của bạn hỗ trợ lệnh cài skill theo tên, hãy dùng URL của repo kèm path của skill clarify. Nếu không, hãy import bộ skill của repository rồi gọi trực tiếp clarify.

Nên đọc file này trước

Hãy bắt đầu với:

• SKILL.md

Skill này không có README.md, metadata.json, rule hay thư mục resource hỗ trợ nào hiển thị trong cây file đã cung cấp. Điều đó có nghĩa là phần lớn hướng dẫn sử dụng thực tế đều tập trung trong SKILL.md, và độ sâu triển khai ẩn phía sau cũng ít hơn so với các skill lớn hơn.

Ngữ cảnh cần có trước khi dùng clarify skill

Trước khi yêu cầu clarify viết lại bất kỳ nội dung nào, hãy thu thập:

• nguyên văn copy hiện tại
• vị trí nó xuất hiện trong UI
• đối tượng người dùng là ai
• trạng thái tâm lý có khả năng xảy ra của người dùng ở thời điểm đó
• hành động tiếp theo người dùng cần thực hiện
• mọi ràng buộc về sản phẩm hoặc domain

Điều này quan trọng vì skill đánh giá độ rõ ràng theo ngữ cảnh, không phải tách rời khỏi bối cảnh. Một bản viết lại đúng về mặt kỹ thuật vẫn có thể thất bại nếu nó bỏ qua yếu tố khẩn cấp, niềm tin hoặc mức độ am hiểu của người dùng.

Vì sao dependency frontend-design lại quan trọng

clarify usage được chain rõ ràng tới /frontend-design. Đây là tín hiệu mạnh cho thấy skill kỳ vọng các nguyên tắc thiết kế và một quy trình thu thập ngữ cảnh phải diễn ra trước. Nếu bỏ qua bước này, đầu ra có thể sạch câu chữ hơn về mặt ngôn ngữ, nhưng vẫn sai với flow, hierarchy hoặc mục tiêu người dùng.

Nếu chưa có ngữ cảnh thiết kế, skill hướng dẫn bạn chạy /teach-impeccable trước. Hãy xem đây là bước thiết lập bắt buộc, không phải phần đánh bóng tùy chọn.

Loại input nào cho kết quả tốt nhất

Input tốt là input cụ thể và có phạm vi rõ ràng. Ví dụ, hãy cung cấp:

• current text: “Authentication failed”
• surface: login form error under password field
• audience: non-technical SaaS users
• mental state: frustrated, trying to get back into work quickly
• desired action: retry password, reset if needed
• constraint: do not imply the email is wrong for security reasons

Cách này sẽ cho đầu ra tốt hơn nhiều so với:

• “Improve this error message”

Biến một yêu cầu sơ sài thành prompt clarify tốt

Yếu:

• “Make our onboarding copy clearer.”

Tốt hơn:

• “Use clarify on step 2 of onboarding. Current copy: ‘Configure your workspace for enhanced collaboration efficiency.’ Audience: first-time small business users with low technical confidence. Mental state: curious but impatient. Goal: get them to invite teammates. Constraint: keep headline under 8 words and body under 20 words.”

Phiên bản tốt hơn cung cấp cho clarify skill đủ thông tin để đánh giá jargon, ngữ cảnh còn thiếu, độ rõ của hành động và giọng điệu.

clarify có xu hướng kiểm tra những gì

Dựa trên SKILL.md, skill này sẽ kiểm tra có hệ thống các vấn đề như:

• jargon mà người dùng có thể không hiểu
• nội dung mơ hồ, có nhiều cách diễn giải
• câu bị động làm mờ chủ thể hành động
• copy quá dài hoặc quá cụt
• các giả định về kiến thức sẵn có của người dùng
• thiếu ngữ cảnh về chuyện gì vừa xảy ra hoặc cần làm gì tiếp theo
• giọng điệu không phù hợp với tình huống

Điểm này hữu ích vì nó cho bạn biết skill được tối ưu để bắt những loại lỗi nào.

Quy trình dùng clarify được khuyến nghị

Một quy trình thực tế:

1. Chạy /frontend-design và thu thập ngữ cảnh.
2. Chọn một surface cụ thể, không phải toàn bộ app.
3. Dán nguyên văn copy hiện tại.
4. Nêu rõ audience, mental state và hành động tiếp theo mong muốn.
5. Yêu cầu chẩn đoán trước, rồi mới viết lại.
6. Đối chiếu đầu ra với giới hạn không gian UI và ràng buộc sản phẩm.
7. Kiểm tra văn bản đã sửa trên các trạng thái liền kề như success, loading và failure.

Chuỗi bước này thường cho quyết định tốt hơn so với việc yêu cầu viết lại ngay lập tức mà không có phần chẩn đoán.

Hãy yêu cầu chẩn đoán trước khi chốt bản viết lại

Để tận dụng clarify guide hiệu quả hơn, trước tiên hãy hỏi:

• chỗ nào chưa rõ
• người dùng có thể hiểu sai điều gì
• đang thiếu ngữ cảnh nào
• giọng điệu có phù hợp với thời điểm đó không

Sau đó mới yêu cầu các phương án thay thế. Cách làm này giúp tránh viết lại quá sớm, đồng thời giúp bạn xác định vấn đề thật sự nằm ở wording, information architecture hay thiếu system feedback.

Trường hợp dùng clarify for UI/UX Design hiệu quả nhất

Skill này đặc biệt mạnh trong các trường hợp:

• thông báo lỗi không giải thích điều gì đã xảy ra hoặc người dùng nên làm gì tiếp theo
• nhãn dựa trên thuật ngữ nội bộ
• hướng dẫn onboarding giả định người dùng đã có kiến thức nền
• empty state có chỉ dẫn mơ hồ hoặc không hữu ích
• mô tả settings đúng về mặt kỹ thuật nhưng khó đọc, khó hiểu
• thông báo xác nhận và thành công không tạo được cảm giác yên tâm

Khi nào clarify không phải lựa chọn phù hợp

Đừng kỳ vọng clarify sẽ giải quyết:

• các vấn đề UX flow sâu hơn, nơi giao diện gây rối về mặt cấu trúc
• nội dung pháp lý hoặc compliance không thể thay đổi đáng kể
• bài toán thuần về brand voice khi độ rõ ràng vốn đã ổn
• nội dung cần sẵn sàng cho localization nếu chưa kiểm tra riêng các ràng buộc dịch thuật

Nếu vấn đề nằm ở interaction design chứ không phải câu chữ, hãy dùng clarify sau khi chính flow đã được sửa xong.

Câu hỏi thường gặp về clarify skill

clarify skill có thân thiện với người mới không?

Có, nếu bạn cung cấp được câu chữ hiện tại và ngữ cảnh cơ bản. Nhưng người mới thường bỏ qua phần khó nhất: mô tả đúng audience và trạng thái người dùng. Nếu thiếu phần này, clarify vẫn có thể cải thiện câu chữ, nhưng không thể cải thiện usability một cách ổn định.

Tôi có cần toàn bộ repo impeccable để dùng clarify không?

Bạn chủ yếu cần clarify cùng dependency ngữ cảnh bắt buộc của nó. Vì cây file hiển thị chỉ cho thấy SKILL.md của skill này, nên thực ra không có nhiều tài liệu bổ sung trong repo mà bạn phải nghiên cứu trước. Yêu cầu quan trọng nhất là có quyền truy cập tới /frontend-design và, khi cần, /teach-impeccable.

clarify khác gì so với việc chỉ yêu cầu AI viết lại copy?

Một prompt thông thường thường tối ưu cho cảm giác trau chuốt, mượt mà. clarify skill phù hợp hơn khi bạn cần AI soi các rủi ro về khả năng hiểu: jargon, giả định ngầm, mơ hồ, thiếu bước tiếp theo và tone trong điều kiện sử dụng thực tế.

clarify có xử lý tốt thông báo lỗi không?

Có. Error state là một trong những trường hợp phù hợp nhất vì skill yêu cầu rõ trạng thái tâm lý của người dùng và hành động tiếp theo. Điều này thường dẫn tới các bản viết lại hữu ích hơn so với kiểu prompt chung chung như “friendly error message”.

clarify chỉ dành cho microcopy thôi sao?

Không. Nó cũng có thể hỗ trợ với các chỉ dẫn ngắn và nội dung hướng dẫn trong giao diện. Tuy vậy, nó hiệu quả nhất với UI text có phạm vi rõ ràng, không phải các trang marketing dài hoặc hệ thống content design quy mô lớn.

Khi nào không nên cài clarify?

Hãy bỏ qua clarify install nếu nhu cầu chính của bạn là critique về visual design, tái cấu trúc IA hoặc content strategy cho tài liệu dài. Hãy cài khi nút thắt thực sự nằm ở độ rõ ràng của câu chữ trong giao diện sản phẩm.

Cách cải thiện clarify skill

Hãy cho clarify ngữ cảnh tốt hơn, không phải nhiều chữ hơn

Cách nhanh nhất để cải thiện đầu ra của clarify là cung cấp ràng buộc tốt hơn:

• vị trí chính xác trong UI
• giới hạn ký tự
• mức độ am hiểu của audience
• trạng thái cảm xúc
• hành động mong muốn
• các điều không được khẳng định hoặc giới hạn pháp lý

Nhiều copy xung quanh chỉ hữu ích nếu nó thực sự làm thay đổi cách diễn giải.

Tách phần chẩn đoán khỏi phần viết lại

Hãy yêu cầu clarify liệt kê ngắn các vấn đề trước khi xin bản copy cuối. Cách này giúp lộ rõ vấn đề thật là mơ hồ, thiếu ngữ cảnh hay lệch tone. Bạn sẽ có bản sửa tốt hơn khi kiểu lỗi được gọi tên trước.

Cho biết hành động hiện tại và hành động mong muốn của người dùng

Nhiều đầu ra yếu xuất hiện vì model không biết người dùng cần làm gì tiếp theo. Hãy nêu rõ cả hai:

• chuyện gì vừa xảy ra
• bây giờ người dùng nên làm gì

Ví dụ, “payment failed” là chưa đủ nếu skill không biết hành động đúng tiếp theo là thử lại, cập nhật thẻ, liên hệ hỗ trợ hay chờ thêm.

Nêu rõ mental state

Skill này đặt trọng số cao bất thường cho trạng thái tâm lý của người dùng, và đó cũng là một trong những đòn bẩy thực tế mạnh nhất của nó. “User is stressed and blocked” phải dẫn tới copy khác với “user is exploring settings casually.” Nếu bạn bỏ qua yếu tố này, giọng điệu rất dễ trở nên dễ chịu một cách chung chung thay vì thực sự hữu ích.

Yêu cầu nhiều phương án kèm tradeoff

Hãy xin 2 đến 4 phương án với các ưu tiên khác nhau, chẳng hạn:

• bản ngắn nhất
• bản tạo cảm giác yên tâm nhất
• bản thiên về thúc đẩy hành động nhất
• bản dễ hiểu nhất cho người dùng không kỹ thuật

Cách này giúp bạn so sánh tradeoff về độ rõ ràng thay vì mặc định xem một bản viết lại là phương án cuối cùng.

Theo dõi các failure mode phổ biến

Các cách clarify skill vẫn có thể hoạt động kém gồm:

• đánh bóng câu chữ nhưng không xử lý phần ngữ cảnh bị thiếu
• làm copy thân thiện hơn nhưng kém cụ thể hơn
• loại bỏ thuật ngữ kỹ thuật mà người dùng thực sự cần
• tạo ra nội dung quá dài so với component UI
• viết lại từng chuỗi riêng lẻ nhưng không nhất quán với các trạng thái liền kề

Những vấn đề này thường là do input, không chỉ đơn giản là do model.

Dùng ràng buộc UI thật trong quá trình lặp

Sau lượt đầu tiên, hãy siết yêu cầu lại:

• “Keep label under 24 characters”
• “Do not mention internal system names”
• “Must be understandable at 8th-grade reading level”
• “Should not blame the user”
• “Preserve security ambiguity around account existence”

Đây là lúc clarify guide chuyển từ mức chỉnh biên tập sang mức sẵn sàng cho production.

Kết hợp clarify với review các màn hình liền kề

Đừng cải thiện một thông điệp đơn lẻ nếu người dùng thực tế đi qua cả một chuỗi. Hãy review cùng lúc trigger, bản thân thông điệp và bước tiếp theo. Một dòng báo lỗi rõ ràng vẫn có thể thất bại nếu nhãn CTA hoặc helper text xung quanh vẫn mơ hồ.

Tạo prompt template có thể tái sử dụng

Với các team dùng clarify for UI/UX Design thường xuyên, hãy tạo một template gồm:

• target surface
• current copy
• audience
• mental state
• desired action
• constraints
• ask: diagnose first, then rewrite

Cách này giúp giảm sự thiếu nhất quán giữa các lần review và khiến skill dễ được gọi đúng cách hơn nhiều.

Cải thiện đầu ra của clarify bằng dữ liệu người dùng thực tế

Nếu bạn có support ticket, ghi chú usability hoặc ví dụ người dùng hiểu sai nội dung, hãy đưa chúng vào. clarify mạnh hơn đáng kể khi có thể viết lại dựa trên nhầm lẫn đã quan sát được, thay vì chỉ dựa trên giả định.