Cách làm việc với lập trình viên trên ứng dụng do AI xây dựng

Để làm việc hiệu quả với lập trình viên trên một ứng dụng do AI xây dựng, hãy đưa cho họ mã trong một kho Git, một bản tóm tắt một trang về việc ứng dụng làm gì và vì sao, cùng một nhiệm vụ được định phạm vi rõ ràng kèm tiêu chí hoàn thành. Thống nhất ai thay đổi phần nào để bạn và AI không ghi đè công việc của họ, giữ kho mã và tài khoản lưu trữ đứng tên bạn, và chia sẻ bí mật qua cài đặt đúng cách thay vì qua tin nhắn.

Nhiều người tự xây phiên bản đầu tiên của ứng dụng bằng AI rồi mới mời lập trình viên vào: để thêm thanh toán, sửa một lỗi mà AI cứ làm sai, rà soát bảo mật, hoặc tiếp quản khi ứng dụng lớn lên. Nếu bạn vẫn đang cân nhắc có nên thuê người hay không, xem thuê lập trình viên hay xây dựng bằng AI. Hướng dẫn này giả định bạn đã quyết định, và muốn việc phối hợp diễn ra suôn sẻ.

Khi nào nên thuê lập trình viên

Những lý do thường gặp để đưa ai đó vào:

• Một vấn đề AI không giải quyết được sau nhiều lần thử rõ ràng và quay lui.
• Các phần rủi ro: thanh toán, phân quyền, dữ liệu nhạy cảm, migration cơ sở dữ liệu.
• Rà soát bảo mật hoặc mã trước khi ra mắt, hoặc trước khi nhận các khách hàng lớn hơn.
• Hiệu năng khi lưu lượng truy cập thực sự đến.
• Tăng trưởng: ứng dụng đã trở thành một doanh nghiệp và cần một người chịu trách nhiệm về mã.

Rõ ràng về việc thuộc trường hợp nào sẽ định hình mọi thứ bên dưới.

Bước 1: Đưa mã vào một nơi có thể chia sẻ

Lập trình viên làm việc từ các kho Git. Trước khi liên hệ ai:

1. Kết nối dự án với một kho riêng tư trên GitHub (hoặc tương tự), hoặc xuất mã.
2. Đảm bảo không có bí mật nào trong mã hay lịch sử. Xem cách giữ khóa API an toàn.
3. Kiểm tra dự án chạy được từ một bản sao mới. Nhờ AI viết các bước cài đặt.

Viết README cho lập trình viên tham gia dự án này: ứng dụng làm gì, công nghệ sử dụng, cách cài đặt và chạy cục bộ, các biến môi trường cần thiết (chỉ tên), cấu trúc thư mục, và những phần dễ hỏng hoặc bất thường.

Nếu Git còn mới với bạn, cách dùng Git với ứng dụng do AI xây dựng trình bày những điều cơ bản.

Bước 2: Viết bản tóm tắt một trang

Lập trình viên không đọc toàn bộ lịch sử chat của bạn. Hãy cung cấp bối cảnh trong một trang:

• Ứng dụng làm gì, cho ai, và có bao nhiêu người dùng.
• Điều gì quan trọng nhất: những luồng không bao giờ được hỏng.
• Các vấn đề đã biết và những gì bạn đã thử.
• Nhiệm vụ, và bạn sẽ biết nó đã xong bằng cách nào.
• Ràng buộc: ngân sách, thời hạn, những thứ họ không nên thay đổi.

Một "tiêu chí hoàn thành" tốt là có thể kiểm thử: "Người dùng đã đăng nhập có thể trả tiền cho gói hàng tháng qua Stripe Checkout, gói đó hiện trong trang tài khoản của họ, và khi hủy trong cổng khách hàng thì họ bị hạ xuống gói thấp hơn vào cuối kỳ." Chứ không phải "xử lý phần thanh toán".

Bước 3: Cấp quyền truy cập an toàn

• Mã: thêm họ làm cộng tác viên trên kho mã. Đừng gửi qua lại file ZIP khi công việc đã bắt đầu.
• Công cụ xây dựng: nếu công cụ xây dựng app AI của bạn hỗ trợ thành viên nhóm, hãy mời họ vào một workspace chỉ chứa dự án này.
• Bí mật: thêm họ trong cài đặt máy chủ lưu trữ của bạn, hoặc chia sẻ qua trình quản lý mật khẩu. Đừng bao giờ dán khóa vào email hay chat.
• Tài khoản thử nghiệm: tạo chúng với dữ liệu thử nghiệm, thay vì chia sẻ đăng nhập của chính bạn.
• Dữ liệu thật: chỉ khi họ thực sự cần, và chỉ những gì họ cần.

Hãy giữ kho mã, tên miền và tài khoản lưu trữ đứng tên bạn. Thêm người vào; đừng giao tài khoản.

Bước 4: Thống nhất ai thay đổi gì

Nguồn ma sát lớn nhất là hai bên, tức bạn cùng AI và lập trình viên, cùng thay đổi một mã vào cùng lúc. Hãy chọn một quy tắc:

