ข้ามไปที่เนื้อหา

คู่มือสูตรสำเร็จ

สูตรที่ใช้งานได้จริงสำหรับงาน Maguyva MCP ทุกวัน แต่ละสูตรจะตั้งชื่อเครื่องมือและลำดับ ไม่ใช่การอ้างอิงพารามิเตอร์แบบเต็ม สำหรับพารามิเตอร์เครื่องมือ ให้ใช้ อ้างอิง MCP API สำหรับการตั้งค่าครั้งแรก ให้ใช้ เริ่มต้นอย่างรวดเร็ว

เลือกเครื่องมือที่เหมาะสม#

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

  • intelligent_search — เริ่มต้นที่นี่สำหรับคำถามเกี่ยวกับโค้ดเบสที่เป็นภาษาธรรมชาติ โดยกำหนดเส้นทางข้าม semantic, symbol, โครงสร้าง และการค้นหา dependency
  • find_symbol — คุณรู้ฟังก์ชัน คลาส หรือชื่อตัวแปรอยู่แล้ว
  • dependency_search — รัศมีการระเบิด: ผู้โทร ผู้อยู่ในอุปการะ หรือผลกระทบก่อน (และหลัง) การแก้ไข
  • get_task_context — พื้นที่ที่ไม่คุ้นเคย ไฟล์ที่มีขอบเขตหนึ่งชุด, symbol (สัญลักษณ์) และการขึ้นต่อกันสำหรับคำอธิบายงาน
  • repository_context — แสดงรายการที่เก็บที่สามารถเข้าถึงได้หรือตรวจสอบว่าชื่อที่เก็บได้รับการแก้ไขอย่างไร
  • ask_maguyva พร้อม operation="guidance" — ความช่วยเหลือเฉพาะที่เกี่ยวกับการเลือกเครื่องมือและการใช้งาน Maguyva (ไม่มีการเปลี่ยนแปลง repo)

ติดตั้งและตรวจสอบไคลเอนต์#

รับ Maguyva ลงในไคลเอนต์ MCP ของคุณและยืนยันการเชื่อมต่อกับรายการพื้นที่เก็บข้อมูลจริง

  1. สร้างคีย์ API ใน app.maguyva.ai (คีย์ขึ้นต้นด้วย mgv_)
  2. เชื่อมต่อและจัดทำดัชนีที่เก็บ GitHub อย่างน้อยหนึ่งรายการที่คุณเข้าใจอยู่แล้ว
  3. เชื่อมต่อไคลเอ็นต์ของคุณโดยใช้ คู่มือการติดตั้ง (ปลั๊กอิน Claude Code หรือการกำหนดค่าระยะไกลแบบเนทีฟสำหรับ Cursor, VS Code, Windsurf, Zed และอื่นๆ)
  4. สอบถามตัวแทนของคุณ "ฉันเชื่อมต่อที่เก็บข้อมูลใดบ้าง" — ที่ดำเนินการตรวจสอบสิทธิ์และ repository_context ตั้งแต่ต้นจนจบ
  5. ถามคำถามจริงหนึ่งข้อเกี่ยวกับ repo นั้นซึ่งคุณสามารถให้คะแนนคำตอบได้ คุณควรเห็นเส้นทางของไฟล์และหมายเลขบรรทัดจากแผนผังที่จัดทำดัชนี

ติดอยู่บนกุญแจ สะพาน หรือที่เก็บที่หายไป? การแก้ไขปัญหา.

ถามก่อนที่จะแก้ไข#

แมป symbol และรัศมีการระเบิดก่อนเปลี่ยนโค้ดที่แชร์ เครื่องมือ Maguyva จะไม่แก้ไขที่เก็บข้อมูลของคุณ — โดยจะแจ้งการแก้ไขที่ไคลเอ็นต์ของคุณนำไปใช้ในเครื่อง

  1. หากคุณทราบชื่อ symbol ให้โทรไปที่ find_symbol เพื่อดูรายละเอียดและการใช้งาน
  2. หากคุณมีเฉพาะคำอธิบายงาน ("เพิ่ม SSO", "แก้ไขเว็บฮุคการเรียกเก็บเงิน") ให้เริ่มต้นด้วย get_task_context หรือ intelligent_search
  3. ก่อนที่จะแก้ไข symbol ที่แชร์ ให้เรียก dependency_search ด้วยการวิเคราะห์ตาม/ผลกระทบ (หรือผ่านเส้นทางที่เปลี่ยนแปลงสำหรับการกระแทกสไตล์ PR-) เพื่อให้คุณเห็นรัศมีการระเบิด
  4. เปิดไฟล์ที่อ้างถึง (การอ่านในเครื่องสำหรับไฟล์บนดิสก์ get_file สำหรับเส้นทางระยะไกล/ข้าม repo) และยืนยันแผนกับโค้ดจริง
  5. หลังจากแก้ไข ให้ตรวจสอบ symbol (สัญลักษณ์) เดิมอีกครั้งด้วย dependency_search (รวมถึงการตรวจสอบหลังการแก้ไข เมื่อไคลเอ็นต์ของคุณรองรับแฟล็กการตรวจสอบ) เพื่อให้ผู้โทรยังคงแก้ไขปัญหาตามที่คาดไว้

