knowhow-query

name

knowhow-query

description

Dùng khi 'kho' hoặc 'knowhow' là ĐÍCH được hỏi: user hỏi kho tri thức chứa gì, không phải hỏi web hay codebase. Bao gồm: tra bài học/quyết định của team ('kho có gì về X', 'kho tri thức có...không'), tìm cách làm đã ghi ('tìm/so sánh trong knowhow'), tổng hợp từ knowhow đã tích luỹ trong kho, hoặc soạn tài liệu onboarding/đào tạo từ wiki của kho. Tín hiệu phân biệt: câu hỏi hướng VÀO kho như nguồn thông tin. KHÔNG dùng cho: tìm trên internet, đọc file project/log/config bất kỳ, làm theo một quy trình đã đúc kết (đó là knowhow-run), hay kiểm tra sức khoẻ hệ thống (đó là knowhow-lint).

Knowhow Query

Trả lời câu hỏi từ knowhow đã tích luỹ. Đồng thời là nguồn tín hiệu thứ ba cho tiến hoá cấu trúc: câu hỏi lặp mà không trúng page là dấu hiệu mạnh của thiếu cấu trúc.

Precondition

Kiểm tra .knowhow/ tồn tại trong workspace:

ls -d .knowhow/ 2>/dev/null

Nếu không tồn tại, dừng và hướng dẫn user chạy knowhow-init trước.

Flow query

Bước 1: Tìm page liên quan

1. Đọc wiki/index.md + skills/registry.md + workflows/registry.md để biết tổng quan.
2. Rút 3-5 từ khoá từ câu hỏi. Grep tìm page liên quan:

   grep -ril "<từ khoá>" .knowhow/wiki .knowhow/skills .knowhow/workflows
   

3. Đọc các file hit.

Bước 2: Tổng hợp câu trả lời

• Tổng hợp từ các page đã đọc, trả lời trực tiếp câu hỏi.
• Trích dẫn nguồn bằng [[slug]] cho mỗi tuyên bố lấy từ một page cụ thể.
• Nếu không tìm thấy page nào liên quan, nói thẳng "chưa có knowhow về việc này" thay vì bịa.

Bước 3: Phát tín hiệu query-miss

Đánh giá chất lượng câu trả lời. Emit vào khi MỘT trong hai: