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

สำหรับผู้ใช้ Codex CLI

AGENTS.md บอก Codex ว่าต้องทำงานยังไง
แต่ไม่ได้บอกว่ามีอะไรอยู่ในนั้น

AGENTS.md กำหนดข้อตกลงในการทำงาน MCP ให้ Codex เอื้อมไปหยิบเครื่องมือได้ Maguyva คือเซิร์ฟเวอร์ MCP ที่มอบแผนที่ของรีโพที่สอบถามได้ให้ Codex ทำให้การแก้ไขครั้งแรกไม่ใช่การเดาโครงสร้างไฟล์

เริ่มใช้ฟรีอ่านวิธีตั้งค่ากับ Codex

แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตร

AGENTS.md คือข้อตกลง MCP คือช่องทางสื่อสาร Maguyva คือแผนที่

สแต็กที่แบ่งเป็นชั้น

สี่แนวคิด แต่ละอย่างทำหน้าที่ของตัวเอง

// ข้อตกลง

AGENTS.md

Codex ควรทำตัวยังไงในรีโพนี้

// การส่งผ่าน

MCP

วิธีที่ Codex เอื้อมไปหยิบเครื่องมือและบริบทจากภายนอก

// โค้ดเบส

Maguyva

เซิร์ฟเวอร์ MCP ที่คืนข้อเท็จจริงของรีโพที่มีหลักฐานอ้างอิง

// ใครจ่ายเงิน

เวิร์กสเปซ ไม่ใช่ที่นั่ง

เอเจนต์ไม่ต้องจ่ายค่าที่นั่ง ดูราคา

AGENTS.md คือข้อตกลงในการทำงาน ใช้มันให้เต็มที่

คำสั่งที่ต้องคงอยู่ถาวรควรอยู่ใน AGENTS.md มันคือที่ที่เหมาะสำหรับ:

  • คำสั่งบิลด์ เทสต์ และ lint ที่ Codex ควรรัน
  • กฎแบบ “ต้องทำ X เสมอ / ห้ามทำ Y” ที่จำกัดขอบเขตไว้ในไดเรกทอรีหนึ่งๆ
  • ข้อตกลงการตั้งชื่อและแนวทางการรีแฟกเตอร์
  • ลิงก์ไปยังบันทึกการตัดสินใจและบันทึกสถาปัตยกรรมที่เป็นมาตรฐาน

เขียนให้กระชับ จำกัดขอบเขตไว้ แล้ว commit มันเก็บไว้

แต่ AGENTS.md ไม่เคยถูกออกแบบมาให้เป็นดัชนีที่สอบถามได้ของทุกสัญลักษณ์ ไฟล์ และจุดเรียกใช้ในรีโพของคุณ

จุดที่ AGENTS.md เพียงลำพังกลายเป็นข้อมูลนิ่งเมื่อรีโพใหญ่ขึ้น

สี่รูปแบบความล้มเหลว การ์ดละหนึ่งแบบ

// ข้อตกลงไม่ใช่ดัชนี

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

// เอกสารคลาดเคลื่อนจากโค้ด

บล็อกใน AGENTS.md ที่อธิบายโครงสร้างคิวของคุณถูกต้องอยู่จนกว่าจะมีใครเพิ่มคอนซูมเมอร์ใหม่เข้ามา ตอนนี้โค้ดคือแหล่งความจริง ส่วนเอกสารล้าสมัยไปแล้วอย่างมั่นใจ Codex กลับอ่านอันที่ผิดอยู่

// การเปลี่ยนชื่อคือปัญหาของกราฟ

“มีอะไรอ้างอิงคลาสนี้บ้าง?” ตอบไม่ได้จากไฟล์ markdown Codex ก็ต้อง grep แล้วภาวนาไปทั่วโมโนรีโพ หรือไม่ก็ขอให้คุณวางจุดเรียกใช้ลงในแชท

// คอนเท็กซ์วินโดว์ไม่ได้มาฟรีๆ

การยัด AGENTS.md จน Codex “รู้พอ” กินโทเคนที่ควรเอาไปใช้คิดวิเคราะห์แทน เกินไม่กี่ KB คุณก็แลกคุณภาพคำตอบกับปริมาณบริบทนิ่งๆ ไปแล้ว

สามชั้นนี้ประกอบกันยังไง

ผู้ใช้ Codex คิดในรูปแบบนี้อยู่แล้ว หน้านี้แค่ทำให้มันชัดเจนขึ้น

AGENTS.md

ข้อตกลง

Codex ทำตัวยังไง

MCP

