ผู้ช่วยเขียน Docstring และคอมเมนต์โค้ด

ข้อมูลที่ต้องเตรียม

หัวข้อ “ข้อมูลที่ต้องเก็บ” ระบุไว้ว่าจะขออะไรจากคุณ ถ้ายังไม่มี AI จะถามกลับก่อน

ระดับความพร้อม: พร้อมใช้ทันที

วางแล้วใช้ได้เลย แทนค่าในวงเล็บด้วยข้อมูลจริงจะได้ผลดีกว่า แต่ไม่บังคับ

เครื่องมือและภาษา

ใช้ได้กับผู้ช่วย AI ทุกตัวที่รับข้อความยาว ไม่ต้องติดตั้งอะไรเพิ่ม มีทั้งฉบับไทยและอังกฤษ ฉบับอังกฤษใช้ Token น้อยกว่ามาก

ใครควรใช้

โปรแกรมเมอร์ นักพัฒนาซอฟต์แวร์ นอกกลุ่มนี้ยังใช้ได้ แต่ควรตรวจผลก่อนใช้จริง

บทบาทที่กำหนดให้ AI

บรรทัดแรกกำหนดตัวตนให้ AI ว่า “คุณคือนักพัฒนาที่เขียนเอกสารเผื่อคนที่ต้องมานั่งไล่บั๊กตอนตีสอง คุณไม่เคยเขียนซ้ำสิ่งที่โค้ดบอกอยู่แล้ว” บทบาทเปลี่ยนคลังศัพท์ สมมติฐาน และระดับความละเอียดที่ AI เลือกใช้

โครงสร้างของคำสั่ง ทีละส่วน

แต่ละหัวข้อวางไว้แก้คนละจุด

• ข้อมูลที่ต้องเก็บ — เก็บข้อมูลที่ AI ไม่มีทางเดาเองได้ (แบ่งเป็น 4 ขั้น)
• วิธีทำงาน — กำหนดลำดับการคิดให้เป็นขั้นเป็นตอน (แบ่งเป็น 8 ขั้น)
• รูปแบบผลลัพธ์ — ล็อกหน้าตาของผลลัพธ์ (4 ข้อย่อย)
• ข้อห้าม — ปิดช่องที่ผลลัพธ์มักเพี้ยน (5 ข้อย่อย)

ทำไมถึงได้ผลนิ่งกว่าการพิมพ์ถามเอง

ผลที่สม่ำเสมอไม่ได้มาจากถ้อยคำ แต่มาจากกลไกข้างในนี้

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

ขั้นที่ 1 — เปิดไฟล์และเลือกเครื่องมือ

วางเนื้อหาไฟล์เป็นข้อความแรกของแชทใหม่ อย่าต่อท้ายบทสนทนาเดิม เพราะบริบทเก่าจะรบกวนกติกาในไฟล์ ใช้ได้ทั้ง ChatGPT, Claude และ Gemini

ขั้นที่ 2 — รันและอ่านผล

AI จะรับบทเป็น Senior Software Engineer แล้วเดินตามหัวข้อ “วิธีทำงาน” ทีละขั้น ถ้าข้อมูลไม่ครบ AI จะถามกลับก่อน — นั่นคือคำสั่งทำงานถูกต้อง ไม่ใช่ข้อผิดพลาด

แก้ตรงไหนเมื่อผลลัพธ์ไม่ตรงใจ

แต่ละหัวข้อคุมพฤติกรรมคนละอย่าง แก้ทีละหัวข้อแล้วรันใหม่ ถ้ารื้อพร้อมกันหลายจุด จะไม่รู้ว่าอะไรได้ผล

ปรับความเข้มของข้อกำหนด

ตัวแปรครบแล้วผลยังไม่ตรง ปัญหามักอยู่ที่ข้อกำหนด ปรับทีละบรรทัด

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

ใช้ได้ทันที และต่อยอดได้

คำสั่งนี้ใช้งานได้ทันทีโดยไม่ต้องแก้ ถ้าจะปรับ แนะนำให้เก็บต้นฉบับไว้เวอร์ชันหนึ่งเสมอ แล้วแก้บนสำเนา เพราะเมื่อปรับไปหลายรอบจนผลลัพธ์เพี้ยน คุณจะยังมีจุดตั้งต้นให้กลับไปเทียบได้

ต่อเป็น Workflow หลายขั้น

เอาผลจากคำสั่งนี้ไปเป็นข้อมูลตั้งต้นของคำสั่งถัดไปในหมวดเขียนโค้ดและโปรแกรม ร่างก่อนแล้วค่อยส่งต่อให้ตรวจ ได้ผลดีกว่าสั่งทุกอย่างรอบเดียว

หน้าตาของคำตอบ

หัวข้อ “รูปแบบผลลัพธ์” ล็อกรูปแบบไว้ 4 องค์ประกอบ ผลจึงมีโครงเดิมทุกครั้ง

• เขียน docstring พร้อมหน่วยของพารามิเตอร์และ error ที่โยน กับคอมเมนต์หนึ่งบรรทัดอธิบายว่าทำไมใช้ 1.7 ไม่ใช่ 2 และถ้าไม่รู้เหตุผลจะยกขึ้นเป็นคำถาม

สิ่งที่คำสั่งนี้จะไม่ทำ

ข้อจำกัดเหล่านี้ตั้งใจใส่ไว้ — คำตอบที่ยอมบอกว่าไม่รู้ มีประโยชน์กว่าคำตอบที่มั่นใจแต่ผิด

• “ข้อห้าม” ระบุสิ่งที่ห้ามทำไว้ชัดเจน 5 ข้อ คำตอบที่ข้ามข้อห้ามเหล่านี้ถือว่าไม่ผ่าน

วิธีดูว่ารอบนี้ได้ผลดีหรือยัง

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