Claude Code advisor vs kongming & /ak:advise: khi nào cần cố vấn AI? (2026)

- Tên lệnh và hành vi (advisor tool, @kongming, --advice, /ak:advise) đã đối chiếu với docs Claude Code và docs AgentKit tại thời điểm viết; các surface này đổi nhanh nên hãy kiểm tra lại docs live trước khi phụ thuộc.

Cố vấn AI (advisory supervision) trong Claude Code là gì?

Cố vấn AI là một bước xin nhận xét ở điểm cần suy nghĩ kỹ, tách khỏi việc "làm". Thay vì để agent vừa quyết vừa tự khen, bạn chèn một tiếng nói thứ hai để soi lại kiến trúc, trade-off hay một quyết định go/no-go trước khi đi tiếp.

Claude Code có sẵn một cơ chế cho việc này, và AgentKit thêm hai cơ chế nữa. Ba thứ này thường bị gộp làm một, nhưng chúng vận hành rất khác nhau. Nếu bạn chưa nắm subagent là gì, hãy đọc hướng dẫn subagents từ cơ bản trước, vì phần lớn sự khác biệt nằm ở chỗ "có context riêng hay không". Khái niệm advisory của AgentKit được mô tả trong tài liệu chính thức về advisory supervision.

"advisor" - 3 nghĩa dễ lẫn

Trước khi so sánh, phải gỡ rối chữ "advisor" vì nó bị dùng cho ba thứ khác nhau:

• advisor tool - tính năng built-in của Claude Code, một tool-call trong runtime.
• advisor (agent) - một agent tư vấn của AgentKit, thiên về phỏng vấn.
• /ak:advise - lệnh để chạy phiên phỏng vấn tư vấn đó.

Và thêm một dòng để khỏi nhầm thương hiệu: AgentKit ở đây là bộ kit cho Claude Code (agentkit.best, CLI ak) - KHÁC OpenAI AgentKit (Agent Builder/ChatKit).

Claude Code advisor built-in: tiện nhưng dùng chung context

Claude Code có sẵn một advisor tool để "leo thang" những quyết định khó (theo docs Claude Code về advisor). Cơ chế của nó gọn: phiên chính gọi advisor như gọi một capability native, runtime chuyển ngữ cảnh hiện tại sang một model cố vấn mạnh hơn, model đó trả lại nhận xét, rồi phiên chính đọc và đi tiếp.

Điểm mấu chốt: nó không có workspace hay vòng lặp độc lập như một subagent. Nó là một lượt hỏi-đáp ngay trong ngữ cảnh của phiên chính.

Ưu điểm rất thật: nhanh, miễn phí (có sẵn trong Claude Code), và nằm ngay trong luồng làm việc nên không phải chuyển ngữ cảnh. Với một quyết định nhẹ - "cách này ổn không?" - nó thừa sức. Nhược điểm cũng nằm ở chính chỗ "dùng chung context": vì advisor thấy nguyên cái plan bạn đang theo, nó dễ bị cuốn theo, khó cho một góc nhìn thật sự độc lập. Đây là điểm mà kongming giải quyết khác đi.

kongming: cố vấn one-shot, context cô lập

kongming (Gia Cát Lượng, hay Khổng Minh) là agent tư vấn theo checkpoint của AgentKit. Mỗi lần gọi là một lượt mới: nó nhận task, evidence và một câu hỏi cụ thể, trả lời một lần rồi đóng. Nó chạy tự động trên model mạnh nhất mà không bắt bạn đổi model của phiên chính, và quan trọng nhất - nó chỉ trả về counsel, không bao giờ sửa code.

Nó sinh ra cho những điểm cần nghĩ kỹ: kiến trúc, trade-off, một bug khó gỡ, quyết định go/no-go, hoặc khi bạn đang có nhiều hướng thử mâu thuẫn nhau. Vì nó chạy trong context cô lập, nó không "biết trước" bạn đã nghiêng về phương án nào - nên ý kiến của nó ít bias hơn.

Hai cách gọi kongming

Có hai cách hay dùng:

• Gọi trực tiếp @kongming khi bạn muốn hỏi một câu ngay lúc đó. Cách này thủ công hơn: bạn tự chọn thời điểm và tự đưa context/evidence cần thiết.
• Dùng flag --advice trong các workflow skill như ak:plan, ak:cook, ak:fix, ak:vibe. Khi đó workflow tự đặt checkpoint, tự gom task/evidence/attempts/điểm-quyết-định rồi gọi kongming để xin counsel.

Nôm na: @kongming là bạn tự mời cố vấn vào hỏi; --advice là bật chế độ để workflow tự mời cố vấn ở các điểm quan trọng. Trong một tác vụ dài nhiều bước, --advice tiện hơn vì bạn không phải nhớ dừng lại để hỏi. Muốn đặt nó vào đúng chỗ trong quy trình, xem quy trình brainstorm → plan → cook → ship.

advisor của AgentKit: hỏi từng câu rồi mới tư vấn

advisor của AgentKit khác cả hai ở chỗ nó interview-driven: nó không trả lời một phát, mà có thể hỏi bạn từng câu để làm rõ bài toán trước khi đưa lời khuyên. Hợp khi yêu cầu còn mơ hồ và bạn cần một cuộc đối thoại để chốt "thật ra mình muốn xây gì".

Có hai cách dùng:

• /ak:advise: chạy phỏng vấn ngay trong phiên chính, nhẹ, không spawn một agent riêng.
• /ak:advise --agent: ủy thác sang một advisor agent riêng - vẫn hỏi từng câu, nhưng vai trò tư vấn được tách khỏi main workflow.

