APX CLI คือวงจรการทำงานรายวัน ไม่ใช่แดชบอร์ด

เลิกมองว่า APX CLI เป็นแผงควบคุมขนาดใหญ่ แต่ให้มองว่ามันคือวงจรการทำงานเล็กๆ ในแต่ละวัน

การออกแบบนี้อาศัยการแบ่งแยกกันระหว่าง APC และ APX โดย APC จะอยู่ใน repo ของคุณในฐานะเลเยอร์บริบท (context layer) ที่พกพาได้ ส่วน APX จะอยู่ในเครื่องของคุณในฐานะเลเยอร์รันไทม์ (runtime layer) ในเครื่อง หากคุณพยายามทำให้ CLI ทำทุกอย่าง คุณจะสูญเสียขอบเขตระหว่างทั้งสองสิ่งนี้ไป

รักษาความโฟกัสของ CLI ด้วยกิจวัตรนี้:

• ลงทะเบียนโปรเจกต์เพียงครั้งเดียว • ตรวจสอบสถานะก่อนเริ่มทำงาน • อ่านหน่วยความจำที่คงทน (durable memory) ก่อนที่จะขอความช่วยเหลือ • ใช้ tail messages เพื่อดูว่าเกิดอะไรขึ้นจริง

โปรเจกต์จะกลายเป็นโปรเจกต์ APX เมื่อมีไฟล์ AGENTS.md และ .apc/project.json คุณสามารถลงทะเบียนได้ด้วยคำสั่งเหล่านี้:

apx init apx project add .

Repo ยังคงพกพาได้เพราะโครงสร้างโฟลเดอร์ .apc/ เป็นตัวเก็บสัญญา (contract) ซึ่งประกอบด้วย agents, skills และ config ส่วน APX จะเก็บสถานะรันไทม์ไว้ในเครื่องของคุณ นั่นหมายความว่าคุณสามารถ clone repo ไปยังเครื่องใหม่และกู้คืนโครงสร้างโปรเจกต์ได้โดยไม่ต้องมีประวัติรันไทม์เก่าๆ

เมื่อเริ่มทำงาน ให้ตรวจสอบรันไทม์ก่อน:

apx status

คำสั่งนี้จะแสดงสถานะความสมบูรณ์ของ daemon และสถานะของ engine ซึ่งช่วยให้คุณดูได้ว่าปัญหาอยู่ที่รันไทม์ในเครื่องหรืออยู่ที่ repo หากโปรเจกต์มีการย้ายที่ ให้แก้ไขการลงทะเบียนด้วย:

apx project rebuild <project>

APX memory มีไว้สำหรับข้อเท็จจริงที่คงทน (durable facts) ใช้คำสั่งนี้เพื่อตรวจสอบ:

apx memory reviewer

หากต้องการเพิ่มบันทึก ให้เพิ่มต่อท้ายหนึ่งบรรทัด:

apx memory reviewer --append "Prefers short PR summaries"

อย่าป้อนบริบทดิบ (raw context) ให้กับโมเดล แต่ให้ใช้บริบทที่เสถียรผ่าน memory แทน

หาก memory บอกคุณว่าอะไรควรจะเป็นความจริง messages จะบอกคุณว่าเกิดอะไรขึ้น ใช้คำสั่งนี้เพื่อตรวจสอบระบบ (audit):

apx messages tail --channel runtime -n 20

แยกสามสิ่งนี้ออกจากกัน:

  • memory.md: สำหรับข้อเท็จจริงที่คงทน
  • messages: สำหรับกิจกรรมล่าสุด
  • sessions: สำหรับประวัติการเรียกใช้งาน

ไฟล์เดียวไม่ควรทำหน้าที่ถึงสามอย่าง APC กำหนดตัวโปรเจกต์ ส่วน APX กำหนดสิ่งที่เกิดขึ้นในวันนี้

ใช้ลำดับคำสั่งนี้เพื่อให้เข้าใจสถานะปัจจุบัน:

apx project list apx memory reviewer apx messages tail -n 20

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

Source: https://dev.to/agentprojectcontext/the-apx-cli-is-a-daily-loop-not-a-dashboard-1o98

Optional learning community: https://t.me/GyaanSetuAi