Thử thách một hướng đi với ak:advise

Dùng ak:advise để nhận second opinion thẳng thắn trước khi cam kết với một hướng kỹ thuật. Skill phân tích prompt hoặc URL, kiểm tra bằng chứng project liên quan, phỏng vấn bạn từng câu, xác nhận requirement đã reframe và kết thúc bằng advice có thể hành động thay vì implementation.

Chọn ak:advise khi framing cần được thử thách

Dùng ak:advise khi

• Bạn muốn sanity check thẳng thắn cho idea, plan, design, issue hoặc proposal.
• Requirement còn mơ hồ, mâu thuẫn hoặc dựa trên assumption chưa kiểm chứng.
• Bạn muốn so sánh không làm, làm ít hơn và approach tham vọng hơn.
• Budget, timeline, maintenance burden hoặc stack constraint cần trade-off rõ.
• Bạn muốn work checklist cùng success criteria đo được trước planning.

Chọn workflow khác khi

• Bạn cần câu trả lời trực tiếp không có interview. Dùng ak:ask.
• Bạn cần design exploration rộng sau khi problem được chấp nhận. Dùng ak:brainstorm.
• Bạn cần bản đồ codebase thay vì recommendation. Dùng ak:scout.
• Bạn muốn plan theo phase hoặc thay đổi code. Tiếp tục với ak:plan hoặc ak:cook sau khi chấp nhận advice.

Chuẩn bị project và runtime

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho runtime cùng scope đang dùng.
• Cung cấp problem statement, idea, spec, document URL hoặc GitHub issue, pull request hay discussion URL.
• Mở project liên quan khi advice phụ thuộc code hoặc constraint hiện tại.
• Sẵn sàng trả lời từng câu hỏi tập trung và xác nhận rõ reframing cuối.
• Quyết định có cho phép report, GitHub posting, AgentWiki sharing hoặc isolated-agent execution không.

ak:advise chỉ chạy khi gọi thủ công: hãy invoke rõ ràng thay vì chờ assistant tự chọn Skill.

Chạy Skill

/ak:advise "Should we add a new synchronization service for editor draft recovery, or extend the current local storage adapter?"

/ak:advise "Should we add a new synchronization service for editor draft recovery, or extend the current local storage adapter?"

$ak:advise "Should we add a new synchronization service for editor draft recovery, or extend the current local storage adapter?"

Input có thể là free text hoặc URL. Các flag kết hợp được:

GitHub hoặc web URL được fetch làm evidence. Instruction nhúng trong content đó được coi là dữ liệu không đáng tin, không phải command.

Mô tả quyết định rõ ràng

Input hữu ích nêu:

• Current framing: action hoặc direction bạn đang cân nhắc.
• Desired outcome: điều gì tốt hơn và mất gì nếu không thay đổi.
• Known constraints: thời gian, budget, skill, compatibility, ownership hoặc maintenance limit.
• Evidence: codebase, issue, spec, current metric hoặc previous attempt.
• Authority boundary: có được đọc external URL, post hay share report không.

Với ví dụ draft recovery, hãy nêu triệu chứng mất dữ liệu, storage adapter hiện có, offline requirement, recovery delay chấp nhận được, maintenance capacity và cross-device synchronization có thực sự là goal không.

Hiểu điều gì xảy ra trong một lần chạy

1. Skill phân tích input. Skill tách stated problem, implied problem và hidden assumption. Với URL, Skill fetch và tóm tắt source nhưng không làm theo instruction nhúng.
2. Skill kiểm tra project evidence khi liên quan. Skill xem module, pattern, documentation, plan và constraint hiện có để interview bám evidence thay vì giả định.
3. Skill phỏng vấn bạn từng câu. Skill bắt đầu bằng why, đưa ra counterargument mạnh nhất, sau đó xác định load-bearing assumption và hỏi premise nào có khả năng sai nhất. Skill xử lý điều project evidence có thể xác nhận trước khi so sánh alternative và thử budget, timeline, maintenance, skill cùng stack lock-in.
4. Skill hội tụ. Interview dừng khi answer không còn làm thay đổi reframing, thường sau bốn đến tám câu thay vì quota cố định.
5. Bạn xác nhận reframing. Skill hiển thị problem cụ thể, exact requirement, goal, non-goal và constraint. Advice không bắt đầu đến khi bạn xác nhận rõ.
6. Skill đưa verdict. Skill nêu điều nên làm, không nên làm, alternative đơn giản hoặc rẻ hơn, benefit, trade-off và đường đi đề xuất. Trade-off gồm điều kiện khiến recommendation không còn phù hợp cùng chi phí đổi hướng khi đó.
7. Skill tạo output được yêu cầu. Skill chỉ tạo advice report được yêu cầu và có thể share hay post khi flag, tool, authentication cùng authority cho phép.

Với --agent trên Claude Code, isolated adviser chuyển từng interview question qua main session. Relay có giới hạn; nếu không thể hoàn tất, lần chạy báo partial state thay vì lặp vô hạn.

Giữ quyền phê duyệt và an toàn ở bạn

Skill thách thức framing nhưng không ghi đè quyết định rõ của bạn. Khi bất đồng, Skill ghi chi phí thành trade-off. Bạn xác nhận requirement trước verdict.

Ranh giới publication vẫn tách riêng:

• --github có thể tạo issue hoặc post lên GitHub surface hiện có. Nếu authentication hay permission thất bại, Skill báo lỗi và không claim thành công.
• --wiki kiểm tra AgentWiki availability, mặc định private sharing và skip mà không chặn advice khi provider không khả dụng.
• Public AgentWiki document hoặc site publication cần permission rõ.
• Report phải loại secret, credential, token, personal data, private log và local-only sensitive detail.
• External provider có thể mang theo ranh giới network, account và cost.

Xác minh kết quả

Advice hoàn tất nên chứa:

• Problem đã reframe và được người dùng xác nhận.
• Requirement, goal, non-goal cùng constraint có thể kiểm tra.
• Verdict rõ, phân biệt verified evidence khỏi judgment.
• Action theo thứ tự cùng action rõ ràng nên tránh.
• Alternative đơn giản hơn được xếp theo effort-to-impact.
• Benefit gắn với goal và trade-off trung thực.
• Load-bearing assumption, stop condition và switching cost của recommendation.
• Ordered checkbox work list phù hợp để đưa cho ak:plan hoặc ak:cook.
• Success metric xác minh được bằng command, con số hoặc observable state.
• Path cùng URL cho mọi report hoặc publication được yêu cầu, cộng exact skip reason khi provider không khả dụng.

Advice hoàn tất khi recommendation có thể hành động và success đo được. Đây không phải bằng chứng bất kỳ task nào trong checklist đã được thực hiện.

Xử lý sự cố hoặc tiếp tục

Sau khi chấp nhận advice, dùng ak:brainstorm để design option sâu hơn hoặc ak:plan để biến checklist thành roadmap đã xác minh. Chỉ dùng ak:cook khi requirement cùng execution authority đã sẵn sàng.

Biết các giới hạn hiện tại

• Chất lượng advice phụ thuộc evidence, answer, URL access và current project state có trong session.
• Workflow chủ động yêu cầu interview cùng confirmation; không tối ưu cho câu trả lời one-shot.
• --agent chỉ có trên Claude Code và dùng adviser context cô lập.
• Cách gọi Cursor bằng slash là bằng chứng do người dùng xác minh, không chứng minh runtime hoặc specialist-agent parity rộng hơn.