สเปกนำคือเมื่อวาน ยินดีต้อนรับสู่ทักษะนำ

นี่คือซีรีส์ 10 ตอนที่แบ่งปันว่า Apidog พัฒนา Apidog CLI ซึ่งเป็นเครื่องมือบรรทัดคำสั่งสำหรับการทดสอบ API และการจัดการวงจรชีวิต API ได้อย่างไร อ่านตามลำดับหรือข้ามไปยังโพสต์ใดก็ได้ที่คุณสนใจ:

การพัฒนา API กำลังเปลี่ยนแปลงไปพร้อมกับ AI Agents. Skill-First บรรจุสเปค, การทดสอบ, และสถานการณ์ต่าง ๆ ลงในทักษะที่สามารถเรียกใช้งานและตรวจสอบได้—ซึ่งเสริมแนวทางที่มีอยู่เดิมสำหรับยุค Agent

ยุค Spec-First

เป็นเวลาหลายปีที่กระบวนการทำงานร่วมกันของทีมพัฒนาส่วนใหญ่เป็นแบบ Spec-First

มันคืออะไร

คุณค่า

Spec-First เป็นแนวทางที่ถูกต้องสำหรับการพัฒนา API ที่ขับเคลื่อนโดยมนุษย์

ผู้บริโภครายใหม่: AI Agents

หลังจาก AI Coding ปรากฏขึ้น ผู้บริโภคของ API asset ก็เปลี่ยนไป

Agents ก็เริ่มบริโภค asset เหล่านี้ด้วยเช่นกัน

สิ่งที่ Agents ต้องการ

ในบริบทนี้ เอกสาร API, Test Case และ Test Scenario ใน Apidog ไม่ใช่แค่เนื้อหาสำหรับการทำงานร่วมกันของมนุษย์เท่านั้น

แต่เป็น Asset ที่ Agent สามารถเรียกใช้ได้อย่างแม่นยำ

การแปลง Asset

Asset เปลี่ยนจาก "สามารถอ่านได้" เป็น "สามารถเรียกใช้ได้"

คำจำกัดความของ Skill-First

ต่อยอดจาก Spec-First:

นอกจากนี้:

Skill-First = Spec-First + เลเยอร์การทำงานของ Agent

สถาปัตยกรรมระบบ

แต่ละเลเยอร์มีบทบาทเฉพาะ

การทำงานร่วมกัน

ผู้ใช้: "สร้างการทดสอบสำหรับ Refund API และเรียกใช้การตรวจสอบ"
        ↓
Agent: ทำความเข้าใจประเภทงาน (SKILL ช่วย)
        ↓
Agent: เรียก CLI เพื่ออ่าน Endpoint (CLI ดำเนินการ)
        ↓
Agent: สร้าง Test Case (Agent สร้าง)
        ↓
CLI: ตรวจสอบโครงสร้าง (cli-schema ตรวจสอบ)
        ↓
Agent: เขียน Test Case (CLI ดำเนินการ)
        ↓
CLI: ส่งคืน agentHints (CLI นำทาง)
        ↓
Agent: อ่านกลับ, ปรับเปลี่ยน (Agent ทำตามคำแนะนำ)
        ↓
Agent: เรียกใช้การทดสอบ (CLI ดำเนินการ)
        ↓
CLI: ส่งคืนรายงาน (CLI ให้ข้อมูลป้อนกลับ)
        ↓
Agent: สรุปให้ผู้ใช้ (Agent ทำงานให้เสร็จ)

การเปลี่ยนแปลงเวิร์กโฟลว์

เวิร์กโฟลว์ Spec-First (ขับเคลื่อนโดยมนุษย์)

มนุษย์ออกแบบสเปค
        ↓
มนุษย์จัดทำเอกสาร
        ↓
มนุษย์สร้าง mock
        ↓
มนุษย์แก้ไขข้อผิดพลาด
        ↓
มนุษย์เขียนการทดสอบ
        ↓
