Files

T

anhtnm1andClaude Opus 5 7bd2b95a57 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-07 19:55:02 +09:00

1.9 KiB

Raw Blame History

Output Contract — `pr_body`

Do regression-reviewer sinh ra khi verdict là PASS / PASS_WITH_NOTES. Khớp đúng .gitea/PULL_REQUEST_TEMPLATE.md — giữ nguyên tiêu đề mục để reviewer quen mắt.

Tiêu đề PR: fix(ui): <mô tả ngắn, tiếng Anh, thể mệnh lệnh>

Summary

Nói tại sao, không chỉ cái gì. Nêu triệu chứng người dùng, nguyên nhân gốc kèm file:line, và vì sao chọn cách sửa này.

Root cause: path/to/file.py:123 (pitfall P__) Defect: UI-<YYYYMMDD>-<NN>

Change Type

Cowork feature
Bug fix
Core AI contribution
Test / hardening
Performance
Documentation

Cowork Task:

Core Repo: http://34.143.229.138/gitea-admin/fsg-ai-core-assets

Core AI Issue:

Core Task:

Related PR:

Scope

Cố ý bao gồm:

Cố ý KHÔNG bao gồm: (các phát hiện out-of-scope, kèm issue đề xuất)

Validation

Unit tests
Integration tests
Manual verification
Regression check

Commands / evidence:

python scripts/run_quality_gate.py
QT_QPA_PLATFORM=offscreen pytest tests/ui/test_<...>.py -q

<output thật>

Ma trận kiểm bằng mắt:

Trục	Kết quả
dark / light
vi / ja / en
cửa sổ nhỏ nhất / maximize

Security Impact

Permission / credential / network / customer data impact.

Điền cả khi là "không có". Nếu security-review: required: ghi rõ tại sao, và nhắc rằng CI xanh không đủ để merge (docs/governance/review-policy.md).

Compatibility

No breaking change
Breaking change documented

Reviewer Notes

Chỉ đúng chỗ cần soi kỹ nhất. Kèm các finding should-fix / nit mà reviewer agent đã ghi nhận nhưng không chặn merge.

Ảnh docs/screens/ cần chụp lại: có/không — liệt kê slug

1.9 KiB Raw Blame History

Output Contract — pr_body