Piagent Platform
v1.51.2
Không có launcher workflow: nói việc bằng lời thường. Command xem thêm chỉ quan sát, không mở lượt model.
Workflow impact
Từ bản 1.9.0, giao việc chỉ cần một yêu cầu bằng lời thường. /workflow, /task, /fresh và /onboard đã bỏ cùng task contract: session không còn ghi contract, work plan, completion gate hay receipt. Guard vẫn kiểm tra từng tool call.
Nói điều mình cần, kể cả agent có được sửa hay không ("chỉ đọc, không sửa", "lập plan trước", "implement rồi chạy test"). Các command xem thêm bên dưới là tùy chọn và không bao giờ mở lượt model.
| Thời điểm | Người dùng làm | Runtime làm | Command xem thêm, không bắt buộc |
|---|---|---|---|
| Trước khi làm | Gửi yêu cầu bằng lời thường. | Đọc profile và project context. | /task-preflight [--json] <intent> |
| Đang làm | Theo dõi hoặc trả lời câu hỏi xác nhận. | Kiểm tra từng tool call: protected path và read-only path, permission profile, context budget cho file lớn, edit trên bản đọc cũ, và xác nhận hành động destructive/external. Inspector tự cập nhật dưới footer. | /piagent-inspector hoặc /piagent-status |
| Verify và review | Nhờ chạy check của project, hoặc review diff hiện tại. | Chạy lệnh như mọi tool call khác. | /piagent-inspector commands |
| Sau khi làm | Không có bước bắt buộc. | Giữ telemetry có nguồn, không tự suy diễn chất lượng. | /usage efficiency |
Command semantics
| Command | Đọc hoặc hiển thị | Không thực hiện |
|---|---|---|
| /task-preflight | Context và shadow route deterministic cho một intent. | Không tạo gì, không gọi model và không cấp quyền implementation. |
| /piagent-status | Profile, guard, runtime và trạng thái model đã xác thực. | Không sửa file, không chạy lại verify và không retry. |
| /piagent-inspector | File đã đổi trên panel bốn dòng sát footer, tool hiện tại, command fail/block, safety warning và context budget. Không tham số sẽ mở menu. | Không sửa file, không chạy command và không ước lượng token theo từng built-in tool. |
| /usage efficiency | Context telemetry có nguồn; fact không đo được giữ null hoặc unavailable. | Không chấm chất lượng con người/model. |
| /piagent-orchestration | Mode, helper mode, giới hạn helper, review lenses, Field Guide và writer policy hiện hành. | Không đổi mode, không spawn helper và không bật parallel writer. |
Năm command trên là read-only. Hành vi chỉ đổi khi operator chủ động bật setting như helper mode; parent routing, automatic worker và multi-writer vẫn không tự bật.
Daily example
/task-preflight --json Fix the failing checkout test
Sửa test checkout đang fail rồi chạy test của project.
/piagent-inspector
Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc.
/usage efficiencyChỉ các dòng lời thường mới mở việc cho model. Preflight, inspector và efficiency là màn hình xem tùy chọn.
Không có namespace /git và không có command workflow. Nhờ commit hoặc tạo PR bằng lời thường. git push, thao tác ghi lên GitHub và stage rộng như git add -A vẫn cần operator xác nhận.
Dùng /piagent-orchestration để xem trần helper, lý do dispatch/skip, review lenses, Field Guide và writer policy. Helper mặc định off. Khi opt-in, parent được dùng tối đa hai helper read-only context fresh; ước tính tiết kiệm token chỉ là telemetry, không phải điều kiện. Worker và retry bị tắt.
Sửa test checkout đang fail rồi chạy test của project.Map luồng auth và các vùng rủi ro. Chỉ đọc, không sửa.Lập plan hỗ trợ multi-tenant billing. Chưa sửa code.Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc.Commit hai file docs với message "docs: update onboarding notes". Không push.Tạo draft PR cho branch này, title "Harden command docs"./profile be-readonly-fe
Implement frontend support cho endpoint user status mới. Backend chỉ đọc.Đọc project này (chỉ đọc) và ghi lại project context.Nhiều session
piagent sessions liệt kê mọi session đang mở: processing đang chạy, paused đang chờ bạn, failed bị lỗi, done đã xong. Thêm --watch để tự làm mới. Dùng Herdr thì chạy piagent sessions --setup-herdr một lần để thấy trạng thái ngay trên từng space.