ak plan check

Dùng ak plan check khi mọi task checkbox trong một tệp phase cần được đánh dấu hoàn tất. Tệp là nguồn chuẩn; plan store chỉ được làm mới sau khi ghi tệp thành công.

Cách dùng

ak plan check <phase-file>

Lệnh nhận đúng một đường dẫn và không có cờ riêng.

Đánh dấu hoàn tất một phase

ak plan check ./plans/260802-1030-release-docs/phase-01-audit.md

Mọi Markdown task item bắt đầu bằng - [ ] được đổi thành - [x]. Các item đã check [x] hoặc [X] vẫn được check và dòng khác được giữ nguyên. Chạy lại lệnh không thay đổi thêm trạng thái checkbox.

Lệnh ghi qua tệp tạm rồi rename, vì vậy reader không thấy tệp dở dang. Tệp thay thế dùng quyền owner-only mặc định của tệp tạm. Lệnh không đổi front matter của phase, tạo backup hay cung cấp preview, apply, force hoặc xác nhận.

Đồng bộ store

Sau khi ghi nguyên tử, AgentKit cố tìm store row liên kết với thư mục cha của tệp rồi lập chỉ mục lại plan và phase đó. Nếu store bị thiếu, mơ hồ, không ghi được hoặc không khả dụng, tệp vẫn đã thay đổi, stderr nhận warning và lệnh thoát thành công. Plan cũ chỉ có tệp không làm phát sinh store row mới.

Thao tác chỉ diễn ra cục bộ. Đồng bộ store có thể chạy lệnh git cục bộ để resolve định danh repository, nhưng không truy cập mạng hay provider. Lệnh không prompt hoặc đọc stdin; --yes không có thêm tác dụng.

Đầu ra

Kết quả dành cho người dùng được ghi vào stdout. JSON thành công là một envelope có kind=plan.check và:

data.phase: đường dẫn được truyền
data.action: "checked"

Warning đồng bộ store vẫn là plain text trên stderr trong chế độ JSON. Lỗi thực thi dùng error envelope JSON trên stderr; lỗi phân tích cờ có thể vẫn là plain text.

Kết quả và mã thoát

Lệnh liên quan

• Thông tin đầy đủ của ak plan check
• Phân tích tiến độ plan
• Hiển thị trạng thái plan
• Quy ước CLI