grill-me

Tổng quan về grill-me skill

grill-me làm gì

grill-me là một skill chất vấn quyết định dành cho các workflow agent kiểu Claude. Thay vì đưa ra nhận xét chung chung về một kế hoạch, grill-me skill sẽ phỏng vấn bạn từng câu hỏi một cho đến khi các nhánh chưa rõ, phụ thuộc, đánh đổi và giả định được làm sáng tỏ. Cơ chế cốt lõi rất đơn giản nhưng hữu ích: đặt một câu hỏi buộc phải lựa chọn, kèm câu trả lời được khuyến nghị, chờ bạn phản hồi, rồi tiếp tục đi sâu theo cây quyết định.

Phù hợp nhất cho Decision Support

Hãy dùng grill-me cho Decision Support khi bạn có kế hoạch sản phẩm, thiết kế kỹ thuật, đề xuất kiến trúc, chiến lược migration, checklist launch, hoặc một tài liệu kiểu “chúng ta nên làm X” cần được thử sức trước khi triển khai. Skill này đặc biệt hữu ích khi kế hoạch còn TBD, đánh đổi mơ hồ, phụ thuộc ẩn, hoặc có những quyết định được chọn theo mặc định thay vì được cân nhắc chủ động.

Điểm khác biệt của skill này

Điểm khác biệt nằm ở tính kỷ luật. grill-me skill không gom mười câu hỏi một lúc, không trôi sang phê bình chung chung, và không để người dùng trả lời mơ hồ cho xong. Skill này ưu tiên khám phá codebase thay vì hỏi những câu không cần thiết, đi theo từng nhánh theo chiều sâu, và đặt các câu hỏi buộc phải đối diện như “Vì sao chọn X mà không phải Y?” hoặc “Điều gì sẽ thuyết phục bạn rằng hướng này là sai?” Repository cũng có các helper Python chỉ dùng stdlib để trích xuất nhánh quyết định, tạo câu hỏi và theo dõi session nhiều lượt.

Khi nào đây không phải công cụ phù hợp

Đừng cài grill-me nếu bạn muốn có một bản kế hoạch bóng bẩy được viết từ đầu, một bạn đồng hành brainstorm nhẹ nhàng, hoặc một lượt review nhanh kiểu “LGTM”. Skill này chủ ý tạo cảm giác không thoải mái: nó được thiết kế để làm chậm cuộc trao đổi, phơi bày lập luận yếu và buộc người tham gia phải cam kết. Vì vậy, nó rất mạnh trước các quyết định có chi phí cao, nhưng quá nặng cho những lựa chọn vụn vặt.

Cách dùng grill-me skill

Cài grill-me và đường dẫn repository

Cài bằng:

npx skills add alirezarezvani/claude-skills --skill grill-me

Skill nằm tại engineering/grill-me/skills/grill-me trong repository. Hãy bắt đầu bằng cách đọc SKILL.md, sau đó xem các file hỗ trợ giải thích cách chạy một phiên grill hiệu quả hơn: references/forcing_question_patterns.md, references/when_to_stop_grilling.md, và references/companion_tooling.md. Các script nằm trong scripts/ và chỉ yêu cầu Python stdlib.

Đầu vào skill cần

Để grill-me usage cho kết quả tốt nhất, hãy cung cấp một kế hoạch hoặc artifact thiết kế, không chỉ một mục tiêu mơ hồ. Đầu vào tốt nên có:

• quyết định bạn đang cố đưa ra
• hướng tiếp cận hiện tại đang được đề xuất
• các phương án thay thế đã cân nhắc
• ràng buộc, deadline và rủi ro đã biết
• những phần còn TBD hoặc nhạy cảm về mặt tổ chức
• link hoặc path tới code, docs, ticket hoặc ghi chú kiến trúc liên quan

Prompt yếu là: “Grill me on this idea.”
Prompt tốt hơn là: “Use grill-me on docs/auth-migration.md. We plan to move sessions from Redis to Postgres before Q3. Focus on rollback, performance risk, and whether our dependency on the billing service is actually locked.”

Workflow thực tế

Một workflow grill-me guide có tín hiệu tốt thường như sau:

1. Đưa kế hoạch vào một file markdown.
2. Yêu cầu agent dùng grill-me và đọc kế hoạch trước.
3. Nếu câu trả lời có trong repository hoặc codebase, để agent tự kiểm tra file thay vì hỏi bạn.
4. Trả lời từng câu hỏi một.
5. Ghi lại các quyết định khi chúng đã được chốt.
6. Chỉ dừng khi các nhánh chưa giải quyết đã được xử lý hết.

Với các kế hoạch lớn hơn, hãy chạy các helper script trên máy local:

python scripts/decision_tree_extractor.py path/to/plan.md

python scripts/question_generator.py path/to/plan.md --output json

python scripts/grill_session_tracker.py --action start --session auth-migration --plan path/to/plan.md

Các công cụ này không gọi LLM. Chúng giúp làm lộ các nhánh quyết định và giữ trạng thái xuyên suốt những phiên review dài.

