APX CLI là một vòng lặp hàng ngày, không phải là một bảng điều khiển

Đừng coi APX CLI như một bảng điều khiển khổng lồ. Hãy coi nó như một vòng lặp nhỏ hàng ngày.

Thiết kế này dựa trên sự phân tách giữa APC và APX. APC nằm trong repo của bạn như một lớp ngữ cảnh có thể di chuyển (portable context layer). APX nằm trên máy của bạn như một lớp runtime cục bộ (local runtime layer). Nếu bạn cố gắng bắt CLI làm mọi thứ, bạn sẽ làm mất đi ranh giới giữa chúng.

Hãy giữ cho CLI luôn tập trung với quy trình này:

• Đăng ký dự án một lần duy nhất. • Kiểm tra trạng thái trước khi làm việc. • Đọc bộ nhớ bền vững (durable memory) trước khi yêu cầu trợ giúp. • Theo dõi (tail) các tin nhắn để xem điều gì thực sự đã xảy ra.

Một dự án trở thành dự án APX khi nó có tệp AGENTS.md và .apc/project.json. Bạn đăng ký nó bằng các lệnh sau:

apx init apx project add .

Repo vẫn có tính di động vì cây thư mục .apc/ nắm giữ các quy ước (contract). Nó chứa các agents, kỹ năng (skills) và cấu hình (config). APX giữ trạng thái runtime cục bộ trên máy của bạn. Điều này có nghĩa là bạn có thể clone một repo sang máy mới và khôi phục lại cấu trúc dự án mà không cần lịch sử runtime cũ.

Khi bắt đầu làm việc, hãy kiểm tra runtime trước:

apx status

Lệnh này hiển thị tình trạng hoạt động của daemon và trạng thái của engine. Nó giúp bạn xác định xem vấn đề nằm ở runtime cục bộ hay ở repo. Nếu dự án đã được di chuyển, hãy sửa lại việc đăng ký:

apx project rebuild <project>

Bộ nhớ APX dùng cho các dữ kiện bền vững (durable facts). Hãy sử dụng lệnh này để xem lại:

apx memory reviewer

Để thêm một ghi chú, hãy chèn thêm một dòng:

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

Đừng cung cấp ngữ cảnh thô (raw context) cho các mô hình. Hãy sử dụng ngữ cảnh ổn định thông qua bộ nhớ.

Nếu bộ nhớ cho bạn biết điều gì nên là sự thật, thì các tin nhắn sẽ cho bạn biết điều gì đã xảy ra. Hãy sử dụng lệnh này để kiểm tra (audit) hệ thống:

apx messages tail --channel runtime -n 20

Hãy giữ ba thứ này tách biệt:

  • memory.md: Dành cho các dữ kiện bền vững.
  • messages: Dành cho các hoạt động gần đây.
  • sessions: Dành cho lịch sử gọi lệnh (invocation history).

Một tệp không nên đảm nhận cả ba vai trò. APC định nghĩa dự án. APX định nghĩa những gì đã xảy ra trong ngày hôm nay.

Sử dụng trình tự này để luôn nắm bắt được tình hình:

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

CLI hoạt động hiệu quả nhất khi trở thành một thói quen. Sử dụng repo cho ngữ cảnh di động. Sử dụng máy tính cho trạng thái runtime. Sử dụng CLI để kiểm tra ranh giới mỗi ngày.

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

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