Tóm tắt nhanh / Lệnh
Bộ Engineer
/ak:plan
Tạo kế hoạch triển khai có nghiên cứu, plan Markdown files-first, HTML làm bản chính khi cần, projection GitHub issue, chia sẻ AgentWiki riêng tư, cổng validate/red-team và context sẵn sàng bàn giao.
Quét trước khi tạo và liên kế hoạch
Thử thách phạm vi
Chọn chế độ
Nghiên cứu và phân tích
Nguyên tắc 01
File plan là dữ liệu bền vững; CLI và GitHub chỉ là index hoặc projection
Nguyên tắc 02
Không triển khai code trong lúc planning
Nguyên tắc 03
Lập plan đủ phạm vi người dùng yêu cầu trừ khi --yagni chủ động cắt phần thừa
Nguyên tắc 04
Phải đọc stub đã sinh trước khi ghi
Nguyên tắc 05
Tính nhất quán toàn plan quan trọng hơn một phase viết đẹp
Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.
Khởi động
Đầu vào, phạm vi, route
Xử lý
Agent / skill thực thi
Kiểm chứng
Gate, review, xác thực
Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.
Cú pháp
/ak:plan [task] [--fast|--hard|--deep|--parallel|--two|--debate|--ultra] [--tdd|--no-tasks] [--html] [--github] [--wiki] [--advice] [--yagni] [--skip-journal] [--no-antv|--no-diagram-design|--no-editorial-visuals]hoặc
/ak:plan <archive|red-team|validate> <plan.md>[task] Việc cần lập plan
Outcome, ràng buộc và tiêu chí chấp nhận bằng ngôn ngữ tự nhiên; không bắt buộc. Khi chưa có việc rõ, Skill hỏi tạo plan mới hay chạy archive, red-team hoặc validate.
/ak:plan Add bảo vệ chống phát lại webhook cho payments--auto Tự chọn mode
Mặc định. Chọn một mode lập plan theo phạm vi và độ bất định. Không bao giờ tự chọn --debate hoặc --ultra.
--fast Nhanh
Bỏ research, red-team và validate. Cho việc nhỏ đã hiểu. Không cắt phạm vi đã yêu cầu.
--hard Khó
Research tập trung và red-team; validate tùy chọn.
--deep Sâu
Research sâu, scout theo phase, red-team và validate cho refactor lớn.
--parallel Song song
Ownership file độc quyền và graph dependency cho các luồng thật sự độc lập.
--two Hai hướng
Tạo hai hướng đã nghiên cứu, rồi review hướng được chọn.
--debate Debate
Chỉ khi chọn rõ. Ba planner độc lập rồi tổng hợp. Không bao giờ tự chọn.
--ultra Ultra
Chỉ khi chọn rõ. Năm plan ứng viên; verifier chọn một bản nguyên vẹn hoặc loại hết.
--tdd Phase test-first
Thêm test trước, refactor, test sau và cổng hồi quy vào phase liên quan. Không triển khai hay chạy test.
--no-tasks Bỏ task live
Không đồng bộ phase sang task view. File plan vẫn là nguồn chính.
--advice Giám sát cố vấn
Kongming tư vấn ở checkpoint phase, khi kẹt và khi rủi ro cao. Advice không sửa hay thay gate plan.
--yagni Cắt scope thừa
Chất vấn và cắt phần không cần cho outcome đã nêu. Phải truyền flag xuống bước sau.
--skip-journal Bỏ journal
Chỉ bỏ bước journal tự động.
--no-antv Không visual AntV
Tắt lớp infographic AntV tùy chọn trên output --html.
--no-diagram-design Không lớp diagram-design
Tắt sinh diagram workflow tùy chọn trên output --html.
--no-editorial-visuals Không visual biên tập
Tắt các lớp visual HTML tùy chọn còn lại cho lần chạy này.
archive Lưu trữ /ak:plan archive Đóng hiển thị plan trên index local nhưng giữ file Markdown.
Kết quả: Đổi visibility trên index; không xóa plan.md hay phase file.
/ak:plan archivered-team Red-team /ak:plan red-team <plan.md> Review đối kháng plan hiện có bằng bằng chứng codebase, rồi quét nhất quán toàn plan cho finding được chấp nhận.
Kết quả: Bảng finding kèm chấp nhận/từ chối và cập nhật file plan khi áp dụng.
/ak:plan red-team plans/checkout-redesign/plan.mdvalidate Validate /ak:plan validate <plan.md> Phỏng vấn câu hỏi phản biện về giả định và tiêu chí chấp nhận; lan tỏa câu trả lời đã chấp nhận trên toàn plan.
Kết quả: Plan đã cập nhật kèm validation log. Không đề xuất cook khi còn mâu thuẫn.
/ak:plan validate plans/checkout-redesign/plan.mdChỉ các flag đổi artifact hoặc publish. Không phải toàn bộ option của skill.
--html Plan HTML
Ghi plan.html độc lập làm artifact chính cho người dùng, có diagram workflow inline và mockup UI khi phù hợp.
Ví dụ
/ak:plan redesign onboarding flow --html --github Projection GitHub
Tạo hoặc cập nhật GitHub issue sau các gate review, kèm link plan dạng repo-relative và gắn ready to review khi có gh/auth.
Ví dụ
/ak:plan payment webhook retry design --github --wiki Chia sẻ AgentWiki
Mặc định chia sẻ riêng tư plan đã review; publish document/site công khai cần yêu cầu rõ và AgentWiki CLI hoặc MCP khả dụng.
Ví dụ
/ak:plan mobile release roadmap --wiki Cách các option đi cùng nhau trên cùng một lần gọi. Không thay thế bảng option ở trên.
--tdd thêm cấu trúc test-first cho phase.
--no-tasks bỏ hydrate runtime.
--html ghi plan.html độc lập làm bản chính.
--github tạo/cập nhật issue ready-to-review.
--wiki mặc định chia sẻ riêng tư tài liệu đã review.
--advice thêm giám sát kongming.
--yagni cắt scope không cần.
--skip-journal tắt journal tự động.
--no-antv, --no-diagram-design và --no-editorial-visuals tắt các lớp visual HTML tùy chọn.
--auto Tự chọn: phân tích độ phức tạp của việc và chọn một workflow mode.
--fast Plan nhanh: bỏ research và red-team cho việc nhỏ, đã rõ.
--hard Plan khó: hai researcher và red-team, validate tùy trường hợp.
--deep Plan sâu: 2-3 researcher, scout theo phase, red-team và validate.
--parallel Plan song song: thiết kế việc có thể bàn giao triển khai song song.
--two Hai hướng: so sánh phương án trước khi chọn plan cuối.
--debate Debate: ba planner độc lập rồi tổng hợp plan; chỉ chạy khi được chọn rõ.
--ultra Ultra: năm plan ứng viên và verifier mạnh nhất chọn một bản nguyên vẹn hoặc loại hết; chỉ chạy khi được chọn rõ.
archive
Lưu trữ plan và ghi journal.
red-team
Chạy review đối kháng trên plan hiện có.
validate
Chạy phỏng vấn câu hỏi phản biện để validate plan.
Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
/ak:plan Add bảo vệ chống phát lại webhook cho payments/ak:planĐổi tên route settings--fast
/ak:planXây dựng lại kiến trúc checkout--deep--html
/ak:plan validate plans/checkout-redesign/plan.md/ak:planThêm giới hạn tốc độ cho các API công khai--auto
/ak:planDi chuyển phiên sang kho lưu trữ bền vững--hard
/ak:planTách lập chỉ mục tìm kiếm khỏi API truy vấn--parallel
/ak:planSo sánh hàng đợi versus cron cho thư tóm tắt--two
/ak:planChọn monolith versus tách dịch vụ cho billing--debate
/ak:planThiết kế ngữ nghĩa thử lại webhook--ultra
/ak:plan archive plans/checkout-redesign/plan.md/ak:plan red-team plans/checkout-redesign/plan.mdOutput kế hoạch
Mẫu đường dẫn
<plans-root>/<timestamp>-<slug>/plan.md + phase-NN-*.md; tùy chọn plan.html / GitHub issue / AgentWiki URL Phản hồi trả đường dẫn file, tóm tắt, kết quả gate, URL publish nếu có và lựa chọn bước tiếp theo, không triển khai code.