Cook — Implement tính năng

Implement tính năng đầy đủ end-to-end: plan (nếu chưa có) → code → test → review → docs → commit.

Cập nhật bộ claudekit mới: Các lệnh /cook:auto, /cook:auto:fast, /cook:auto:parallel đã bỏ. Thay bằng /cook --auto, /cook --tdd, và /vibe --ship (full autonomous pipeline). Xem cấu trúc skill mới để biết đầy đủ.

Cú pháp

/cook "mô tả feature"           # Implement đầy đủ (interactive)
/cook --auto "mô tả feature"    # Auto-approve, không hỏi
/cook --tdd "path/to/plan"      # TDD mode: tests trước, code sau
/cook                            # Implement theo plan đã tạo trước đó
/vibe --ship                     # Full autonomous: plan → cook → PR → merge → deploy

Luồng hoạt động bên trong

Khi bạn gõ /cook "platform listing page", đây là 7 bước xảy ra:

Bước 1: Intent Detection

Phân tích input để detect mode:

Có path tới plan.md? → mode code (execute plan)
Chứa “fast”, “quick”? → mode fast
Chứa “trust me”, “auto”? → mode auto
Liệt kê 3+ features? → mode parallel
Mặc định → mode interactive (có review gates)

Bước 2: Research (skip nếu fast/code mode)

Spawn researcher agents song song để tìm hiểu codebase. Dùng /scout hoặc /scout:ext tìm files liên quan. Review Gate: Hỏi user approve findings trước khi plan.

Bước 3: Plan

planner subagent tổng hợp research và tạo plan. Nếu có UI work → spawn ui-ux-designer subagent. Review Gate: Hỏi user approve plan trước khi code.

Bước 4: Implement

coder subagent viết code theo plan. Chạy typecheck + compile để đảm bảo không lỗi cú pháp. Review Gate: Hỏi user approve code trước khi test.

Bước 5: Test (skip nếu --no-test)

tester subagent viết và chạy tests. Nếu fail → debugger subagent tìm root cause → fix → re-test. Gate: 100% tests phải PASS mới tiếp.

Bước 6: Code Review

code-reviewer subagent review code. Nếu có critical issues → fix → re-test. Auto-approve nếu score >= 9.5 và 0 critical (chỉ auto mode).

Bước 7: Finalize (LUÔN chạy, không skip)

project-manager subagent → sync-back tất cả completed steps vào plan.md
docs-manager subagent → cập nhật ./docs/ nếu cần
Hỏi user commit qua git-manager subagent
Viết journal entry

Hard Gate: KHÔNG được viết code nếu chưa có plan và chưa được review. Dù task có đơn giản đến đâu, phải plan trước.

Ví dụ thực tế

Input
Output — Files tạo ra

/cook "Tạo trang listing platforms với search, filter category, pagination"

Bước 1: Intent detected → interactive mode
Bước 2: 3 researcher agents scouted: 42 files mapped
Bước 3: Plan created → plans/260401-platform-listing/

Bước 4: Files implemented:
├── src/app/(public)/platforms/page.tsx         # Page component
├── src/app/(public)/platforms/loading.tsx       # Loading skeleton
├── src/components/platforms/PlatformCard.tsx    # Card component
├── src/components/platforms/PlatformFilter.tsx  # Filter sidebar
├── src/components/platforms/SearchBar.tsx       # Search input
├── src/lib/api/platforms.ts                     # API client
├── src/lib/hooks/use-platforms.ts               # TanStack Query hook
└── src/types/platform.ts                        # TypeScript types

Bước 5: 18 tests written, 18 PASS
├── src/__tests__/platforms/PlatformCard.test.tsx
├── src/__tests__/platforms/PlatformFilter.test.tsx
└── src/__tests__/platforms/page.test.tsx

Bước 6: Code review score 9.2/10, 0 critical
Bước 7: Docs updated, plan synced, ready to commit

Các chế độ Cook

/cook (interactive — mặc định)
/cook --auto
/cook --tdd
/vibe --ship

Implement đầy đủ với review gates ở mỗi bước. User approve trước khi tiếp.

