Files

T

c7d71b77a7 docs(agent): thư viện instruction cho việc sửa bug UI/UX

Bộ 7 role chuyên biệt (triage → specialist → implementer → reviewer) cùng
lớp dùng chung: guardrail, tri thức về repo, checklist, và contract đầu ra.

Vì sao có: bug UI/UX được báo bằng lời kể triệu chứng, và người sửa hay bỏ
qua ba thứ mà repo này rất dễ vi phạm — luật "không file nào ngoài theme/
được đặt tên một màu", trần LOC theo bánh cóc, và việc ui/ với presentation/
cùng tồn tại nên sửa nhầm file là "đã fix mà vẫn thấy lỗi".

knowledge/qt_pitfalls.md chép lại 20 nguyên nhân gốc hay gặp của bug PySide6;
examples/bad_fix.md có hai ca CÓ THẬT, gồm ca chính bản vá trong nhánh này
từng mắc (compare_digest trên str ngoài ASCII) và lọt qua vòng review đầu.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-10 01:34:36 +09:00

2.8 KiB

Raw Blame History

Output Contract — `defect_record`

Do ui-bug-triage sinh ra. Giữ đúng thứ tự và tên mục. Không có dữ liệu thì ghi unknown hoặc N/A kèm lý do — không xoá mục.

---
defect_id: UI-<YYYYMMDD>-<NN>
from_agent: ui-bug-triage
next_agent: <ui-visual-fixer | ux-flow-fixer | i18n-a11y-fixer | RETURN_TO_REPORTER>
category: <visual | flow | i18n-a11y | not-ui>
severity: <S1 | S2 | S3 | S4>
confidence: <low | medium | high>
reproducible: <yes | no | intermittent>
security_review: <required | not-required>
affected_files: []
themes_verified: []
languages_verified: []
blocked_on: []
---

1. Tóm tắt

Một câu: cái gì hỏng, ở màn nào, với ai.

2. Quan sát vs kỳ vọng


Người dùng thấy
Người dùng mong
Người dùng suy đoán (chưa xác minh)

3. Môi trường

Trường	Giá trị
Phiên bản app / commit
OS + độ phân giải + mức scale
Theme lúc xảy ra
Ngôn ngữ lúc xảy ra
Project / workspace liên quan	(mô tả, không nêu tên khách hàng)

4. Các bước tái hiện

Tỉ lệ tái hiện: luôn / thỉnh thoảng (n/m lần) / không

5. Ma trận biến thể đã thử

Biến thể	Đã thử	Kết quả
Theme dark
Theme light
Ngôn ngữ vi / ja / en
Cửa sổ nhỏ nhất / maximize
Đổi theme/ngôn ngữ trước rồi mới mở màn (bẫy P07)

6. Khoanh vùng


Nav row	Dashboard / Schedule / Workspace / Monitoring
Sub-tab / dialog
`manifest.json` slug
Widget dựng tại	`file.py:line`
Control (`controls.json`)	`var`, `type`, `object_name`
Đã kiểm cả `ui/` và `presentation/`	có / không

7. Giả thuyết nguyên nhân gốc

#	Giả thuyết	Mã pitfall	Đã xác minh thế nào	Còn / loại
1		P__
2		P__

Kết luận: (một nguyên nhân + file:line, hoặc "chưa xác định" nếu confidence: low)

8. Tác động

Ai bị ảnh hưởng:
Chặn công việc gì:
Có đường vòng không:
Lý do chọn mức severity này:

9. Cân nhắc bảo mật

Chạm permission / credential / monitoring bảo mật / isolation / routing? có / không
Dữ liệu người dùng gửi lên đã redact? có / không — mô tả đã bỏ gì
Có dấu hiệu ở system/security.md S4 không?

10. Open Questions (tối đa 3)

#	Câu hỏi	Mặc định nếu không trả lời	Có chặn không
1			có / không

11. Out of scope

Vấn đề khác phát hiện được, không sửa trong lần này — đề xuất issue riêng.

2.8 KiB Raw Blame History

Output Contract — defect_record