Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:bootstrap

Dự án mới từ ý tưởng tới code chạy được

Khởi tạo dự án web, mobile, CLI, API, MCP, WebMCP và thư viện từ scope đã chốt đi thẳng vào triển khai qua ak:cook, rồi code review, nâng cấp UX/AX cho bề mặt web, và tuỳ chọn release kèm xác minh live. Không có bước lập plan riêng.

01

Chốt hợp đồng

02

Chuẩn bị repository

03

Nghiên cứu, stack, thiết kế

04

Cook trực tiếp

Nguyên tắc 01

Bootstrap điều phối đầu-cuối; không tự viết code và không thêm bước ak:plan riêng.

Nguyên tắc 02

Hợp đồng mở đầu bắt buộc ở mọi mode; mode chỉ đổi cách chạy và cách duyệt sau khi hợp đồng đã cụ thể.

Nguyên tắc 03

Mặc định làm đủ phạm vi được yêu cầu; chỉ --yagni mới cho phép phản biện và cắt phần không cần thiết.

Nguyên tắc 04

Dự án chỉ xong khi đạt định nghĩa hoàn thành, gồm cả xác minh live nếu có đích live.

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.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Chốt hợp đồng Trước Git, nghiên cứu, thiết kế hay scaffold, chốt kết quả cần đạt, ràng buộc, ngoài phạm vi, tiêu chí nghiệm thu và định nghĩa hoàn thành, đối chiếu với checklist brief cho từng bề mặt. --auto tự quyết chỗ hở và ghi thành giả định; --ask phỏng vấn qua ak:advise tới khi bạn xác nhận.
  2. 2 Chuẩn bị repository Kiểm thư mục đích và trạng thái Git, dùng lại project và branch đang có, và chỉ init Git cho project mới khi setup có yêu cầu. Chỉ tạo repo từ xa qua ak:github khi brief yêu cầu.
02

Xử lý

Agent / skill thực thi

  1. 3 Nghiên cứu, stack, thiết kế Chạy reference của mode để nghiên cứu và chọn stack, chuyển từng bề mặt tới skill phụ trách. Dự án có giao diện dùng ak:frontend-design khi cần định hướng thẩm mỹ; dự án CLI, API, MCP và thư viện thiết kế contract giao diện thay cho wireframe.
  2. 4 Cook trực tiếp Truyền hợp đồng, giả định và kết quả nghiên cứu, stack, thiết kế sang /ak:cook kèm cờ mode. Cook tự lập plan vừa đủ và chạy test; bootstrap không gọi ak:plan.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Code review Chạy ak:code-review trên project mới (codebase, hoặc --pending, PR hay commit với phần thêm vào project có sẵn). Lỗi chặn quay lại cook để sửa, rồi review lại với cùng cờ.
  2. 6 UX và AX cho web Khi dự án có website hoặc web app, chạy ak:enhance-ux-ax --auto sau khi review pass. Dự án không có bề mặt web bỏ qua bước này.
04

Đóng

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

  1. 7 Release và xác minh live Khi định nghĩa hoàn thành có đích live, release lên đó (staging trước nếu có) và xác minh theo cách người dùng hay client thật tiếp cận: trình duyệt cho web, cài sạch cho CLI, client MCP thật cho server.
  2. 8 Tài liệu, onboarding, báo cáo Viết tài liệu và onboarding, báo kết quả với câu hỏi chưa giải quyết đặt cuối, và chạy /ak:journal trừ khi --skip-journal hoặc preference tắt bước này.

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

/ak:bootstrap [requirements] [--auto|--full|--fast|--parallel] [--ask] [--ultra] [--yagni] [--skip-journal]

Đối số

[requirements] Bắt buộc

Yêu cầu project

Kết quả sản phẩm, các bề mặt, ràng buộc, ngoài phạm vi, tiêu chí nghiệm thu và định nghĩa hoàn thành bằng ngôn ngữ tự nhiên, gồm cả đích live như production hay registry nếu có.

/ak:bootstrap "Tạo dashboard incident-response riêng tư với SSO, audit log, và không có billing trong v1"

Option dùng chung

--auto

Tự động (mặc định)

Mode mặc định. Tự quyết chỗ hở và ghi thành giả định, chạy tiếp mà không dừng xin duyệt thường lệ, chỉ dừng ở ranh giới uỷ quyền. Không cấp quyền commit, publish hay deploy mà brief không yêu cầu.

--full

Đầy đủ có tương tác

Cùng bạn làm rõ yêu cầu, rồi nghiên cứu, chọn stack và thiết kế, có dừng ở các quyết định quan trọng trước khi cook.

--fast

Nhanh

Dùng đường nghiên cứu và thiết kế gọn, rồi /ak:cook --fast. Không giảm code review hay bước kiểm chứng.

--parallel

Song song

Chạy nghiên cứu và triển khai bằng nhiều agent qua /ak:cook --parallel. Không làm edit chồng lấn trở nên an toàn.