พารามิเตอร์แบบเต็ม: อ้างอิง MCP API

ค้นหาแล้วเปลี่ยนแปลง#

ลูปตัวแทนเริ่มต้น: สำรวจ → ปักหมุด symbol (สัญลักษณ์) → แก้ไขโดยมีหลักฐาน

  1. เริ่มต้นด้วย intelligent_search และแบบสอบถามภาษาธรรมดา ("การหมดอายุของเซสชันทำงานอย่างไร", "ตรรกะการลองใหม่อยู่ที่ไหน")
  2. จำกัดให้แคบลงด้วยตัวกรองภาษาหรือเส้นทางเมื่อหน้าต่างแรกมีเสียงรบกวน
  3. โปรโมตเพลงฮิตที่มีแนวโน้มไปที่ find_symbol หรือ dependency_search แทนที่จะถามคำถามที่คลุมเครือซ้ำไปซ้ำมา
  4. ใช้ get_file เฉพาะเมื่อคุณต้องการพาธที่จัดทำดัชนีเฉพาะซึ่งไม่อยู่บนดิสก์
  5. แก้ไขในเครื่องมือไคลเอนต์ปกติของคุณ Maguyva มีไว้เพื่อการค้นพบและการตรวจสอบ ไม่ใช่การเขียน

ทำไมลูปนี้ถึงใช้งานได้: มันทำงานอย่างไร

ผลลัพธ์ว่างเปล่าหรือบาง#

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

  1. ยืนยันว่ามีการเชื่อมต่อที่เก็บและจัดทำดัชนีใน app.maguyva.ai เสร็จแล้ว
  2. ตรวจสอบสตริงที่เก็บ: "owner/repo" ใช้สาขาเริ่มต้น "owner/repo:branch" ปักหมุดสาขา การจับคู่จะคำนึงถึงตัวพิมพ์เล็กและใหญ่ และไม่คลุมเครือ — การพิมพ์ผิดจะไม่แก้ไขอัตโนมัติ
  3. โทร repository_context ด้วย action="info" และตรวจสอบข้อมูลเมตาของความละเอียด (เช่น metadata.resolution_reason)
  4. ละเว้น repository เฉพาะเมื่อไคลเอ็นต์ MCP ของคุณระบุค่าเริ่มต้นของคำขอ หรือคีย์สามารถเข้าถึงที่เก็บข้อมูลเพียงแห่งเดียวเท่านั้น มิฉะนั้นก็ส่งผ่านอย่างชัดเจน
  5. ลองอีกครั้งโดยใช้ข้อความค้นหาที่เจาะจงมากขึ้น ชื่อ symbol ที่รู้จักผ่าน find_symbol หรือตัวกรองภาษา/เส้นทาง หากการเชื่อมต่อขาดหาย ให้ใช้ การแก้ไขปัญหา

ความล้มเหลวในการตั้งค่า: การแก้ไขปัญหา

ทำงานในที่เก็บข้อมูลหลายแห่ง#

กำหนดเป้าหมาย repo ที่มีการจัดทำดัชนีที่ถูกต้องเมื่อคีย์สามารถดูได้มากกว่าหนึ่งรายการ

  1. โทรหา repository_context กับ action="list" หนึ่งครั้งเพื่อเรียนรู้เกี่ยวกับทากที่คีย์ของคุณสามารถค้นหาได้
  2. ส่งผ่าน repository อย่างชัดเจนในการค้นหาและเครื่องมือ symbol เมื่อคุณต้องการ repo ที่ไม่ใช่ค่าเริ่มต้น (เช่น "owner/other-repo" หรือ "owner/other-repo:develop")
  3. เก็บหนึ่งคำถาม = หนึ่งที่เก็บ เว้นแต่คุณจะตั้งใจเปรียบเทียบระหว่างที่เก็บในการเรียกแยกกัน
  4. ใช้ get_file เมื่อไฟล์อยู่ใน repo ที่จัดทำดัชนีซึ่งไม่ใช่แผนผังการทำงานปัจจุบันของคุณ
  5. ข้อควรจำ: เครื่องมือจะไม่เขียนกลับไปที่ GitHub — บริบทของหลายรีโพ มีไว้เพื่อการอ่านและการวางแผนเท่านั้น

รายละเอียดรูปแบบที่เก็บ: อ้างอิง MCP API

ยังใหม่กับ Maguyva ใช่ไหม? เดิน เริ่มต้นอย่างรวดเร็ว ก่อน แล้วกลับมาที่นี่เพื่อวนรอบวันที่สอง

ขั้นตอนต่อไป#