ช่องทางสื่อสาร

วิธีที่มันเอื้อมไปหยิบ

Maguyva

ข้อเท็จจริงของโค้ดเบส

สิ่งที่มันมองเห็น

  • AGENTS.md Codex ทำตัวยังไงในรีโพนี้
  • MCP วิธีที่ Codex เอื้อมไปหยิบเครื่องมือและบริบท (สเปก)
  • Maguyva สิ่งที่ Codex มองเห็นเมื่อถามคำถามกับโค้ดเบส ผลการค้นหาเชิงความหมาย เชิง AST เชิงกราฟ และเชิงข้อความ พร้อมพาธไฟล์และเลขบรรทัด

AGENTS.md บอก Codex ว่าต้องทำงานยังไง

Maguyva มอบสิ่งที่ใช้เริ่มทำงานได้ให้ Codex

สามเวิร์กโฟลว์

เฉพาะสำหรับ Codex อ้างอิงจากกราฟการเรียกใช้จริง ไม่ใช่การ grep ของ Codex

// workflow 01

เปลี่ยนชื่อคลาสที่ใช้ร่วมกัน โดยหาทุกสิ่งที่พึ่งพามันก่อน

codex> PaymentClient → BillingClient เปลี่ยนชื่อ

graph::callers(PaymentClient)            12 การอ้างอิง ครอบคลุม 7 แพ็กเกจ
graph::importers(src/payments/client.ts)  9 ผู้นำเข้า
graph::extends(PaymentClient)             2 คลาสลูก (RetryClient, MockClient)

→ Codex เสนอแผนย้าย 21 จุดแก้ไข พร้อมรายการไฟล์แบบอินไลน์
[exit 0]

Codex ถาม Maguyva หาผู้ที่พึ่งพาก่อนที่จะเริ่มแก้ไข รายการย้ายที่ได้กลับมาอ้างอิงจากกราฟจริง ไม่ใช่จากความจำของ Codex

// workflow 02

หาการอิมพลีเมนต์จริง ไม่ใช่ test stub

codex> normalizePhoneNumber จัดการ E.164 ยังไง?

semantic::query("normalize phone E.164")
  src/util/phone.ts:88   normalizePhoneNumber()   ← ของจริง
  test/util/phone.spec.ts:14  jest.mock(...)      ← stub
[exit 0]

ชื่อบอกอะไรไม่ได้เสมอไป mock บดบังโค้ดจริงได้ Maguyva จัดอันดับการอิมพลีเมนต์จริงให้อยู่เหนือ test mock

// workflow 03

เช็ครัศมีผลกระทบก่อนรีแฟกเตอร์

codex> อะไรเรียก QueueDispatcher.publish บ้าง?

graph::callers(QueueDispatcher.publish)
  3 ครั้งใน src/billing/*    1 ครั้งใน src/audit/*    1 ครั้งใน src/notifications/*
[exit 0]

จุดเรียกใช้ข้ามแพ็กเกจโผล่ขึ้นมาให้เห็นทันที การเปลี่ยนแปลงอ้างอิงจากผู้นำเข้าจริง ไม่ใช่การ grep ของ Codex

ตั้งค่าใน Codex CLI

สามขั้นตอน แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตร

  1. // step 01

    ทำดัชนีรีโพที่ maguyva.ai

    เลือกรีโพที่คุณรู้จักดี เพื่อให้ตรวจสอบคำตอบได้

  2. // step 02

    เพิ่ม Maguyva เป็นเซิร์ฟเวอร์ MCP ในคอนฟิก Codex ของคุณ

    $ export MAGUYVA_API_KEY=mgv_xxxx
$ codex mcp add maguyva --url https://maguyva.tools/mcp \
    --bearer-token-env-var MAGUYVA_API_KEY

# equivalent ~/.codex/config.toml
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
bearer_token_env_var = "MAGUYVA_API_KEY"

  3. // step 03

    ถามคำถามเดียวที่คุณรู้คำตอบอยู่แล้ว

    อย่าเริ่มจากทั้งบริษัทของคุณ เริ่มจากรีโพเดียวและคำถามเดียวที่ตรวจสอบได้

เปิดให้สมัครใช้งานด้วยตนเองแล้ว

ทำดัชนีรีโพเดียวที่คุณรู้จักดีอยู่แล้ว

เชื่อมต่อ Codex ผ่าน MCP ลองถามคำถามเดียวที่คุณตรวจสอบคำตอบได้

อินเด็กซ์รีโปแรกของคุณดูเอกสารความเข้ากันได้

แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตร