Đơn vị 9 / 11

Hệ thống thiết kế: Trí tuệ nhân tạo trong thành phần, mã thông báo và tài liệu

Lợi nhuận:

  • Khả năng soạn thảo và tạo mã thông báo thiết kế nhất quán, đặt tên thành phần và quy tắc sử dụng bằng trí tuệ nhân tạo
  • Khả năng nhanh chóng tạo tài liệu thành phần, ví dụ làm/không và văn bản sử dụng bằng trí tuệ nhân tạo
  • Khả năng kiểm tra các đề xuất trí tuệ nhân tạo để phát hiện xung đột với hệ thống thiết kế hiện có và duy trì tính kỳ dị

Hệ thống thiết kế là ngôn ngữ chung giúp dòng sản phẩm có giao diện và hoạt động nhất quán: các thành phần có thể tái sử dụng (nút, thẻ, trường biểu mẫu), mã thông báo thiết kế (định nghĩa được đặt tên cho các giá trị như màu sắc, khoảng cách, kiểu chữ) và tài liệu giải thích cách sử dụng chúng. Một hệ thống thiết kế tốt cho phép mười nhà thiết kế thiết kế cùng một sản phẩm như thể nó được sản xuất bởi một nguồn duy nhất. Việc cài đặt và bảo trì hệ thống này là công việc mệt mỏi, lặp đi lặp lại và tốn nhiều văn bản; Đây chính xác là nơi trí tuệ nhân tạo tỏa sáng. Nhưng bản chất của hệ thống là tính đơn nhất và tính nhất quán; Các khuyến nghị của AI không thể được chấp nhận nếu không được kiểm tra xem có xung đột với hệ thống hiện tại hay không.

Mã thông báo và đặt tên: cơ sở cho tính nhất quán

Mã thông báo thiết kế là giá trị được đặt tên, có thể sử dụng lại của quyết định thiết kế: màu chính, trung tâm khoảng trắng, chữ-tiêu đề-viết hoa. Nhờ có mã thông báo, bạn có thể thay đổi màu ở một nơi và cập nhật màu đó trên toàn bộ sản phẩm. Nhưng sức mạnh của mã thông báo phụ thuộc vào tính nhất quán của việc đặt tên; Nếu blue-1, main-blue, PrimaryBlue được sử dụng kết hợp, hệ thống sẽ gặp sự cố.

AI giỏi hai việc ở đây: xem xét bộ mã thông báo hiện có của bạn theo sơ đồ đặt tên nhất quán và đề xuất tên tuân thủ lược đồ cho mã thông báo mới. Yêu cầu như "Dịch danh sách mã thông báo này sang cách đặt tên theo ngữ nghĩa (dựa trên ý nghĩa)" sẽ giúp bạn tạo các tên truyền tải ý nghĩa, chẳng hạn như color-action-primary thay vì blue-500. Nhưng quyết định đặt tên cuối cùng là hợp đồng của đội; Mô hình chỉ cung cấp một phác thảo.

Mẹo: Khi đặt tên mã thông báo cho AI, hãy đưa ra 5-6 ví dụ về sơ đồ hiện tại của bạn và nói "giữ nguyên mẫu". Yêu cầu không lấy mẫu sẽ tạo ra các tên xa lạ với hệ thống của bạn.

Tài liệu thành phần: lĩnh vực hiệu quả nhất của AI

Tài liệu của một thành phần bao gồm: chức năng của nó, khi nào nên sử dụng, khi nào không sử dụng, các biến thể, trạng thái (mặc định, di chuột, thụ động, lỗi), ghi chú về khả năng truy cập và ví dụ "nên/không". Viết những văn bản này bằng tay mất nhiều giờ, đó là lý do tại sao nhiều nhóm bỏ bê việc ghi chép.

AI lấp đầy khoảng trống này: khi bạn mô tả một thành phần, nó sẽ tạo ra tài liệu nháp, quy tắc sử dụng và các ví dụ nên/không nên làm theo một định dạng nhất quán. Như vậy, tài liệu đi từ “không có” đến “có bản nháp thì sẽ sửa”, đó là một lợi ích lớn. Tuy nhiên, mô hình không biết hành vi thực tế của thành phần; Công việc của bạn là làm cho các quy tắc mà nó tạo ra phù hợp với thực tế của hệ thống.

mảnh tài liệu

Đóng góp của trí tuệ nhân tạo

xác minh con người

Nó làm gì?

Định nghĩa phác thảo rõ ràng

Sự phù hợp thực sự cho mục đích

Khi nào nên sử dụng

Kịch bản chung

Quy định cụ thể về sản phẩm

Ví dụ nên/không

Cặp dự thảo nhanh

Lạm dụng thực tế

Ghi chú về khả năng truy cập

Lời nhắc tiêu chuẩn

Xác nhận bằng thử nghiệm thực tế

Danh sách biến thể/trường hợp

danh sách có thể

Những người thực sự tồn tại trong hệ thống

Kiểm tra mâu thuẫn: bảo toàn điểm kỳ dị

Kẻ thù không đội trời chung của hệ thống thiết kế là sự trùng lặp: hai nút làm cùng một công việc, hai quy mô không gian khác nhau, hai quy tắc xung đột nhau. Khi AI đề xuất một thành phần hoặc quy tắc mới, đề xuất đó có thể xung đột với hệ thống hiện có — nó không lưu ý đến toàn bộ hệ thống mô hình của bạn. Vì vậy, tôi đánh giá từng đề xuất bằng cách hỏi "điều này có mâu thuẫn với điều gì đó đã tồn tại không?" Lọc bằng câu hỏi. Bạn cũng có thể sử dụng trí tuệ nhân tạo trong việc quét xung đột: bạn có thể đưa ra bản tóm tắt hệ thống hiện tại và đề xuất mới cũng như liệt kê các xung đột. Nhưng quyết định "đúng số ít" cuối cùng là tùy thuộc vào đội.

ba trường hợp nhỏ

Trường hợp 1 - Đã xóa nợ tài liệu. Chỉ có 6 trong số 24 thành phần của nhóm có tài liệu. Dự thảo văn bản được xây dựng cho 18 thành phần còn lại bằng trí tuệ nhân tạo; Đội đã sửa từng cái trong vòng 10-15 phút. Công việc bị trì hoãn nhiều tuần nay đã được hoàn thành trong hai ngày.

Trường hợp 2 - Việc đặt tên mã thông báo trở nên nhất quán. Trong một hệ thống, các màu được trộn lẫn như blue1, mainBlue, brand-blue. AI đã dịch 40 mã thông báo hiện có thành lược đồ ngữ nghĩa; Nhóm đã sửa lại nó và chuyển sang một tiêu chuẩn duy nhất. Lỗi màu sắc đã giảm đáng kể trong các thiết kế tiếp theo.

Trường hợp 3 - Thành phần xung đột đã bị từ chối. AI đề xuất một thành phần mới gọi là “nút hành động phụ”. Khi nhóm nghiên cứu tìm kiếm những mâu thuẫn, họ phát hiện ra rằng nó thực hiện công việc tương tự như "nút ma" hiện có và từ chối đề xuất. Bài học: không phải mọi đề xuất đều bổ sung thêm thành phần mới vào hệ thống; Đôi khi việc sử dụng những gì có sẵn là đúng.

Lời nhắc có thể sao chép

Vai trò của bạn: quản trị viên hệ thống thiết kế. Ghi lại thành phần này: <<thành phần và hành vi của nó>>.Định dạng: Nó làm gì | Khi nào nên sử dụng | Khi nào KHÔNG sử dụng |Biến thể | Tình huống | Ghi chú về khả năng tiếp cận | 2 Làm / 2 Đừng ví dụ. Tạo nên hành vi mà bạn không biết; Viết "nhóm phải điền".

Dịch danh sách mã thông báo này thành sơ đồ đặt tên theo ngữ nghĩa (dựa trên ý nghĩa). Ví dụ lược đồ hiện tại của tôi: <<5-6 ví dụ>>. Tiếp tục theo mô hình tương tự. Đối với mỗi mã thông báo, hãy đặt tên cũ -> tên mới -> bảng biện minh. Danh sách: <<mã thông báo>>

Quét tìm những mâu thuẫn: Tóm tắt hệ thống thiết kế hiện tại của tôi: <<tóm tắt>>. Thành phần/quy tắc mới được đề xuất: <<suggestion>>. Đề xuất này có xung đột với hệ thống hiện tại không (thành phần thực hiện cùng công việc, quy tắc xung đột, mã thông báo trùng lặp)? Liệt kê những xung đột và đề xuất của bạn.