/cook "implement user profile page with edit functionality"

Thời gian: 5-15 phút. Tốt cho: Feature quan trọng, cần kiểm soát chặt.

Auto-approve nếu score cao. Không dừng lại hỏi (trừ khi có vấn đề).

/cook --auto "add dark mode toggle to settings"

Thời gian: 3-10 phút. Tốt cho: Feature rõ requirements, trust automation.

TDD mode: write tests trước, code sau. Ensure 100% test coverage.

/cook --tdd plans/260401-payment-integration/plan.md

Thời gian: 7-20 phút. Tốt cho: Critical features, high-risk code, khi cần test-first discipline.

Full autonomous pipeline: worktree → plan → cook → PR → code review → merge → deploy → monitor.

/vibe --ship "implement Stripe payment integration"

Thời gian: 15-40 phút (end-to-end). Tốt cho: Complete hands-off automation, CI/CD ready, high-maturity codebases.

So sánh với chat trực tiếp

Tiêu chí	`/cook`	Chat trực tiếp
Planning	Bắt buộc plan trước (Hard Gate)	Có thể code thẳng, bỏ plan
Testing	Bắt buộc viết tests, 100% PASS mới tiếp	Có thể bỏ qua tests
Code Review	Bắt buộc code-reviewer subagent	Không có review tự động
Documentation	Tự động cập nhật docs	Phải nhắc thủ công
Anti-rationalization	Chặn lý do bỏ qua: “quá đơn giản”, “tôi biết cách rồi”	Không có cơ chế chặn
Agents	7+ agents phối hợp	1 Claude instance
Finalize	3 subagents: project-manager + docs-manager + git-manager	Phải làm thủ công

Khi nào dùng / không dùng

Dùng	Không dùng
Implement tính năng mới	Sửa bug (dùng `/fix`)
Task có plan sẵn từ `/plan`	Chỉ muốn hỏi kiến trúc (dùng `/plan`)
Cần output đầy đủ: code + test + review	Thay đổi 1-2 dòng config
Feature cần nhiều files	Chạy tests (dùng `/test`)

Sub-commands

Sub-command	Mô tả	Khi nào dùng
`/cook "task"`	Implement interactive (có review gates)	Feature quan trọng
`/cook --auto "task"`	Auto-approve, không hỏi	Feature rõ ràng, tin tưởng
`/cook --tdd "path/to/plan"`	Test-first: write tests, then code	Critical/high-risk code
`/vibe --ship "task"`	Full pipeline: plan → code → PR → merge → deploy	Autonomous, hands-off

Bảng mode chi tiết

Mode	Research	Testing	Review Gates	Phase Progression
interactive	Có	Có	User approve mỗi bước	Tuần tự
auto	Có	Có	Auto nếu score >= 9.5	Liên tục
tdd	Có	Tests first	User approve mỗi bước	Tuần tự (test → code)
vibe —ship	Có	Có	Auto (fully autonomous)	Tự động (plan → deploy)
code	Không	Có	User approve mỗi bước	Theo plan

Workflow khuyên dùng

Plan trước

/plan "mô tả tính năng"

Review plan

Đọc và chỉnh sửa nếu cần.

Cook

/cook

Verify

/qa-full:check           # Kiểm tra tests
# hoặc
/qa-full:tdd:verify      # Nếu dùng TDD

Lưu ý & Best Practices

Sai lầm phổ biến:

Dùng /cook --auto cho task phức tạp → bỏ qua review gates, code sai hướng
Skip plan (“code luôn cho nhanh”) → implement sai, phải rewrite
Không đọc plan trước khi cook → implement thiếu hoặc thừa
Bỏ test phase → bugs lọt vào staging, QA reject
Dùng /vibe --ship cho task chưa làm rõ requirements → end up rewriting

Tips từ team:

/cook (default) cho mọi feature quan trọng, cần quality gates
/cook --auto chỉ cho task nhỏ, rõ ràng, ít rủi ro
/cook --tdd cho code critical (payment, auth, core logic)
/vibe --ship cho high-maturity teams + well-scoped features
Luôn đọc và confirm plan trước khi approve implementation

