Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Marketing

/ak:cook

Triển khai tính năng có hệ thống

Triển khai task hoặc plan đã rõ phạm vi qua brainstorm contract, nhận diện intent, scout, research, plan, review, implement, test, finalize và journal.

Chốt hợp đồng

Nhận diện intent

Scout codebase

Nghiên cứu và lập plan

Nguyên tắc 01

KISS và DRY: triển khai đúng phạm vi yêu cầu một cách gọn, không mở rộng tùy ý.

Nguyên tắc 02

Mode mặc định là interactive; flag mode chỉ đổi hình dáng workflow, không bỏ nhu cầu có contract và plan.

Nguyên tắc 03

Bằng chứng xác minh là một phần của deliverable, không phải việc thêm sau.

Bản đồ thực thi

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

1 Chốt hợp đồng Nêu rõ outcome, ràng buộc, non-goal và tiêu chí nghiệm thu quan sát được trước khi plan hoặc code.
2 Nhận diện intent Phân loại mode mặc định interactive hoặc các mode fast, parallel, auto, no-test hay chạy plan có sẵn.

Xử lý

Agent / skill thực thi

3 Scout codebase Tìm loại dự án, file liên quan, convention, docs, plan và public contract trước khi lập kế hoạch chi tiết.
4 Nghiên cứu và lập plan Nghiên cứu khi cần, viết plan và đi qua cổng review trừ khi mode được chọn thay đổi cách duyệt.

Kiểm chứng

Gate, review, xác thực

5 Triển khai phạm vi Mặc định triển khai đầy đủ phạm vi được yêu cầu; chỉ --yagni mới bật việc chất vấn và cắt phần không cần thiết.
6 Review và test Chạy các bước review và test bắt buộc; --no-test chỉ hạ việc chạy test thành rủi ro phải nêu rõ.

Đóng

Báo cáo, bàn giao, artifact

7 Kiểm side effect Xác nhận tiêu chí nghiệm thu, test liên quan, điểm chạm logic nghiệp vụ, lint/type/build và public contract.
8 Hoàn tất Đồng bộ trạng thái plan, đánh giá tác động docs, cập nhật tracking, đề xuất commit và viết journal trừ khi được bỏ qua.

Cú pháp, đối số, subcommand

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

Đối số

[task|plan-path]

Task hoặc đường dẫn plan

Một việc kỹ thuật cụ thể, hoặc đường dẫn plan.md đã duyệt. Đường dẫn plan sẽ load plan đó và không tạo plan mới.

/ak:cook ./plans/utm-capture/plan.md

Option dùng chung

--interactive

Workflow đầy đủ

Mặc định. Workflow đầy đủ với cổng review của người. Vẫn cần contract mở đầu, plan, triển khai, test, review và hoàn tất.

--fast

Bỏ research

Bỏ research và đi từ scout tới plan gọn. Vẫn cần plan, test và review.

/ak:cook "Thêm thu thập UTM nhận biết đồng ý vào biểu mẫu đăng ký" --fast

--parallel

Phase chạy song song

Cho phép các phase độc lập chạy song song. Cần dependency rõ và ownership file không chồng lấn.

--auto

Bớt dừng review

Bỏ các điểm dừng review thường lệ. Test, code review và chính sách bảo mật vẫn bắt buộc. Không cấp quyền publish, deploy hay Git.

/ak:cook ./plans/utm-capture/plan.md --auto

--no-test

Bỏ test

Bỏ giai đoạn test. Code review vẫn bắt buộc và phải cảnh báo thiếu bằng chứng test.

--tdd

Phase test-first

Thêm hành vi test-first trong từng phase liên quan. Không thay mode nền.

/ak:cook "Tái cấu trúc middleware xác thực" --tdd

--advice

Checkpoint cố vấn

Thêm checkpoint cố vấn kongming. Advice không triển khai, phê duyệt hay mở rộng quyền.

/ak:cook "Thêm thu thập UTM nhận biết đồng ý" --advice

Flag kết hợp

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.

Các flag kết hợp được ghi trong skill: --tdd để làm tests-first khi refactor, --advice để có kongming giám sát, --yagni để cắt phạm vi không cần thiết, và --skip-journal để bỏ bước journal tự động.

Mode / route nên dùng

--interactive

Workflow đầy đủ

Nghiên cứu:: Yes
Review:: Human review gates
Xác thực:: Testing required

--fast

Bỏ research

Nghiên cứu:: No
Review:: Plan still required
Xác thực:: Testing required

--parallel

Chạy nhiều agent

Nghiên cứu:: Optional
Review:: Review gates remain
Xác thực:: Testing required

--auto

Tự duyệt bước

Nghiên cứu:: Yes
Review:: Review-cycle rules
Xác thực:: Testing required

--no-test

Bỏ bước test

Nghiên cứu:: Yes
Review:: Risk must be surfaced
Xác thực:: Tests skipped warning

Đừng bỏ qua bước bắt buộc

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 đơn giản, code thẳng cũng được.

Cách làm đúng

Skill nói task đơn giản là nơi giả định chưa kiểm tra dễ gây lãng phí nhất.

Lối tắt dễ mắc

Một test pass là xong.

Cách làm đúng

Side effect, public contract, test liên quan và lint/type/build cũng thuộc định nghĩa hoàn tất.

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Triển khai mặc định Khuyến nghị

/ak:cook Thêm xác thực người dùng vào ứng dụng

Dùng khi:: Dùng khi phạm vi đã rõ nhưng vẫn cần workflow interactive mặc định.
Kết quả:: Luồng brainstorm contract, scout, plan, implement, review, test và finalize gắn với tính năng đã yêu cầu.

Luồng nhanh

/ak:cook Thêm xác thực người dùng vào ứng dụng --fast

Dùng khi:: Dùng khi muốn bỏ research nhưng vẫn cần scout, plan, code và test.
Kết quả:: Scout → plan → code kèm các cổng xác minh bắt buộc trước khi xem là hoàn tất.

Chạy plan

/ak:cook path/to/plan.md --auto

Dùng khi:: Dùng khi một plan đã duyệt cần được chạy liên tục.
Kết quả:: Thực thi theo plan-file-first với hành vi review-cycle của auto mode và trạng thái phase được giữ.

Test trước

/ak:cook Refactor middleware xác thực --tdd

Dùng khi:: Dùng khi refactor cần giữ hành vi hiện tại bằng cách viết test trước.
Kết quả:: Test cho hành vi hiện tại trước refactor, rồi xác minh sau khi triển khai.

Cổng tương tác

/ak:cook Thêm tìm kiếm vào danh mục --interactive

Dùng khi:: Dùng khi cần giữ các cổng review interactive mặc định.
Kết quả:: Chạy workflow cook interactive với cổng duyệt người dùng, rồi triển khai, test và finalize tính năng đã yêu cầu.

Agent song song

/ak:cook Tách công việc billing và notifications --parallel

Dùng khi:: Khi các lát triển khai độc lập có thể chạy song song.
Kết quả:: Nhóm việc không chồng lấn, điều phối triển khai song song, rồi gộp review, test và finalize cho các lát đã yêu cầu.

Bỏ test tường minh

/ak:cook Cập nhật huy hiệu README --no-test

Dùng khi:: Khi thay đổi không có hành vi test được và phải bỏ test có chủ đích.
Kết quả:: Ghi nhận ngoại lệ --no-test tường minh, vẫn scout và plan, rồi hoàn tất triển khai chỉ-docs mà không bịa test.

Phạm vi xử lý

Chốt hợp đồng
Nhận diện intent
Scout codebase
Nghiên cứu và lập plan
Triển khai phạm vi
Review và test