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 cho đến khi bạn và agent có cùng một hình dung về kết quả, hiển thị kết quả đó dưới dạng trực quan để bạn xác nhận, rồi 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, mô tả điều bạn mong thấy khi công việc hoàn tất, và xác nhận rõ reframing cuối cùng preview của nó.
• 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:

--ultra và --agent loại trừ lẫn nhau vì mỗi flag điều khiển cách tạo advice. Khi chọn --ultra, Skill giữ phần candidate adviser ở chế độ read-only, yêu cầu năm candidate dùng được với một lần re-dispatch có giới hạn nếu cần, và ghi ranking appendix ngắn. Chế độ này lấy cảm hứng từ LLM-as-a-Verifier nhưng không tuyên bố dùng logprob hoặc tournament mechanic.

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. Skill cũng hỏi bạn mong thấy hoặc dùng được gì khi công việc hoàn tất — sample input và output, một màn hình, một command cùng kết quả của nó, hoặc before và after — và điều gì sẽ khiến bạn nói "đó không phải ý tôi".
4. Skill tiếp tục hỏi đến khi scope được khoá. Không có giới hạn số câu hỏi. Interview tiếp tục đến khi mọi requirement, mục Done means và non-goal đủ cụ thể để đoán được phản ứng của bạn với kết quả cuối. Mỗi câu hỏi lấp một khoảng trống cụ thể; câu hỏi nào mà answer không làm thay đổi reframing sẽ được bỏ qua. Bạn có thể kết thúc interview bất cứ lúc nào; khi đó các khoảng trống còn lại được mang tiếp dưới dạng assumption có đánh dấu.
5. Bạn xem preview và xác nhận reframing. Skill hiển thị problem cụ thể, exact requirement, goal, non-goal, constraint và Done means — các observable end state cho thấy công việc đã hoàn tất. Cleanup end state chỉ xuất hiện khi công việc thay thế hoặc gỡ bỏ điều gì đó. Skill cũng hiển thị preview trực quan của kết quả đề xuất: diagram từ ak:diagram cho các thành phần, luồng và ranh giới scope, hoặc HTML explainer từ ak:explain cho cách kết quả vận hành hay cảm giác khi dùng. Khi không có Skill nào trong hai Skill này, Skill dùng Mermaid diagram inline kèm text mockup. Nếu preview không khớp với điều bạn hình dung, interview quay lại khoảng trống đó và preview được vẽ lại. 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 đó. Nếu đường đi đề xuất làm thay đổi một end state đã xác nhận, mục đã xác nhận vẫn ở lại trong Done means, thay đổi đề xuất chuyển sang Needs from you, và trở thành một stop condition.
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 và preview qua main session, nơi preview được render. Relay không có giới hạn số vòng cố định vì mỗi vòng đều chờ answer của bạn; bạn có thể yêu cầu dừng bất cứ lúc nào và lần chạy báo state đã lưu để bạn tiếp tục sau. Nếu adviser tiếp tục hỏi lại câu bạn đã trả lời, lần chạy dừng và báo state thay vì lặp.

Needs from you chỉ chứa điều gì đó mà session không thể tự giải quyết — một approval đang chờ, một fact còn thiếu, hoặc một quyết định chỉ bạn mới đưa được — hoặc xuất hiện ở nơi không thể hỏi được. Một quyết định bạn có thể trả lời ngay sẽ được hỏi từng câu một trong interview thay vì đưa vào đó; khi còn điều gì đó, advice sẽ mở đầu bằng phần Needs from you liệt kê nó trước tiê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:

• Preview của kết quả đề xuất mà bạn đã xác nhận là khớp với điều bạn hình dung, trừ khi không có cấu trúc nào đáng vẽ hoặc bạn từ chối preview.
• Problem đã reframe và được người dùng xác nhận, gồm Done means — các observable end state cho thấy công việc đã hoàn tất. Cleanup end state chỉ áp dụng khi công việc thay thế hoặc gỡ bỏ điều gì đó.
• Requirement, goal, non-goal cùng constraint có thể kiểm tra.
• Verdict rõ, phân biệt verified evidence khỏi judgment.
• Phần Unverified liệt kê claim chưa được xác nhận, nơi đã kiểm tra và điều gì sẽ xác nhận được chúng.
• 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, được phát biểu là working once delivered hoặc adopted, với Done means là finish line của công việc.
• Handoff brief copy-paste được (Objective, Done means, Out of scope (chỉ confirmed non-goal), Constraints (chỉ confirmed non-negotiable), Stop and ask only if) ở cuối, sẵn sàng đưa cho ak:plan, ak:cook hoặc một lần chạy autonomous dài.
• Phần Needs from you ở đầu, chỉ cho điều gì đó session không thể tự giải quyết hoặc xuất hiện ở nơi không thể hỏi được; quyết định bạn có thể trả lời trong interview sẽ được hỏi từng câu một thay vì đưa vào đó.
• 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.