→ Xem thêm: Best Practices tổng hợp

Bắt buộc Subagents (MANDATORY)

Phase	Subagent	Bắt buộc?
Research	`researcher`	Tùy mode
Scout	`ck:scout`	Tùy mode
Plan	`planner`	Tùy mode
UI Work	`ui-ux-designer`	Nếu có frontend
Testing	`tester`, `debugger`	PHẢI spawn
Review	`code-reviewer`	PHẢI spawn
Finalize	`project-manager`, `docs-manager`, `git-manager`	PHẢI spawn cả 3

Chi tiết lệnh Cook (Accordion)

/cook — Implement with interactive review gates

Prefix: /cook "task description" hoặc /cook (sử dụng plan sẵn có)Implement tính năng đầy đủ end-to-end với review gates ở mỗi bước: research → plan → code → test → review → finalize.

/cook "implement user profile page with edit functionality"
# hoặc (sử dụng plan đã tạo)
/cook

Output: Code + tests (100% pass) + code review + updated docs.Thời gian: 5-15 phút.Khi dùng: Feature quan trọng, cần quality gates, team-critical code.

/cook --auto — Auto-approve high-quality code

Prefix: /cook --auto "task description"Implement với auto-approval nếu code score >= 9.5/10. Không dừng lại hỏi (trừ khi có critical issues).

/cook --auto "add dark mode toggle to settings"

Output: Code + tests (auto-merged) + docs.Thời gian: 3-10 phút.Khi dùng: Feature rõ requirements, simple scope, high-confidence automation.

/cook --tdd — Test-driven development mode

Prefix: /cook --tdd "path/to/plan.md" hoặc /cook --tdd "task"TDD discipline: write tests first, then implement code to pass tests. Ensures 100% test coverage.

/cook --tdd plans/260401-payment-integration/plan.md
# hoặc
/cook --tdd "implement Stripe payment integration"

Output: Test suite (all green) + implementation + code review.Thời gian: 7-20 phút (longer due to test-first approach).Khi dùng: Critical code paths (payment, auth, core logic), high-risk modules, when quality > speed.

/vibe --ship — Full autonomous pipeline (hands-off)

Prefix: /vibe --ship "task description"Complete end-to-end autonomy: worktree creation → plan → cook → PR creation → code review → auto-merge (if passing) → deploy to staging → monitor.

/vibe --ship "implement Stripe payment integration with webhook handling"

Output: Merged PR + deployed to staging + CI logs + deployment monitoring.Thời gian: 15-40 phút (end-to-end, depends on scope).Khi dùng: High-maturity codebases, well-scoped features, CI/CD pipelines ready, teams comfortable with autonomy.Warning: Requires well-written requirements + passing test suite + clean deploy pipeline.

/vibe --beta — Ship with beta flag (canary deployment)

Prefix: /vibe --beta "task description"Similar to /vibe --ship, but deploys with --beta flag (canary/feature-flag deployment instead of 100% rollout).

/vibe --beta "new experimental recommendation engine"

Output: Deployed with feature flag, beta monitoring enabled.Khi dùng: Experimental features, uncertain performance impact, gradual rollout preferred.

​Cook — Implement tính năng

​Cú pháp

​Luồng hoạt động bên trong

​Ví dụ thực tế

​Các chế độ Cook

​So sánh với chat trực tiếp

​Khi nào dùng / không dùng

​Sub-commands

​Bảng mode chi tiết

​Workflow khuyên dùng

​Lưu ý & Best Practices

​Bắt buộc Subagents (MANDATORY)

​Chi tiết lệnh Cook (Accordion)

Cook — Implement tính năng

Cú pháp

Luồng hoạt động bên trong

Ví dụ thực tế

Các chế độ Cook

So sánh với chat trực tiếp

Khi nào dùng / không dùng

Sub-commands

Bảng mode chi tiết

Workflow khuyên dùng

Lưu ý & Best Practices

Bắt buộc Subagents (MANDATORY)

Chi tiết lệnh Cook (Accordion)