Tạo các cặp ví dụ "nên/không" cho thành phần này: cách sử dụng đúng thực tế và các tình huống sử dụng sai thực tế. Với mỗi cặp, hãy giải thích bằng một câu tại sao nó đúng/sai. Thành phần: <<tên và mục đích>>

Dấu nhắc yếu / Dấu nhắc mạnh

Yếu: "Viết tài liệu cho nút này."

Kết quả: Một văn bản chung, có định dạng không có kết nối với hệ thống.

Mạnh: "Ghi lại nút này theo định dạng sau (nó dùng để làm gì / khi nào không dùng / biến thể / trường hợp / khả năng tiếp cận / những việc nên làm); tạo nên hành vi mà bạn không biết, viết 'nhóm phải điền vào'."

Kết quả: Bản thảo được định dạng nhất quán, giãn cách hợp lý, có thể chỉnh sửa được.

Sự khác biệt: định dạng lời nhắc mạnh mẽ + lệnh cấm bịa đặt + lời nhắc làm/không.

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

  • Yêu cầu đặt tên mã thông báo mà không có ví dụ. Mô hình tạo ra các tên xa lạ với hệ thống của bạn; tính nhất quán bị phá vỡ.
  • Thêm các thành phần mà không cần quét tìm mâu thuẫn. Sao chép là kẻ thù không đội trời chung của hệ thống.
  • Giả sử rằng hành vi do mô hình phát minh ra là đúng. AI không biết hành vi thực tế của thành phần đó.
  • Chấp nhận đánh giá khả năng tiếp cận mà không cần kiểm tra. Lời nhắc tiêu chuẩn không thể thay thế cho việc kiểm tra thực tế.
  • Viết tài liệu một lần và không cập nhật nó. Tài liệu phải được cập nhật khi hệ thống thay đổi.

Tóm lại

Hệ thống thiết kế là cơ sở hạ tầng có tính nhất quán và khả năng mở rộng; nhưng việc bảo trì nó thường bị bỏ qua vì nó tốn nhiều văn bản và lặp đi lặp lại. AI giải quyết khoản nợ này bằng cách nhanh chóng tạo ra tài liệu thành phần, ví dụ nên/không, tập lệnh sử dụng và bản nháp đặt tên mã thông báo. Nhưng bản chất của hệ thống là tính đơn nhất và tính nhất quán: mọi tên mã thông báo phải được xác minh dựa trên lược đồ mẫu, mọi đề xuất thành phần phải được quét đối lập, mọi mô tả hành vi phải được xác minh dựa trên thực tế. Sử dụng mô hình như một người soạn thảo hiệu quả; Nhóm đưa ra quyết định đúng đắn cho cá nhân.

Nhiệm vụ ứng dụng

  1. Chọn một thành phần còn thiếu tài liệu và tạo một tài liệu nháp với lời nhắc đầu tiên.
  2. Điền vào các trường được đánh dấu "Nhóm phải điền" hành vi thực tế.
  3. Với lời nhắc thứ hai, hãy chuyển đổi 8-10 mã thông báo của bạn sang sơ đồ ngữ nghĩa và tạo bảng tên cũ/mới.
  4. Đối với ý tưởng thành phần mới, hãy tìm kiếm những điểm mâu thuẫn với gợi ý thứ ba.
  5. Với lời nhắc thứ tư, hãy tạo các cặp ví dụ nên/không cho một thành phần và thêm chúng vào hệ thống.

danh sách kiểm tra

  • [ ] Tôi đã liên kết việc đặt tên mã thông báo với lược đồ mẫu.
  • [ ] Tôi đã quét các thành phần mới để tìm xung đột.
  • [ ] Tôi đã xác minh các hành vi do mô hình tạo ra với thực tế.
  • [ ] Tôi dự định xác nhận các ghi chú về khả năng tiếp cận bằng thử nghiệm thực tế.
  • [ ] Tôi giữ tài liệu ở định dạng nhất quán.
  • [ ] Tôi đã bảo tồn điểm kỳ dị và ngăn chặn sự trùng lặp.