Dù chọn cách nào: pull mã mới nhất trước mỗi phiên nhập lệnh, và thực hiện thay đổi lớn trên các nhánh mà người kia có thể xem xét.

Bước 5: Trao đổi bằng văn bản

• Báo lỗi kèm các bước thực hiện, kết quả mong đợi và kết quả thực tế. Xem cách viết báo lỗi tốt.
• Giữ các quyết định ở một nơi: một công cụ theo dõi issue, một tài liệu chung, hoặc phần bình luận của pull request.
• Yêu cầu họ giải thích thay đổi bằng ngôn ngữ đơn giản trong mỗi pull request.
• Thống nhất bạn sẽ kiểm tra tiến độ bao lâu một lần.

Bước 6: Xem xét công việc của họ

Bạn không cần đọc mã để xem xét công việc. Hãy kiểm tra:

• Nó làm đúng như bản tóm tắt, trên bản xem trước hoặc bản staging.
• Không có gì khác bị hỏng. Chạy các luồng quan trọng của bạn.
• Họ đã giải thích những gì đã thay đổi và lý do.
• Không có bí mật nào xuất hiện trong mã.

Để xem kỹ hơn, cách rà soát mã do AI tạo có một danh sách kiểm tra cũng áp dụng được cho mã do người viết. Bạn cũng có thể nhờ công cụ xây dựng AI giải thích pull request của lập trình viên cho bạn bằng ngôn ngữ đơn giản.

Bước 7: Giữ quyền sở hữu rõ ràng

• Kho mã, máy chủ lưu trữ, tên miền và tài khoản bên thứ ba vẫn thuộc về bạn.
• Ghi quyền sở hữu mã họ viết bằng văn bản trước khi công việc bắt đầu. Kiểm tra quy định địa phương hoặc hỏi tư vấn viên về các câu hỏi hợp đồng.
• Khi công việc kết thúc, gỡ quyền truy cập của họ và thay mới mọi khóa mà họ đã thấy.

Ví dụ lệnh

Lập trình viên đã thay đổi mã thanh toán trong lần pull gần nhất. Giải thích bằng ngôn ngữ đơn giản họ đã thay đổi gì và có phần nào khác của ứng dụng phụ thuộc vào nó không.

Liệt kê các phần phức tạp hoặc rủi ro nhất của ứng dụng này, để tôi có thể chỉ cho lập trình viên nơi cần tập trung rà soát.

Tôi đang giao phần thanh toán cho lập trình viên. Từ giờ đừng động vào bất kỳ file nào trong src/payments hoặc các route /api/billing. Nếu một thay đổi cần chúng, hãy báo tôi thay vì tự làm.

Các lỗi thường gặp

• Không có bản tóm tắt. Lập trình viên phải mất giờ công để đoán ngược xem bạn muốn gì.
• Phạm vi mơ hồ như "sửa các lỗi" hay "làm cho sẵn sàng production".
• Cả hai cùng sửa mà không pull trước, rồi mất công việc vì xung đột.
• Chia sẻ đăng nhập của chính bạn hoặc dán khóa vào chat.
• Tài khoản đứng tên lập trình viên, khiến việc chia tay trở nên khó khăn.
• Quên gỡ quyền truy cập và thay khóa sau khi công việc kết thúc.

Danh sách kiểm tra

• Mã nằm trong một kho riêng tư đứng tên tôi, không có bí mật nào trong đó.
• README giải thích cách cài đặt; bản tóm tắt một trang giải thích ứng dụng và nhiệm vụ.
• Nhiệm vụ có tiêu chí hoàn thành có thể kiểm thử.
• Quyền truy cập được cấp qua lời mời cộng tác viên, bí mật qua cài đặt hoặc trình quản lý mật khẩu.
• Chúng tôi đã thống nhất ai thay đổi gì, và tôi pull trước khi nhập lệnh.
• Công việc được rà soát theo bản tóm tắt và các luồng quan trọng.
• Quyền sở hữu được ghi bằng văn bản; khi công việc kết thúc, quyền truy cập được gỡ và khóa được thay mới.

Làm việc với lập trình viên trên Mythex

• Mời họ vào một workspace. Chủ sở hữu có thể mời không giới hạn cộng tác viên mà không tính phí theo chỗ; thành viên làm việc trên các dự án của workspace. Dùng một workspace riêng để họ chỉ thấy dự án này. Credit cho ứng dụng đã xuất bản được tính cho chủ sở hữu workspace. Xem Lời mời.
• Đồng bộ GitHub và xuất (Pro). Kết nối một kho mã và push/pull, hoặc xuất dự án với bí mật được loại trừ. Xem GitHub, xuất và nhập.
• Chia sẻ liên kết xem trước để cho ai đó không có tài khoản Mythex xem công việc đang làm; xóa khi xong.
• Chế độ Hỏi trả lời các câu hỏi về mã mà không thay đổi nó, hữu ích để hiểu thay đổi của lập trình viên.

Nếu lập trình viên sẽ chạy ứng dụng ở nơi khác, xem cách xuất và tự lưu trữ ứng dụng do AI xây dựng.

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