Tóm tắt nhanh / Lệnh
Bộ Engineer
/ak:cook
Triển khai tính năng có hệ thống: chốt contract brainstorm, scout bắt buộc, plan được review, code, review, test, đồng bộ finalize và các mode tuỳ chọn.
Chốt contract
Nhận diện mode
Scout
Nghiên cứu và lập plan
Nguyên tắc 01
Làm đủ phạm vi đã yêu cầu, không thêm; --yagni là lựa chọn rõ ràng.
Nguyên tắc 02
Lập plan trước khi code vì việc “đơn giản” thường giấu giả định.
Nguyên tắc 03
Scout code hiện tại trước khi hỏi thêm.
Nguyên tắc 04
Tác dụng phụ và hồi quy phải để người dùng quyết, không âm thầm vá.
Nguyên tắc 05
Bằng chứng kiểm chứng phải có trước khi tuyên bố hoàn tất.
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
Đóng
Báo cáo, bàn giao, artifact
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:cook [task|plan-path] [--interactive|--fast|--parallel|--auto|--no-test] [--tdd] [--advice] [--yagni] [--skip-journal][task|plan-path] Bắt buộc Task hoặc đường dẫn plan
Yêu cầu triển khai bằng ngôn ngữ tự nhiên hoặc file plan đã duyệt. Nêu outcome, ràng buộc, non-goal, tiêu chí chấp nhận và ranh giới quyền hạn trừ khi plan đã có sẵn.
/ak:cook "Add POST /api/feedback với authentication hiện có, trả về 202, không lưu dữ liệu mới, add các test tập trung, và không commit hoặc deploy"--interactive Tương tác
Mode mặc định. Chạy workflow đầy đủ và dừng ở các cổng review chính để duyệt hoặc yêu cầu chỉnh sửa.
/ak:cook "Add search" --interactive--fast Nhanh
Chỉ bỏ research. Vẫn chốt contract, kiểm tra codebase, viết plan trước khi code, chạy test và code review.
/ak:cook "Add search" --fast--parallel Song song
Cho phép các phase triển khai độc lập chạy đồng thời khi dependency và ownership tệp đã rõ.
/ak:cook "Build bảng điều khiển và API" --parallel--auto Tự động
Bỏ các lần dừng thường lệ cho con người nhưng vẫn giữ test, code review bắt buộc, chính sách bảo mật và xử lý blocker chưa xong.
/ak:cook path/to/plan.md --auto--no-test Không test
Chỉ bỏ giai đoạn test. Code review vẫn bắt buộc và báo cáo cuối phải nêu rõ thiếu bằng chứng test.
/ak:cook "Update nội dung" --no-test--tdd Test trước
Thêm cách làm test-first trong phase phù hợp: khóa hành vi hiện tại trước khi refactor, rồi kiểm chứng sau triển khai.
/ak:cook "Tái cấu trúc middleware xác thực" --tdd--advice Giám sát cố vấn
Hỏi kongming tư vấn khi hoàn tất phase, khi bị kẹt và trước quyết định rủi ro cao. Lời khuyên không sửa code hay duyệt gate.
/ak:cook "Di chuyển thanh toán" --advice--yagni Cắt scope thừa
Cho phép chất vấn và cắt phần việc đã yêu cầu nhưng không cần cho outcome đã nêu. Nếu không có cờ này, vẫn phải làm đủ scope đã yêu cầu.
/ak:cook "Xây dựng panel quản trị" --yagni--skip-journal Bỏ journal
Chỉ bỏ journal tự động. Đồng bộ plan cuối, kiểm tra ảnh hưởng docs, cập nhật task live và hỏi commit vẫn chạy.
/ak:cook path/to/plan.md --skip-journal--interactive Workflow đầy đủ mặc định
--fast Bỏ nghiên cứu
--parallel Triển khai đa agent
--auto Tự duyệt bước
--no-test Bỏ test
Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.
Lối tắt dễ mắc
Việc này quá đơn giản, khỏi cần plan.
Cách làm đúng
Việc đơn giản thường giấu giả định; lập plan chỉ mất khoảng 30 giây.
Lối tắt dễ mắc
Tôi sẽ vừa làm vừa plan.
Cách làm đúng
Đó là hy vọng, không phải lập kế hoạch.
Lối tắt dễ mắc
Test pass là xong.
Cách làm đúng
Vẫn còn review, kiểm blast-radius, contract, đồng bộ, ảnh hưởng docs và finalize.
Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
/ak:cook"Thêm xác thực người dùng vào ứng dụng"--fast
/ak:cookpath/to/plan.md--auto
/ak:cook"Refactor middleware auth"--tdd
/ak:cook"Thêm tìm kiếm vào catalog"--interactive
/ak:cook"Tách phần việc billing và notifications"--parallel
/ak:cook"Cập nhật badge README"--no-test