มนุษย์เผยแพร่

ลักษณะเฉพาะ:

เวิร์กโฟลว์ Skill-First (ช่วยเหลือโดย Agent)

มนุษย์กำหนดเป้าหมาย
        ↓
Agent อ่าน asset ที่มีอยู่
        ↓
Agent สร้างการเปลี่ยนแปลง
        ↓
CLI ตรวจสอบ
        ↓
Agent เขียน
        ↓
CLI แนะนำขั้นตอนถัดไป
        ↓
Agent ตรวจสอบ
        ↓
มนุษย์ตรวจสอบผลลัพธ์

ลักษณะเฉพาะ:

สิ่งที่ทีมควรทำ

ขั้นตอนเร่งด่วน

ตัวอย่างงานแรกของ Agent

ให้ Apidog CLI ช่วยสร้าง API Endpoint ตัวแรกใน Apidog.
ก่อนอื่น ตรวจสอบการตั้งค่า Apidog CLI และแสดงรายการโปรเจกต์ที่เข้าถึงได้.
ถามฉันว่าจะใช้โปรเจกต์ไหน. หลังจากฉันยืนยันแล้ว ให้สร้าง GET /health แบบง่ายๆ
ชื่อ Health Check พร้อมตัวอย่างการตอบสนอง 200. ตรวจสอบอินพุตที่มีโครงสร้าง
ก่อนเขียน จากนั้นอ่าน Endpoint กลับมาและสรุปสิ่งที่ถูกสร้างขึ้น.

ซึ่งให้ประโยชน์ดังนี้:

คำสั่งเริ่มต้นใช้งาน

# ติดตั้ง Apidog CLI
npm install -g apidog-cli@latest

# ติดตั้ง SKILL ที่ใช้งานร่วมกัน
apidog skill install

# ตรวจสอบเวอร์ชัน (ต้องเป็น 2.2.5+)
apidog -v

# รับรองความถูกต้อง
apidog auth login

# แสดงรายการโปรเจกต์
apidog project list

อนาคต

อนาคตคือการพัฒนา API โดยมี Agent เป็นผู้ช่วย

สรุปซีรีส์ทั้งหมด

เราได้ครอบคลุมการเดินทางทั้งหมดแล้ว:

หลักการสุดท้าย

Spec-First มีไว้สำหรับการทำงานร่วมกันของมนุษย์ Skill-First มีไว้สำหรับการดำเนินการของ Agent

Asset กลายเป็นสิ่งที่เรียกใช้ได้ เวิร์กโฟลว์กลายเป็นสิ่งที่ดำเนินการได้ คุณภาพกลายเป็นสิ่งที่ตรวจสอบได้

ยินดีต้อนรับสู่ Skill-First

ประเด็นสำคัญ

• Spec-First เป็นแนวทางที่ถูกต้องสำหรับการพัฒนาที่ขับเคลื่อนโดยมนุษย์
• ปัจจุบัน Agent เป็นผู้บริโภค API asset
• Asset เปลี่ยนจากที่อ่านได้เป็นที่เรียกใช้ได้
• Skill-First = Spec-First + การดำเนินการของ Agent
• ระบบ: Apidog (asset) → CLI (การดำเนินการ) → SKILL (การตัดสิน) → Agents (การกระทำ)
• มนุษย์กำหนดเป้าหมาย Agent ดำเนินการ CLI ตรวจสอบ
• เริ่มจากเล็กๆ เรียนรู้รูปแบบ ขยายขอบเขต

ดาวน์โหลด Apidog เพื่อ ออกแบบ, จำลอง, ทดสอบ, และ จัดทำเอกสาร API ในพื้นที่ทำงานเดียว เรียนรู้เพิ่มเติมเกี่ยวกับ Apidog CLI สำหรับการทดสอบ API ด้วยบรรทัดคำสั่ง, ระบบอัตโนมัติ CI, และเวิร์กโฟลว์ AI Agent