Một chi tiết kỹ thuật thú vị: một subagent trong Claude Code không tự bật được hộp hỏi người dùng, nên ở chế độ --agent, advisor chuyển từng câu hỏi về cho phiên điều phối rồi được spawn lại cùng câu trả lời của bạn. Nhờ vậy bạn vẫn có trải nghiệm phỏng vấn dù việc tư vấn chạy ở một agent tách biệt.

Bảng so sánh: advisor vs kongming vs /ak:advise

Vì sao CC đã có advisor mà AK vẫn thêm kongming + --advice?

Câu hỏi hợp lý: Claude Code đã có "advisor" rồi, sao còn cần Khổng Minh và cờ --advice? Lý do nằm ở hai chữ: chiều sâu và context cô lập.

advisor built-in dùng chung ngữ cảnh với phiên chính, nghĩa là nó đã biết trước bạn đang theo plan nào. Một người cố vấn biết trước đáp án bạn kỳ vọng thì rất dễ gật theo - giống như bắt chính ông dev đi test cái mình vừa build. kongming chạy trong context cô lập, nhận đúng task và câu hỏi, nên nó phản biện từ con số 0, ít thiên vị hơn. Đổi lại, nó là một agent riêng nên tốn thêm token và chỉ có trong bộ kit.

Nói công bằng: advisor built-in không hề tệ. Với sanity-check nhẹ hằng ngày, nó nhanh và miễn phí là quá đủ. Vấn đề chỉ xuất hiện khi quyết định đủ lớn để cần một góc nhìn thật sự độc lập. Muốn hiểu vì sao một tool-call khác hẳn một subagent về mặt cô lập, xem bài phân biệt skills, subagents, hooks & MCP.

Khi nào dùng cái nào (quyết nhanh)

• CC advisor - khi cần sanity-check nhanh, không đòi hỏi khách quan tuyệt đối. "Hướng này ổn không?" giữa lúc đang code.
• kongming (hoặc --advice) - khi quyết định kiến trúc, go/no-go, gỡ bug khó, hoặc nhiều hướng đang mâu thuẫn và bạn cần ý kiến khách quan. Dùng --advice nếu muốn workflow tự chèn cố vấn ở các checkpoint.
• /ak:advise - khi yêu cầu còn mơ hồ, cần hỏi lại để chốt scope trước khi bắt tay làm.

Muốn bộ agent cố vấn dựng sẵn? (AgentKit)

kongming, advisor và cờ --advice đi kèm AgentKit (Engineer Kit, agentkit.best, CLI ak). Nói thẳng để bạn cân nhắc đúng: advisor built-in của Claude Code vẫn miễn phí và đủ dùng cho việc nhẹ; bộ kit thêm giá trị ở chiều sâu, context cô lập và tích hợp workflow (tự chèn cố vấn ở checkpoint). Muốn xem bên trong có gì, đọc review tổng quan AgentKit hoặc review Engineer Kit.

Câu hỏi thường gặp (FAQ)

advisor của Claude Code là gì?

Là một tool-call built-in để leo thang những quyết định khó: phiên chính gọi nó như một capability native, runtime chuyển ngữ cảnh hiện tại sang một model cố vấn mạnh hơn, model đó trả về nhận xét rồi phiên chính đi tiếp. Nó không có workspace hay vòng lặp độc lập như một subagent.

kongming khác advisor của AgentKit thế nào?

kongming trả lời một lượt (one-shot) tại checkpoint và chạy trong context cô lập trên model mạnh nhất, chỉ đưa counsel chứ không sửa code. advisor của AgentKit thì interview-driven - hỏi bạn từng câu để làm rõ bài toán trước khi tư vấn. Một cái phản biện nhanh và khách quan; một cái đối thoại để làm rõ yêu cầu.

@kongming khác flag --advice ra sao?

Cùng là gọi kongming, khác ở ai bấm nút. @kongming là bạn tự mời cố vấn và tự đưa context. Cờ --advice trong ak:plan/ak:cook/ak:fix/ak:vibe bật chế độ để workflow tự đặt checkpoint, tự gom evidence rồi gọi kongming giúp bạn.

/ak:advise khác /ak:advise --agent chỗ nào?

/ak:advise chạy phỏng vấn ngay trong phiên chính, nhẹ và không spawn agent riêng. /ak:advise --agent ủy thác sang một advisor agent tách biệt - vẫn hỏi từng câu nhưng vai trò tư vấn được tách khỏi main workflow.

Vì sao cần cố vấn "context cô lập"?

Vì một cố vấn đã biết trước plan của bạn dễ bị thiên vị theo - giống bắt dev test chính cái mình build. Context cô lập cho phép kongming phản biện từ đầu, ít bias hơn, nên hợp với các quyết định quan trọng cần góc nhìn độc lập.

kongming và advisor có sửa code không?

Không. Cả hai đều là vai trò tư vấn - trả về lời khuyên chứ không mutate code. Bạn vẫn là người quyết định và thực thi; chúng chỉ giúp bạn nhìn rõ hơn trước khi làm.

Kết luận

Chọn theo mức độ khó của quyết định: việc nhẹ thì dùng advisor built-in cho nhanh; quyết định thật sự khó, cần khách quan thì gọi kongming hoặc bật --advice; còn khi yêu cầu mơ hồ thì /ak:advise hỏi lại để chốt scope. Đặt cố vấn đúng chỗ trong quy trình brainstorm → plan → cook → ship, và nếu muốn có sẵn kongming/advisor, xem review Engineer Kit.