--ask

Phỏng vấn để chốt scope

Không phải mode. Chạy bước mở đầu thành phỏng vấn ak:advise tới khi kết quả, scope, ràng buộc, ngoài phạm vi, tiêu chí nghiệm thu và định nghĩa hoàn thành được xác nhận, rồi chạy tiếp theo mode đã chọn.

--ultra

Code review ultra

Chạy pha code review ở chế độ verifier best-of-5 (/ak:code-review codebase --ultra). Kết hợp được với mọi mode; bootstrap không tự tách nhánh agent.

--yagni

Cắt scope thừa

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. Khi không có flag này, bootstrap làm đủ phạm vi được yêu cầu.

--skip-journal

Bỏ journal

Chỉ bỏ bước /ak:journal tự động khi hoàn tất. Lệnh journal được gọi rõ vẫn chạy bình thường.

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.

--ask chạy bước mở đầu thành phỏng vấn ak:advise, rồi tiếp tục theo mode đã chọn.

--ultra khiến pha code review chạy /ak:code-review codebase --ultra và kết hợp được với mọi mode, kể cả --parallel.

--yagni được truyền sang cook và code review.

--skip-journal chỉ ảnh hưởng bước journal cuối.

Mode / route nên dùng

--auto

Tự động (mặc định)

Nghiên cứu:
Automatic research and stack choice
Review:
Authorization boundaries only
Xác thực:
Cook --auto; code review
--full

Đầy đủ có tương tác

Nghiên cứu:
Refined requirements, then research
Review:
Missing material decisions
Xác thực:
Cook interactive; code review
--fast

Khởi tạo nhanh

Nghiên cứu:
Lean research path
Review:
Missing material decisions
Xác thực:
Cook --fast; code review
--parallel

Nhiều agent song song

Nghiên cứu:
Parallel research
Review:
Missing material decisions
Xác thực:
Cook --parallel; code review

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ế.

Chạy tự động mặc định Khuyến nghị
/ak:bootstrap "MCP server và CLI cho billing API của chúng tôi"
Dùng khi:
Dùng khi brief đủ rõ để agent tự quyết các chỗ còn hở.
Kết quả:
Chốt hợp đồng kèm các giả định đã ghi, thiết kế lệnh CLI và schema tool MCP, cook với --auto, chạy code review, và chỉ dừng ở ranh giới uỷ quyền.
Phỏng vấn trước
/ak:bootstrap "Thiết kế lại trang marketing của chúng tôi" --ask
Dùng khi:
Dùng khi scope còn mơ hồ và bạn muốn chốt qua phỏng vấn trước khi làm.
Kết quả:
Phỏng vấn qua ak:advise tới khi kết quả, scope và định nghĩa hoàn thành được xác nhận, dựng site mới ở vị trí yêu cầu mà không ghi đè site cũ, rồi chạy review và ak:enhance-ux-ax --auto.
Scaffold SaaS nhanh
/ak:bootstrap "Xây dashboard SaaS có xác thực" --fast
Dùng khi:
Dùng khi dự án mới cần setup nhanh nhưng vẫn phải qua hợp đồng mở đầu và review.
Kết quả:
Chốt hợp đồng, chỉ hỏi các quyết định làm đổi sản phẩm, đi đường nghiên cứu gọn, cook với --fast, và chạy code review.
Xây song song
/ak:bootstrap "Nền tảng thương mại điện tử với Stripe" --parallel
Dùng khi:
Dùng khi dự án đủ lớn để triển khai bằng nhiều agent.
Kết quả:
Giữ hợp đồng mở đầu, nghiên cứu song song, truyền hợp đồng sang /ak:cook --parallel, và review kết quả gộp trước khi nâng cấp UX/AX.
Đầy đủ có tương tác
/ak:bootstrap "Công cụ CLI cho hóa đơn" --full --skip-journal
Dùng khi:
Dùng khi bạn muốn tự duyệt yêu cầu, stack và thiết kế, và bỏ bước journal tự động.
Kết quả:
Cùng bạn làm rõ yêu cầu, dừng ở các quyết định quan trọng, cook có tương tác, chạy code review, và báo rằng journal đã được bỏ qua do cờ.
Review ultra
/ak:bootstrap "Cổng phân tích nội bộ" --auto --ultra --yagni
Dùng khi:
Dùng khi code review cần chế độ verifier best-of-5 và scope cần được phản biện.
Kết quả:
Cắt phần scope không cần cho kết quả, cook ở mode --auto, và chạy /ak:code-review codebase --ultra, gồm cả lần review lại sau khi nâng cấp UX/AX.

Phạm vi xử lý

  • Chốt hợp đồng
  • Chuẩn bị repository
  • Nghiên cứu, stack, thiết kế
  • Cook trực tiếp
  • Code review
  • UX và AX cho web

Tiếp theo