วิธีทำงานร่วมกับนักพัฒนาในแอปที่สร้างด้วย AI

การทำงานร่วมกับนักพัฒนาในแอปที่สร้างด้วย AI ที่ดีคือการให้โค้ดแก่พวกเขาใน Git repository ให้สรุปหนึ่งหน้าว่าแอปทำอะไรและเพราะอะไร และให้งานที่ขอบเขตชัดเจนพร้อมนิยามของคำว่าเสร็จ ตกลงกันว่าใครเปลี่ยนส่วนไหน เพื่อไม่ให้คุณกับ AI เขียนทับงานของพวกเขา เก็บ repository และบัญชีโฮสติ้งไว้ในชื่อของคุณ และแชร์ secret ผ่านการตั้งค่าที่เหมาะสม ไม่ใช่ทางข้อความ

หลายคนสร้างเวอร์ชันแรกของแอปด้วย AI แล้วจึงพานักพัฒนาเข้ามา เพื่อเพิ่มการชำระเงิน แก้ไขสิ่งที่ AI แก้ไม่ได้อย่างสม่ำเสมอ ตรวจสอบความปลอดภัย หรือเข้ามารับช่วงเมื่อแอปเติบโต หากคุณยังตัดสินใจไม่ได้ว่าจะจ้างหรือไม่ ดู จ้างนักพัฒนาหรือสร้างด้วย AI คู่มือนี้ถือว่าคุณตัดสินใจแล้ว และต้องการให้การทำงานร่วมกันราบรื่น

เมื่อไรที่ควรจ้างนักพัฒนา

เหตุผลทั่วไปในการพานักพัฒนาเข้ามา:

• ปัญหาที่ AI แก้ไม่ได้ หลังจากลองอย่างชัดเจนหลายครั้งและย้อนกลับแล้ว
• พื้นที่เสี่ยง เช่น การชำระเงิน สิทธิ์การเข้าถึง ข้อมูลที่อ่อนไหว และการย้ายฐานข้อมูล
• การตรวจสอบความปลอดภัยหรือการรีวิวโค้ด ก่อนเปิดตัวหรือก่อนรับลูกค้ารายใหญ่
• ประสิทธิภาพ เมื่อมีทราฟฟิกจริงเข้ามา
• การเติบโต แอปกลายเป็นธุรกิจและต้องการคนที่รับผิดชอบโค้ด

การระบุให้ชัดว่าเป็นเหตุผลไหนจะกำหนดทุกอย่างด้านล่าง

ขั้นที่ 1: นำโค้ดไปไว้ในที่ที่แชร์ได้

นักพัฒนาทำงานจาก Git repository ก่อนติดต่อใคร:

1. เชื่อมโปรเจกต์กับ repository แบบ private บน GitHub (หรือบริการที่คล้ายกัน) หรือส่งออกโค้ด
2. ตรวจให้แน่ใจว่าไม่มี secret อยู่ในโค้ดหรือประวัติ ดู วิธีเก็บ API key ให้ปลอดภัย
3. ตรวจว่าโปรเจกต์รันได้จากสำเนาใหม่ ให้ AI เขียนขั้นตอนการติดตั้งให้

เขียน README สำหรับนักพัฒนาที่จะเข้าร่วมโปรเจกต์นี้: แอปทำอะไร stack ที่ใช้ วิธีติดตั้งและรันบนเครื่อง ตัวแปรสภาพแวดล้อมที่ต้องใช้ (เฉพาะชื่อ ไม่ใช่ค่า) โครงสร้างโฟลเดอร์ และส่วนที่เปราะบางหรือผิดปกติ

หาก Git ยังใหม่สำหรับคุณ วิธีใช้ Git กับแอปที่สร้างด้วย AI ครอบคลุมพื้นฐาน

ขั้นที่ 2: เขียนบรีฟหนึ่งหน้า

นักพัฒนาไม่ได้นั่งอยู่ในประวัติแชตของคุณ ให้บริบทแก่พวกเขาในหนึ่งหน้า:

• แอปทำอะไร สำหรับใคร และมีคนใช้กี่คน
• อะไรสำคัญที่สุด ขั้นตอนที่ต้องไม่พังเด็ดขาด
• ปัญหาที่รู้อยู่ และสิ่งที่คุณลองทำไปแล้ว
• งาน และวิธีที่คุณจะรู้ว่ามันเสร็จ
• ข้อจำกัด งบประมาณ กำหนดเวลา และสิ่งที่พวกเขาไม่ควรเปลี่ยน

