ak plan
ak plan kanban
Hiển thị các cột phase từ tệp dưới dạng bảng terminal, plain text hoặc một JSON envelope.
Dùng ak plan kanban để xem các phase theo ba nhóm Todo, In Progress và Done
mà không thay đổi dữ liệu.
Cách dùng
ak plan kanban [path]Lệnh không có cờ riêng. Khi bỏ path, lệnh đọc thư mục làm việc hiện tại.
Lệnh không resolve current plan từ pointer trong plan store, vì vậy hãy truyền
thư mục plan hoặc chạy lệnh bên trong thư mục đó.
Chọn chế độ đầu ra
ak plan kanban ./plans/260802-1030-release-docs
ak plan kanban ./plans/260802-1030-release-docs --no-interactive
ak plan kanban ./plans/260802-1030-release-docs --json- Trên TTY, mặc định mở bảng ba cột ở alternate screen. Dùng Left, Right,
hhoặclđể chuyển cột;q, Escape hoặc Control-C đóng bảng với kết quả thành công. --no-interactivebỏ qua TUI và ghi các cột plain text vào stdout.- stdout không phải TTY cũng fallback sang plain text.
--jsonphát một success envelope; không phải NDJSON.
Trạng thái phase được đọc trực tiếp từ phase-NN-*.md. Khi phase có checkbox,
tỷ lệ hoàn tất quyết định cột. Front-matter status chỉ được dùng khi phase
không có checkbox.
Hiệu ứng và quyền riêng tư
Lệnh đọc plan.md và các tệp phase khớp mẫu. Lệnh không mở plan store, thay đổi
tệp, dùng stdin để xác nhận, truy cập mạng, xác thực hay gọi provider. Bảng tương
tác chỉ đọc phím trong terminal.
JSON thành công dùng kind=plan.kanban với:
data.title
data.todo[]
data.in_progress[]
data.done[]Mỗi phase gồm number, title, status, total_tasks và done_tasks. Title
của plan và phase có thể chứa ngữ cảnh riêng tư của project.
Kết quả và mã thoát
| Mã thoát | Ý nghĩa | Bước tiếp theo an toàn |
|---|---|---|
0 | Bảng hoặc structured view hoàn tất; thoát TUI cũng là thành công. | Không cần hành động. |
1 | Đường dẫn không chứa plan đọc được hoặc TUI thất bại. | Truyền đúng thư mục và kiểm tra các tệp Markdown. |
2 | Truyền quá nhiều argument hoặc cờ không hợp lệ. | Truyền zero hoặc một đường dẫn. |
Lỗi thực thi JSON được ghi dưới dạng structured envelope vào stderr. Lỗi phân tích cờ có thể vẫn là plain text.