Pi Agent Platform
Workflow launcher cũ vẫn giữ nguyên. Runtime lifecycle và live inspector chạy tự động; command mới chỉ giúp quan sát preflight, diff, tiến độ, receipt, hiệu suất và orchestration policy.
Workflow impact
Người dùng vẫn giao việc bằng prompt tự nhiên hoặc /workflow task. Thay đổi chính nằm trong runtime: task state, trajectory, verifier evidence, recovery và completion gate được ghi nhận chặt hơn. Các command mới chỉ mở cửa sổ đọc những dữ liệu đó khi cần.
Luồng thao tác không dài thêm. Luồng kiểm soát phía sau an toàn hơn và fail closed khi thiếu bằng chứng. Không cần chạy đủ bốn command mới để một task hợp lệ.
| Thời điểm | Người dùng làm như trước | Runtime mới tự xử lý | Command xem thêm, không bắt buộc |
|---|---|---|---|
| Trước task | Gửi prompt hoặc /workflow task <request>. | Đọc profile/context, phân loại intent và risk, chụp runtime truth và solver recommendation. | /task-preflight [--json] <intent> |
| Đang làm | Tiếp tục trao đổi trong cùng task. | Ghi work plan, phase, changed files, tool/command result, checkpoint, helper và recovery event. Inspector tự cập nhật dưới footer. | /piagent-inspector hoặc /piagent-status |
| Verify và review | Dùng verify của project; gọi /workflow review khi cần review riêng. | Chỉ nhận exact verifier thành công và khớp working-tree identity hiện tại. | /piagent-status |
| Hoàn tất hoặc handoff | Nhận kết quả và remaining risk như trước. | Receipt chỉ approved khi trace, work plan, acceptance, changed-file integrity và hard gate cùng pass. | /piagent-status |
| Sau task | Không có bước bắt buộc mới. | 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 | Intent, risk, scope, runtime, route, phase/tool/helper policy, backend, approval và blocker. | Không tạo task, không advance phase, không gọi model và không cấp quyền implementation. |
| /piagent-status | Task Contract, trajectory, checkpoint, verifier, recovery, helper, resume và terminal receipt từ persisted evidence. | Không sửa file, không chạy lại verify, không retry và không biến state thiếu evidence thành success. |
| /piagent-inspector | Observed task files trên panel bốn dòng sát footer, exact baseline delta trong view files, 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, không đổi completion state và không ước lượng token theo từng built-in tool. |
| /usage efficiency | Context telemetry và task metrics 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 và không quyết định completion gate. |
| /piagent-orchestration | Mode, helper mode, giới hạn subagent, 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 rollout như phase tools hoặc 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
/workflow task Fix the failing checkout test and verify.
/piagent-inspector
/workflow review current diff
/piagent-status
/usage efficiencyChỉ dòng /workflow task khởi chạy implementation. Inspector mở menu để xem file/command/safety/context; preflight, inspector, status và efficiency đều tùy chọn. Review riêng dùng khi scope hoặc quy trình handoff yêu cầu.
Không có namespace /git riêng. Dùng /workflow commit để commit local đã review, dùng /workflow pr để chuẩn bị PR. Các hành động như git push hoặc stage rộng git add -A vẫn cần operator xác nhận.
Dùng /piagent-orchestration để xem trần một helper, lý do dispatch/skip, projected token saving, review lenses, Field Guide và writer policy. Helper mặc định off. Opt-in vẫn chỉ cho một helper read-only context fresh khi chứng minh hai lane độc lập và tiết kiệm từ 30%; worker và retry bị tắt.
/workflow task Fix the failing checkout test and verify./workflow scout Map the auth flow and risk areas./workflow plan Add multi-tenant billing support./workflow review current diff/workflow commit "feat: add guarded git workflow"/workflow pr "Prepare PR for guarded git workflow"/profile be-readonly-fe
/workflow be-to-fe Implement frontend support for the new user status endpoint./workflow platform-improve Harden command docs and run verification.