“นิยามของคำว่าเสร็จ” ที่ดีต้องทดสอบได้ เช่น “ผู้ใช้ที่เข้าสู่ระบบแล้วสามารถจ่ายค่าแพ็กเกจรายเดือนด้วย Stripe Checkout แพ็กเกจจะปรากฏในหน้าบัญชีของเขา และการยกเลิกในพอร์ทัลลูกค้าจะลดระดับเขาเมื่อสิ้นรอบการเรียกเก็บเงิน” ไม่ใช่ “จัดการเรื่องการชำระเงินให้เรียบร้อย”

ขั้นที่ 3: ให้สิทธิ์เข้าถึงอย่างปลอดภัย

• โค้ด: เพิ่มพวกเขาเป็นผู้ร่วมงานใน repository อย่าส่งไฟล์ ZIP ไปมาเมื่องานเริ่มแล้ว
• เครื่องมือสร้างแอป: หากเครื่องมือของคุณรองรับสมาชิกในทีม ให้เชิญเข้า workspace ที่มีเฉพาะโปรเจกต์นี้
• Secret: เพิ่มในการตั้งค่าโฮสต์ของคุณ หรือแชร์ผ่านตัวจัดการรหัสผ่าน อย่าวาง key ในอีเมลหรือแชท
• บัญชีทดสอบ: สร้างพร้อมข้อมูลทดสอบ แทนที่จะแชร์บัญชีเข้าสู่ระบบของคุณเอง
• ข้อมูลโปรดักชัน: ให้เฉพาะเมื่อพวกเขาต้องการจริง ๆ และเฉพาะส่วนที่จำเป็น

เก็บ repository, โดเมน และบัญชีโฮสติ้งไว้ในชื่อของ คุณ เพิ่มคนเข้ามา แต่อย่ามอบบัญชีให้

ขั้นที่ 4: ตกลงกันว่าใครเปลี่ยนอะไร

แหล่งของความยุ่งยากที่ใหญ่ที่สุดคือสองฝ่าย ได้แก่คุณกับ AI และนักพัฒนา ที่เปลี่ยนโค้ดเดียวกันในเวลาเดียวกัน เลือกกฎหนึ่งข้อ:

ไม่ว่าจะเลือกแบบไหน ให้ pull โค้ดล่าสุดก่อนทุกรอบการสั่งงาน และทำการเปลี่ยนแปลงใหญ่บน branch ที่อีกฝ่ายสามารถรีวิวได้

ขั้นที่ 5: สื่อสารเป็นลายลักษณ์อักษร

• รายงานปัญหาด้วยขั้นตอน ผลที่คาด และผลที่เกิดขึ้นจริง ดู วิธีเขียนรายงานบั๊กที่ดี
• เก็บการตัดสินใจไว้ในที่เดียว เช่น issue tracker เอกสารที่แชร์ หรือคอมเมนต์ใน pull request
• ขอให้พวกเขาอธิบายการเปลี่ยนแปลงด้วยภาษาที่เข้าใจง่ายในทุก pull request
• ตกลงกันว่าจะเช็กอินกันบ่อยแค่ไหน

ขั้นที่ 6: รีวิวงานของพวกเขา

คุณไม่จำเป็นต้องอ่านโค้ดเพื่อรีวิวงาน ให้ตรวจสอบ:

• ทำตามบรีฟหรือไม่ บน preview หรือสำเนา staging
• ไม่มีอะไรอื่นพัง ทดสอบขั้นตอนสำคัญของคุณ
• พวกเขาอธิบายแล้ว ว่าเปลี่ยนอะไรและเพราะอะไร
• ไม่มี secret โผล่ขึ้นในโค้ด

หากต้องการดูละเอียดขึ้น วิธีรีวิวโค้ดที่ AI สร้าง มีเช็กลิสต์ที่ใช้ได้กับโค้ดที่มนุษย์เขียนด้วย นอกจากนี้คุณยังขอให้เครื่องมือสร้างแอป AI อธิบาย pull request ของนักพัฒนาให้คุณฟังด้วยภาษาธรรมดาได้

ขั้นที่ 7: รักษาความเป็นเจ้าของให้ชัดเจน

