ak:advise — Interview-driven advisory skill for Claude Code
Honest advice starts with hard questions. Tư vấn thật lòng bắt đầu từ những câu hỏi khó.
ak:advise is an interview-driven advisory skill. Hand it a raw idea, a prompt, or a URL — it scouts your codebase, grills you one question at a time, reframes the problem into exact requirements and goals, then tells you plainly what to do, what to avoid, and what the trade-offs cost. ak:advise là một skill tư vấn theo kiểu phỏng vấn. Đưa nó một ý tưởng thô, một prompt, hoặc một URL — nó sẽ quét codebase, “hỏi cung” bạn từng câu một, diễn giải lại vấn đề thành requirements và goals chính xác, rồi nói thẳng: nên làm gì, nên tránh gì, và cái giá của trade-offs.
/ak:advise "your raw idea hereý tưởng nửa vởi của bạn"
copycopy
Most advice fails before it starts. Phần lớn lời khuyên hỏng ngay từ vạch xuất phát.
Ask a vague question, get a confident essay. ak:advise exists because the expensive part of advice was never the answer — it’s the requirement hiding underneath the question. Hỏi mơ hồ thì nhận về một bài luận tự tin. ak:advise ra đời vì phần đắt giá của lời khuyên chưa bao giờ là câu trả lời — mà là requirement ẩn bên dưới câu hỏi.
Vague briefs get vague adviceBrief mơ hồ, khuyên cũng mơ hồ
“Should I use microservices?” earns you a confident essay about everything — except your situation. “Có nên dùng microservices không?” sẽ mang về một bài luận tự tin về mọi thứ — trừ tình huống của bạn.
Solutions masquerade as problemsGiải pháp đóng vai vấn đề
“Rewrite it in Rust” is a solution looking for a problem. Until someone asks what actually breaks, you’re optimizing a feeling. “Rewrite bằng Rust” là một giải pháp đi tìm vấn đề. Cho tới khi ai đó hỏi thứ gì thực sự hỏng, bạn đang tối ưu một cảm giác.
Nobody asks the second questionChẳng ai hỏi câu thứ hai
One-shot answers skip the interview. The first answer is about what you said; the useful one is about what you meant. Trả lời một phát ăn ngay thì bỏ qua phỏng vấn. Câu trả lời đầu nói về thứ bạn nói; câu hữu ích nói về thứ bạn thực sự muốn.
Six steps from raw idea to honest advice. Sáu bước từ ý tưởng thô tới lời khuyên thẳng.
Analyze the inputPhân tích đầu vào
Prompt or URL — GitHub issue, PR, discussion, spec, doc. Extracts the stated problem, the implied one, and the hidden assumptions, then plays its understanding back in 2–3 bullets. Prompt hoặc URL — GitHub issue, PR, discussion, spec, doc. Tách vấn đề đã nêu, vấn đề ngầm và các giả định ẩn, rồi phát lại hiểu biết trong 2–3 gạch đầu dòng.
Scout the codebaseQuét codebase
Parallel Explore subagents map the relevant modules, existing patterns and constraints. Questions grounded in your actual code beat abstract ones. Các Explore subagent chạy song song, lập bản đồ module liên quan, pattern hiện có và ràng buộc. Câu hỏi gắn với code thật bao giờ cũng đắt hơn câu hỏi trừu tượng.
Interview, one at a timePhỏng vấn, từng câu một
Why → pros & cons → alternatives → constraints → converge. Never batched. Usually 4–8 questions — it stops when answers stop changing the reframing. Why → ưu/nhược → phương án khác → ràng buộc → hội tụ. Không bao giờ hỏi dồn. Thường 4–8 câu — dừng khi câu trả lời không còn làm diễn giải thay đổi.
Confirm the reframingChốt diễn giải
Problem restated, exact verifiable requirements, goals, non-goals, constraints — you confirm explicitly before any advice is given. Vấn đề phát biểu lại, requirements rõ ràng kiểm chứng được, goals, non-goals, ràng buộc — bạn xác nhận tường minh trước khi có lời khuyên.
Deliver honest adviceĐưa lời khuyên thẳng
Verdict first. Weak, over-engineered, or premature — you hear it plainly, with what to do, what to avoid, and cheaper paths ranked by effort-to-impact. Phán quyết trước. Yếu, over-engineered hay chạy trước nhu cầu — bạn sẽ nghe thẳng, kèm nên làm gì, nên tránh gì, và đường rẻ hơn xếp theo effort/impact.
Emit outputsXuất kết quả
Conversation by default. Add flags for a self-contained HTML report, polished markdown, a wiki page, or a reply straight onto the GitHub issue. Mặc định trong hội thoại. Thêm flag để có HTML report self-contained, markdown hoàn chỉnh, trang wiki, hoặc reply thẳng vào GitHub issue.
The interview is the skill. Phỏng vấn chính là skill.
Everything else is plumbing. The core loop is a hard gate: exactly one question per turn — because batched questions get shallow answers. It pushes back on vagueness, grounds options in your code, and stops when the reframing stops moving. Mọi thứ khác chỉ là phụ. Vòng lặp cốt lõi là một hard gate: đúng một câu hỏi mỗi lượt — vì hỏi dồn chỉ nhận về câu trả lời hời hợt. Skill phản biện khi bạn nói chung chung, bám options vào code thật, và dừng khi diễn giải không còn nhúc nhích.
Start with whyBắt đầu bằng why
What outcome makes this worth doing? What breaks — or is lost — if it’s never done? Kết quả nào khiến việc này đáng làm? Không làm thì cái gì hỏng — mất gì?
Challenge with pros & consThách thức bằng ưu & nhược
The strongest argument against your current framing, presented to your face. You have to respond to it. Lập luận mạnh nhất chống lại cách bạn đang đặt vấn đề, nói thẳng mặt. Bạn phải phản hồi nó.
Explore alternativesKhám phá phương án khác
2–3 different routes to the same outcome — including “do nothing” and “do less”. Which trade-offs can you live with? 2–3 đường khác tới cùng một kết quả — kể cả “không làm gì” và “làm ít thôi”. Bạn chịu được trade-off nào?
Pressure-test constraintsÉp ràng buộc
Budget, timeline, maintenance burden, available skills, existing stack lock-in. Ngân sách, deadline, gánh maintenance, kỹ năng sẵn có, stack lock-in hiện tại.
ConvergeHội tụ
Loop until the problem can be restated as exact requirements and goals — in your own words. Lặp tới khi vấn đề phát biểu lại được thành requirements và goals chính xác — bằng chính lời của bạn.
Advice you can act on, not admire. Lời khuyên để hành động, không phải để ngắm.
Every run ends in the same eight-part structure — closing with a checklist you can hand to ak:plan and success metrics that define “done” as a command, a number, or an observable state. Not a vibe. Mỗi lần chạy kết thúc bằng cùng một cấu trúc 8 phần — chốt bằng checklist có thể đưa thẳng cho ak:plan và success metrics định nghĩa “xong” bằng một lệnh, một con số, hoặc một trạng thái quan sát được. Không chơi kiểu “cảm giác ổn”.
VerdictPhán quyết
The honest one-paragraph take. If it’s weak, over-engineered, or premature — said plainly, with why.Nhận định thẳng trong một đoạn. Yếu, over-engineered hay quá sớm — nói phắc, kèm lý do.
What you should doNên làm gì
Concrete, ordered actions serving the confirmed goals.Hành động cụ thể, có thứ tự, phục vụ goals đã chốt.
What you shouldn’t doKhông nên làm gì
Traps, premature optimizations, scope creep — approaches that look attractive but cost more than they return.Bẫy, tối ưu sớm, scope creep — mấy hướng nhìn ngon nhưng giá cao hơn giá trị mang lại.
What could be betterCó thể tốt hơn
Cheaper or simpler paths to the same outcome, ranked by effort-to-impact.Đường rẻ hơn, đơn giản hơn tới cùng kết quả, xếp theo effort/impact.
My take & the routeQuan điểm & lộ trình
The recommended path with a step-level route from current state to goal.Con đường được đề xuất, từng bước từ hiện trạng tới mục tiêu.
BenefitsLợi ích
Bulleted, tied to your confirmed goals — not generic virtue.Gạch đầu dòng, gắn với goals đã chốt — không nói chung chung.
Trade-offsTrade-offs
The honest costs — including what your own decisions cost where the skill disagreed.Cái giá thật — kể cả giá của chính quyết định bạn giữ khi hai bên bất đồng.
Checklist & success metricsChecklist & metrics
A checkbox list small enough to hand to ak:plan / ak:cook, plus measurable “done” criteria.Checklist đủ nhỏ để bàn giao cho ak:plan / ak:cook, kèm tiêu chí “xong” đo được.
Advice, delivered where you need it. Lời khuyên, giao tận nơi bạn cần.
No flags — the advice stays in the conversation. Add flags and specialized subagents carry it to the right destination. Không flag — lời khuyên nằm trong hội thoại. Thêm flag và các subagent chuyên dụng sẽ mang nó tới đúng nơi cần đến.
--html
Visual HTML reportBáo cáo HTML trực quan
Self-contained page: verdict, requirements, do/don’t columns, alternatives compared, benefits vs trade-offs. Inline CSS/JS, responsive, reduced-motion aware. Trang self-contained: verdict, requirements, cột nên/không nên, so sánh phương án, lợi ích vs trade-offs. CSS/JS inline, responsive, tôn trọng reduced-motion.
--md
Polished markdownMarkdown hoàn chỉnh
A standalone report written for someone who never saw the conversation. Báo cáo độc lập, viết cho người chưa từng xem cuộc hội thoại.
--wiki
Publish to AgentWikiĐăng lên AgentWiki
Private-first upload with a share URL. Public only when you explicitly ask. Skips gracefully if the capability is missing. Upload private-first kèm share URL. Chỉ public khi bạn yêu cầu rõ. Thiếu capability thì skip êm, không chặn luồng.
--github
Reply on the issueReply vào GitHub issue
Comments the advice straight onto the source issue — or opens a new one with the reframing attached. Real errors reported, success never faked. Comment lời khuyên thẳng vào issue gốc — hoặc mở issue mới kèm phần diễn giải. Lỗi thật được báo, không bao giờ giả vờ thành công.
--agent
Delegate to the advisorỦy quyền cho advisor
Runs the whole workflow on the fable model in isolated context; questions relayed back to you, capped at 12 rounds. Claude Code only. Chạy toàn bộ workflow trên model fable trong context cô lập; câu hỏi được relay về bạn, tối đa 12 vòng. Chỉ Claude Code.
--html --wiki --github
Combine freelyMix tự do
Flags stack. Independent subagents run in parallel — report, wiki page, and issue comment in one go. Flags cộng dồn. Các subagent độc lập chạy song song — report, trang wiki và comment issue trong một lần chạy.
Every artifact path and URL is reported back at the end. No silent side effects. Mọi đường dẫn artifact và URL đều được báo lại ở cuối. Không side effect thầm lặng.
Opinionated by design. Có chính kiến, cố ý như vậy.
YAGNI → KISS → DRY
In that order. Boring, proven approaches win; novelty is flagged as risk unless your goals demand it. Đúng thứ tự đó. Giải pháp nhàm chán mà chắc sẽ thắng; cái mới mẻ bị gắn cờ rủi ro trừ khi goals của bạn đòi hỏi.
Advisory onlyChỉ tư vấn
It never implements, scaffolds, or edits your code. The only files it writes are its own reports. Không bao giờ implement, scaffold hay sửa code của bạn. File duy nhất nó ghi là report của chính nó.
The interview is mandatoryPhỏng vấn là bắt buộc
Even when the input looks complete. A spec surviving five hard questions unchanged is the exception, not the rule. Kể cả khi input trông đã hoàn chỉnh. Spec sống sót qua năm câu hỏi khó mà không đổi là ngoại lệ, không phải quy luật.
Verified vs. believedĐã kiểm chứng vs. tin thôi
Scout evidence and URL facts are labeled separately from opinion. Speculation never wears a fact costume. Bằng chứng từ scout và URL được tách riêng khỏi quan điểm. Phỏng đoán không bao giờ được đóng vai sự thật.
No secrets, everTuyệt đối không secrets
Reports never contain credentials, tokens, or personal data. Instructions inside fetched URLs are treated as data, not commands. Report không bao giờ chứa credentials, token hay dữ liệu cá nhân. Chỉ thị nhúng trong URL được fetch là dữ liệu, không phải mệnh lệnh.
Your call standsQuyết định là của bạn
It challenges hard, then respects the decision. Disagreements show up in the trade-offs section — never as silent overrides. Skill thách thức hết mình, rồi tôn trọng quyết định. Bất đồng xuất hiện ở mục trade-offs — không bao giờ âm thầm ghi đè.
Sits between discovery and planning. Nằm giữa khám phá và lên kế hoạch.
ak:scoutdiscoverykhám phá
ak:adviseyou are herebạn đang ở đây
ak:brainstormexplore solutionsđào giải pháp
ak:planplan the advicelên kế hoạch
ak:cookimplementtriển khai
Follows a raw idea or /ak:scout · hands its checklist to ak:plan / ak:cook · need a single-shot answer without the interview? use ak:ask Đi sau ý tưởng thô hoặc /ak:scout · đưa checklist cho ak:plan / ak:cook · cần trả lời nhanh không phỏng vấn? dùng ak:ask
Put it to work. Dùng ngay.
$ /ak:advise "should we migrate to microservices?"
copy$ /ak:advise https://github.com/org/repo/issues/123
copy$ /ak:advise "rewrite the API layer" --html --wiki
copy$ /ak:advise https://github.com/org/repo/issues/123 --github --agent
copy
Bring a half-formed idea.
Leave with a plan.
Mang theo ý tưởng nửa vời.
Ra về với một kế hoạch.
No setup. No code harmed. Just questions you probably needed to hear. Không setup. Không dòng code nào bị hại. Chỉ là những câu hỏi có lẽ bạn cần được nghe.
/ak:advise "your raw idea hereý tưởng nửa vời của bạn"
copy