clarify

Tổng Quan

clarify là gì?

Kỹ năng clarify được thiết kế để hỗ trợ các nhà thiết kế UI và UX, lập trình viên frontend, và nhóm sản phẩm cải thiện hệ thống các đoạn văn bản giao diện không rõ ràng. Nó tập trung vào việc chỉnh sửa văn bản UX, thông báo lỗi, microcopy, nhãn và hướng dẫn nhằm giúp sản phẩm số dễ hiểu và dễ sử dụng hơn. Nếu người dùng của bạn gặp khó khăn với các nhãn mơ hồ, thông báo lỗi không rõ ràng hoặc hướng dẫn khó theo dõi, clarify cung cấp một phương pháp có cấu trúc để xác định và giải quyết những vấn đề này.

Ai nên sử dụng clarify?

clarify phù hợp với bất kỳ ai chịu trách nhiệm về thiết kế giao diện, viết UX hoặc phát triển frontend. Nó đặc biệt hữu ích khi bạn nhận được phản hồi về văn bản gây nhầm lẫn, nhãn không rõ ràng hoặc thông báo lỗi không hiệu quả, hoặc khi bạn muốn chủ động nâng cao độ rõ ràng trong giao tiếp của sản phẩm.

Những vấn đề clarify giải quyết

• Văn bản giao diện không rõ ràng hoặc mơ hồ
• Thuật ngữ kỹ thuật gây nhầm lẫn cho người dùng
• Thông báo lỗi không giúp người dùng khắc phục
• Hướng dẫn khó hiểu hoặc khó làm theo
• Sự không phù hợp về giọng điệu hoặc thiếu bối cảnh trong văn bản UI

Cách Sử Dụng

Các bước cài đặt

1. Cài đặt clarify bằng lệnh sau:

   npx skills add https://github.com/pbakaus/impeccable --skill clarify
   

2. Bắt đầu bằng cách xem xét file SKILL.md trong thư mục kỹ năng clarify. File này trình bày quy trình làm việc, các bước chuẩn bị và các thực hành tốt nhất để cải thiện văn bản giao diện.

Tổng quan quy trình làm việc

• Chuẩn bị bắt buộc:

  • Gọi $frontend-design để truy cập các nguyên tắc thiết kế và Giao thức Thu Thập Bối Cảnh.
  • Nếu chưa có bối cảnh thiết kế, hãy chạy $teach-impeccable trước.
  • Thu thập thông tin về trình độ kỹ thuật của khán giả và trạng thái tâm lý người dùng.

• Đánh giá văn bản hiện tại:

  • Xác định các vấn đề về độ rõ ràng như thuật ngữ chuyên ngành, mơ hồ, câu bị động, độ dài, giả định, thiếu bối cảnh và sự không phù hợp về giọng điệu.
  • Hiểu bối cảnh: đối tượng, trạng thái người dùng, hành động dự kiến và các giới hạn.

• Lập kế hoạch và cải thiện:

  • Giải quyết từng vấn đề về độ rõ ràng một cách có hệ thống.
  • Viết lại văn bản với góc nhìn và trạng thái tâm lý của người dùng.
  • Thử nghiệm văn bản đã chỉnh sửa với người dùng thực hoặc các bên liên quan.

Cấu trúc file và tài nguyên chính

• Bắt đầu với SKILL.md để nắm quy trình chính.
• Có thể tìm thêm bối cảnh trong các file README.md, AGENTS.md và các thư mục hỗ trợ như rules/, resources/ hoặc references/ nếu có trong cài đặt của bạn.

Câu Hỏi Thường Gặp

Khi nào tôi nên dùng clarify?

Bạn nên dùng clarify khi gặp các văn bản giao diện gây nhầm lẫn, mơ hồ hoặc không hiệu quả, hoặc khi bạn muốn chủ động nâng cao độ rõ ràng và khả năng sử dụng trong giao tiếp sản phẩm.

clarify giúp cải thiện những loại văn bản nào?

clarify hiệu quả với văn bản UX, thông báo lỗi, microcopy, nhãn và hướng dẫn — bất kỳ văn bản giao diện nào ảnh hưởng đến sự hiểu biết của người dùng.

Tôi có cần bối cảnh thiết kế trước khi dùng clarify không?

Có. Quy trình clarify yêu cầu bạn thu thập bối cảnh thiết kế và hiểu rõ đối tượng trước khi thực hiện thay đổi. Nếu bạn chưa có bối cảnh này, hãy làm theo các bước chuẩn bị trong SKILL.md.

Tôi có thể tìm thêm thông tin chi tiết ở đâu?

Mở tab Files trong thư mục kỹ năng của bạn để khám phá toàn bộ cấu trúc file, bao gồm SKILL.md và các script hoặc tài liệu tham khảo hỗ trợ.