Mẫu prompt hiệu quả

Hãy dùng prompt nêu rõ quyền hạn, phạm vi và quy tắc dừng:

“Use the grill-me skill for Decision Support on this plan: <path>. Ask one question per turn. Provide your recommended answer with each question. Explore the codebase before asking anything answerable from files. Walk dependencies depth-first. Track resolved decisions and tell me when every branch is answered or when no new questions arise.”

Điều này quan trọng vì giá trị của skill nằm ở trình tự chất vấn. Nếu bạn yêu cầu “mọi feedback cùng lúc”, bạn đã bỏ qua lợi ích chính.

FAQ về grill-me skill

grill-me chỉ dành cho kế hoạch kỹ thuật thôi sao?

Không. Đường dẫn repository thiên về kỹ thuật, và quy tắc khám phá codebase rất hữu ích cho dự án phần mềm, nhưng phương pháp này cũng dùng được cho quyết định về sản phẩm, vận hành, tuyển dụng, GTM và chiến lược. Trường hợp phù hợp nhất là bất kỳ kế hoạch nào mà giả định ẩn nguy hiểm hơn việc thiếu vài câu chữ trau chuốt.

Skill này tốt hơn một prompt thông thường ở điểm nào?

Một prompt thông thường như “critique this plan” thường tạo ra một danh sách nhận xét. grill-me tạo ra một vòng chất vấn. Mỗi câu hỏi gắn với một nhánh quyết định, có kèm câu trả lời được khuyến nghị, và chờ phản hồi của bạn trước khi tiếp tục. Nhờ vậy, nó phù hợp hơn để giải quyết sự mơ hồ, không chỉ dừng ở việc chỉ ra sự mơ hồ đó.

Người mới có dùng grill-me được không?

Có, nhưng người mới nên bắt đầu với một kế hoạch ngắn. Skill này có thể tạo cảm giác khá căng vì nó hỏi về đánh đổi, tiêu chí loại bỏ và phương án thay thế. Nếu bạn chưa hiểu rõ domain, hãy trả lời trung thực về những điều chưa biết; phiên làm việc khi đó có thể tách bạch giữa “chưa quyết” và “đang bị chặn vì thiếu thông tin.”

Nên kiểm tra gì trước khi cài?

Hãy kiểm tra runtime agent của bạn có hỗ trợ skill từ GitHub không và bạn có sẵn sàng làm việc theo workflow nhiều lượt không. Ngoài ra, nên xem trước SKILL.md và ba file reference. Nếu muốn dùng helper script, hãy xác nhận bạn có thể chạy lệnh Python local và việc ghi session JSON vào ~/.grill_sessions/ là chấp nhận được trong môi trường của bạn.

Cách cải thiện grill-me skill

Cung cấp nguồn đầu vào sắc nét hơn cho grill-me

Cách nhanh nhất để cải thiện output của grill-me là làm cho kế hoạch dễ kiểm tra hơn. Hãy thêm các heading cho goals, non-goals, constraints, alternatives, dependencies, rollout, rollback, metrics và open questions. Decision extractor tìm các tín hiệu như “we will,” “TBD,” “vs,” “depends on,” và “trade-off,” nên cách viết rõ ràng sẽ giúp workflow tìm ra các nhánh tốt hơn.

Tránh các lỗi thường gặp

Các lỗi thường gặp gồm hỏi quá nhiều câu cùng lúc, chấp nhận câu trả lời mơ hồ, bỏ qua việc khám phá codebase, hoặc dừng lại sau nhánh đầu tiên gây khó chịu. Nếu agent gom nhiều câu hỏi, hãy chỉnh lại: “Return to grill-me: one question only, with a recommended answer.” Nếu nó hỏi điều đã được ghi trong tài liệu, hãy chỉ tới file đó và yêu cầu kiểm tra trước khi tiếp tục.

Lặp lại sau phiên đầu tiên

Sau phiên grill đầu tiên, hãy cập nhật kế hoạch bằng các quyết định đã chốt và rủi ro mới phát hiện. Sau đó chạy lại decision_tree_extractor.py. Lượt thứ hai này thường tìm ra các nhánh mới do chính câu trả lời của bạn tạo ra. Một phiên tốt nên kết thúc với ít TBD hơn, lý do loại bỏ các phương án thay thế rõ hơn, và tiêu chí dừng cụ thể cho các lựa chọn rủi ro.

Tinh chỉnh skill cho đội ngũ của bạn

Các team có thể tăng khả năng adoption bằng cách thêm ví dụ nội bộ: một architecture decision record tốt, một kế hoạch mơ hồ kém chất lượng, các nhóm rủi ro ưu tiên, và tiêu chí launch tiêu chuẩn. Hãy giữ nguyên kỷ luật cốt lõi của grill-me, nhưng điều chỉnh phong cách câu trả lời được khuyến nghị cho phù hợp với ràng buộc của tổ chức. Mục tiêu không phải là hỏi gắt hơn; mục tiêu là đạt được hiểu biết chung nhanh hơn trước khi bắt đầu những phần việc tốn kém.