• repository, โฮสติ้ง, โดเมน และบัญชีบุคคลที่สามยังคงเป็นของคุณ
• ระบุความเป็นเจ้าของโค้ดที่พวกเขาเขียนเป็นลายลักษณ์อักษรก่อนเริ่มงาน ตรวจกฎหมายท้องถิ่นหรือปรึกษาผู้เชี่ยวชาญสำหรับคำถามเรื่องสัญญา
• เมื่องานจบ ให้ถอนสิทธิ์การเข้าถึงของพวกเขาและเปลี่ยน key ที่พวกเขาเคยเห็น

ตัวอย่างคำสั่ง

นักพัฒนาเปลี่ยนโค้ดการชำระเงินใน pull ล่าสุด อธิบายด้วยภาษาธรรมดาว่าเขาเปลี่ยนอะไร และมีส่วนอื่นของแอปที่พึ่งพามันหรือไม่

แสดงรายการส่วนของแอปนี้ที่ซับซ้อนหรือมีความเสี่ยงที่สุด เพื่อให้ฉันบอกนักพัฒนาได้ว่าควรโฟกัสการรีวิวที่ตรงไหน

ฉันกำลังส่งมอบงานการชำระเงินให้นักพัฒนา ตั้งแต่นี้ไปอย่าแตะไฟล์ใต้ src/payments หรือเส้นทาง /api/billing ถ้าการเปลี่ยนแปลงต้องใช้มัน ให้บอกฉันแทน

ข้อผิดพลาดที่พบบ่อย

• ไม่มีบรีฟ นักพัฒนาต้องใช้เวลาที่ต้องจ่ายเงินไปกับการไขปริศนาว่าคุณต้องการอะไร
• ขอบเขตคลุมเครือ เช่น “แก้บั๊กทั้งหมด” หรือ “ทำให้พร้อมใช้งานจริง”
• แก้ไขพร้อมกันทั้งสองฝ่าย โดยไม่ pull ก่อน จนงานหายเพราะความขัดแย้ง
• แชร์บัญชีเข้าสู่ระบบของคุณเอง หรือวาง key ลงในแชท
• บัญชีอยู่ในชื่อของนักพัฒนา ทำให้ยากต่อการแยกทางกันในภายหลัง
• ลืมถอนสิทธิ์การเข้าถึง และเปลี่ยน key หลังงานจบ

เช็กลิสต์

• โค้ดอยู่ใน repository แบบ private ในชื่อของฉัน และไม่มี secret อยู่ในนั้น
• README อธิบายการติดตั้ง บรีฟหนึ่งหน้าอธิบายแอปและงาน
• งานมีนิยามของการเสร็จที่ทดสอบได้
• การเข้าถึงทำผ่านคำเชิญเป็นผู้ร่วมงาน ส่วน secret ทำผ่านการตั้งค่าหรือตัวจัดการรหัสผ่าน
• เราตกลงกันว่าใครเปลี่ยนอะไร และฉัน pull ก่อนสั่งงานเสมอ
• งานถูกรีวิวเทียบกับบรีฟและขั้นตอนสำคัญ
• ความเป็นเจ้าของอยู่เป็นลายลักษณ์อักษร และถอนสิทธิ์การเข้าถึงกับเปลี่ยน key เมื่องานจบ

การทำงานร่วมกับนักพัฒนาบน Mythex

• เชิญพวกเขาเข้า workspace เจ้าของเชิญผู้ร่วมงานได้ไม่จำกัดโดยไม่มีค่าธรรมเนียมต่อที่นั่ง สมาชิกทำงานกับโปรเจกต์ของ workspace ใช้ workspace แยกเพื่อให้พวกเขาเห็นเฉพาะโปรเจกต์นี้ เครดิตสำหรับแอปที่เผยแพร่จะถูกเรียกเก็บจากเจ้าของ workspace ดู Invites
• GitHub sync และ export (Pro) เชื่อมต่อ repository แล้ว push/pull ได้ หรือส่งออกโปรเจกต์โดยไม่รวม secret ดู GitHub, export, and import
• แชร์ลิงก์ preview เพื่อแสดงงานที่ยังไม่เสร็จให้ใครสักคนที่ไม่มีบัญชี Mythex และลบเมื่อเสร็จ
• โหมด Ask ตอบคำถามเกี่ยวกับโค้ดโดยไม่เปลี่ยนแปลงมัน มีประโยชน์เมื่อต้องการเข้าใจการเปลี่ยนแปลงของนักพัฒนา

หากนักพัฒนาจะรันแอปที่อื่น ดู วิธี export และ self-host แอปที่สร้างด้วย AI

คำถาม