orca-issue
Installation
SKILL.md
Skill: orca-issue — vòng xử lý sự cố
Khác vòng làm-tính-năng ở hai chốt cứng: không tái hiện được thì không sửa, và không đỏ→xanh thì không đóng. Skill này điều phối đồ nghề đã có (impact-check, safe-change, verify-before-commit, failure-flywheel) — không làm lại chúng.
When to use
- Bug, lỗi runtime, regression, hành vi sai so với mong đợi, incident production.
- User nói: "lỗi rồi", "bị bug", "chạy sai", "hôm qua còn chạy", "trace lỗi này", "/orca-issue".
- KHÔNG dùng khi: yêu cầu tính năng/thay đổi mới →
propose/orca-workflow.
Steps — 5 chốt tuần tự, không nhảy cóc
- Triage — chép lại triệu chứng bằng 1–2 câu (cái gì sai, thấy ở đâu, từ bao giờ); thu log/screenshot/bối cảnh; phân mức (chặn việc / khó chịu / thẩm mỹ). Chưa rõ triệu chứng → hỏi user, đừng đoán.
- Repro-first GATE (chốt cứng #1) — viết script/test tái hiện lỗi, chạy ra kết quả ĐỎ (fail) và lưu lại làm bằng chứng (file test hoặc script + output). Chưa có repro đỏ thì DỪNG ở đây — không bàn nguyên nhân, không sửa. Lỗi không tái hiện được (flaky/heisenbug) → ghi rõ điều kiện đã thử, hạ xuống chế độ giám sát (thêm log/probe), không sửa mò.
- Khoanh vùng — dùng đồ nghề định vị thay vì grep mù: code-graph (
get_callers/get_symbol_context),impact-checkđể map ai phụ thuộc vùng nghi vấn,git bisect/git logkhi nghi regression theo thời gian. Kết quả: 1 câu "root cause nằm ở X vì Y". - Fix red→green (chốt cứng #2) — sửa qua
safe-change(code dùng chung thì map caller trước), surgical đúng vùng đã khoanh. Chạy lại repro ở bước 2: phải chuyển ĐỎ → XANH; chạy thêm test/verify sẵn có của dự án; chốt bằngverify-before-commit. Repro còn đỏ = chưa xong, quay lại bước 3 — không được "chắc là được rồi". - Distill kép — sau khi commit: (a) trang wiki incident vào
llmwiki/wiki/sources/(triệu chứng, root cause, fix, kèm## Origintrỏ commit + repro); (b) record vàofailure-flywheelđể lỗi lặp đủ ngưỡng tự đề xuất rule/skill; (c) dự án có problem-tree (llmwiki/html/problem-tree.htmlhoặcfdk-problem-tree.html) → thêm/flip node tương ứng.