CycleMantle
เวิร์กโฟลว์

แนะนำการสร้างไฟล์ Fixture แรกของคุณ

03
สร้าง Fixture ในนาทีเดียว

จากโฟลเดอร์ว่างเปล่าสู่การรันเทสต์ที่ผ่าน

คุณมีฟังก์ชัน PHP สำหรับคำนวณยอดรวมคำสั่งซื้อ และต้องการทดสอบกับข้อมูลหลายรูปแบบ CycleMantleจะทำหน้าที่เป็นตัวสร้างข้อมูล: มันจะเขียนไฟล์ JSON ที่มีคำสั่งซื้อสมมติ จากนั้นเขียนสคริปต์ตรวจสอบที่อ่านไฟล์นั้น ข้อมูลทั้งหมดเป็นข้อมูลสมมติ ไม่มีข้อมูลลูกค้าจริง เมื่อใช้โมเดลคลาวด์ คำสั่งของคุณและข้อความในไฟล์จะถูกส่งไปยังผู้ให้บริการนั้นๆ แต่เมื่อใช้โมเดลในเครื่อง ข้อมูลจะไม่ออกนอกคอมพิวเตอร์ของคุณ คาดว่าจะใช้เวลาแชทสั้นๆ 4 ครั้ง: เปิดโฟลเดอร์, ขอข้อมูล, ขอการตรวจสอบ และรันข้อมูล แต่ละข้อความจะสร้างการ์ดที่คุณสามารถอ่าน ยอมรับ หรือปฏิเสธก่อนเริ่มขั้นตอนถัดไป อ่านการ์ดจากบนลงล่าง: แต่ละการ์ดจะระบุเครื่องมือ ไฟล์ หรือคำสั่งที่ใช้ และผลลัพธ์ที่ได้ หากคุณต้องการอ่านก่อนรัน ให้เริ่มแชทในโหมด Plan only แล้วเปลี่ยนเป็น Ask first หลังจากอ่านแผนเสร็จแล้ว

01

เปิดโฟลเดอร์โปรเจกต์

เปิดแอป เลือกโฟลเดอร์ที่มีโค้ด PHP ของคุณ และเลือกโหมดการอนุมัติเป็น Ask first เพื่อให้ทุกการเปลี่ยนแปลงรอการยืนยันจากคุณ คุณสามารถเปลี่ยนโหมดนี้ได้ตลอดเวลา เช่น เปลี่ยนเป็น Auto-run เมื่อคุณไว้วางใจขั้นตอนแล้ว

02

ขอข้อมูลสมมติ

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

03

ขอการตรวจสอบ

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

04

ตรวจสอบและรัน

อ่าน diff ยอมรับ แล้วให้ Shell รันคำสั่งเทสต์ของคุณ จากนั้นอ่าน exit code และขยายการ์ดเพื่อดูผลลัพธ์ หากการตรวจสอบล้มเหลว ให้ขอให้อธิบายสาเหตุก่อนที่มันจะแก้ไขอะไร

สคริปต์เทสต์ขนาดเล็กเพื่อเริ่มต้น

tests.php
<?php
function discount(int $cents, int $percent): int {
    return intdiv($cents * (100 - $percent), 100);
}
assert(discount(1000, 0) === 1000);
assert(discount(1000, 10) === 900);
assert(discount(0, 50) === 0);
assert(discount(999, 100) === 0);
echo 'All checks ran';

ฟังก์ชันธรรมดาหนึ่งฟังก์ชันและการตรวจสอบ assert สี่ครั้งด้วยข้อมูลนำเข้าและผลลัพธ์ที่ทราบค่า ไม่ใช้ฐานข้อมูล ไม่ใช้เครือข่าย และไม่มีข้อมูลลับ ต่อมา Agent สามารถเปลี่ยนตัวเลขคงที่ด้วยแถวจากไฟล์ JSON ของคุณได้ โดยที่โครงสร้างการตรวจสอบยังคงเดิม เปลี่ยนค่าที่คาดหวังหนึ่งค่าโดยเจตนาเพื่อดูการล้มเหลว บันทึกเป็น tests.php ในโฟลเดอร์โปรเจกต์ของคุณ รันด้วยคำสั่งเทสต์ของคุณ และอ่าน exit code ในการ์ดก่อนขออะไรเพิ่มเติม จากนั้นเปลี่ยนค่าที่คาดหวังหนึ่งค่าโดยเจตนาและดูการ์ดเปลี่ยนเป็นสีแดง

สี่งานสำหรับเครื่องมือสร้างข้อมูลทดสอบ

เขียนข้อมูลตัวอย่าง

หลายคนสงสัยว่าจะสร้างข้อมูลทดสอบได้เร็วกว่าการทำมืออย่างไร อธิบายรูปแบบที่คุณต้องการและให้ Agent เขียนให้: ไฟล์ JSON ที่มีลูกค้าสมมติ 3 ราย แต่ละรายมีชื่อ วันที่สมัคร และยอดสั่งซื้อ ในบรรดาเครื่องมือสร้างข้อมูลทดสอบ ไฟล์ธรรมดาในโปรเจกต์ของคุณอ่านและแก้ไขได้ง่ายที่สุด เพราะ diff แสดงทุกค่า glob และ list_dir แสดงตำแหน่งที่มี Fixture อยู่แล้ว ทำให้ไฟล์ใหม่อยู่ในโฟลเดอร์เดียวกัน เปิดการ์ด ตรวจสอบว่าทุกค่าเป็นข้อมูลสมมติชัดเจน และแก้ไขแถวที่ผิดปกติด้วยมือก่อนยอมรับ ใช้โดเมนตัวอย่างสำหรับอีเมล ขอจำนวนแถวพอประมาณ ไม่ใช่หลายร้อยแถว เพื่อให้คุณอ่านได้ทั้งหมด ใช้รูปแบบวันที่แบบเดียวเพื่อให้ทุกแถวอ่านเหมือนกัน

เขียนการตรวจสอบที่อ่านไฟล์

ขอสคริปต์ที่โหลด JSON และตรวจสอบผลลัพธ์หนึ่งรายการต่อแถว Agent จะเปิดซอร์สด้วย read_file หาฟังก์ชันด้วย grep และเสนอไฟล์เทสต์เป็น diff การ Mocking static methods ใน php ทำได้ยาก ดังนั้นขอให้ออกจากรายการ static calls ก่อนเขียน และเก็บ static calls ไว้หลังฟังก์ชันเล็กที่เทสต์สามารถแทนที่ได้ Ask first จะหยุดการเปลี่ยนแปลงจนกว่าคุณจะยอมรับ อ่านแต่ละ assertion และถามว่าหากฟังก์ชันผิด การตรวจสอบนี้จะล้มเหลวหรือไม่ ปฏิเสธการตรวจสอบที่แค่ทำซ้ำโค้ดที่มันทดสอบ จากนั้นเพิ่มแถวหนึ่งแถวที่ควรล้มเหลวโดยเจตนา หาก Agent ไม่สามารถระบุฟังก์ชันที่คุณหมายถึงได้ ให้ระบุชื่อใน prompt และระบุไฟล์ เก็บหนึ่งแนวคิดต่อหนึ่งเทสต์

รันเทสต์และอ่าน exit code

Shell รันคำสั่งเทสต์ในสภาพแวดล้อมที่คุณเลือก เช่น Windows ในเครื่อง WSL หรือ SSH ไปยังเซิร์ฟเวอร์ที่คุณเป็นเจ้าของ การ์ดแสดง exit code จริง และ exit code ศูนย์หมายถึงการตรวจสอบทั้งหมดผ่าน ในขณะที่ค่าอื่นหมายถึงการล้มเหลว ขยายการ์ดเพื่ออ่านผลลัพธ์ทีละบรรทัด หากมีบางอย่างล้มเหลว Agent จะอ่านข้อความและเสนอการแก้ไขเป็น diff อย่ายอมรับการแก้ไขเพียงเพราะทำให้การรันผ่าน ตรวจสอบค่าที่คาดหวังในเทสต์ก่อน หากมีการล้มเหลวตามมาอีก ให้ขอให้อธิบายการล้มเหลวครั้งแรกก่อนแก้ไขอีกครั้ง Plan only เป็นตัวเลือกแรกที่ดีหากคำสั่งนั้นใหม่สำหรับคุณ เพราะ Agent จะเขียนแผนและรันอะไรเลย

ตัดสินใจว่าโค้ดใดต้องการเทสต์

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

CycleMantle สำหรับ Windows

สร้าง Fixture แรกของคุณวันนี้

ดาวน์โหลด CycleMantle ↗