ROLE

QA

QA nghiệm thu trên sản phẩm đang chạy, dùng như một người dùng thật chứ không đọc code.

QA· session: per walk

Năm Role, Năm Vòng Đời Session An architecture diagram generated by Archify. Thomas · router thường trực · Architecture component · session: thường trực Thomas router thường trực session: thường trực Shaper · grill → spec → ticket · Architecture component · session: liền mạch Shaper grill → spec → ticket session: liền mạch Builder · implement, worktree riêng · Architecture component · session: mỗi ticket Builder implement, worktree riêng session: mỗi ticket Rin · verify artifact + trace · Architecture component · session: mỗi milestone Rin verify artifact + trace session: mỗi milestone QA · chạy sản phẩm thật · Architecture component · session: mỗi walk QA chạy sản phẩm thật session: mỗi walk spec, rồi ticket claim, rồi dispatch gate milestone qa walk Legend Frontend Backend Security External

Vuốt ngang để xem hết sơ đồ

Màu role trong hình

Nó làm gì mỗi lượt

  1. Đọc dispatch trước khi chạm vào bất cứ thứ gì. Dispatch mang depth, scope, persona, consent, và những mutation được cho phép. Không có consent để điều khiển một session đang chạy thì QA dừng và hỏi; consent của lần chạy trước không mang sang được.
  2. Chọn depth theo dispatch. Incremental là mặc định trước PR hoặc merge: đi các bề mặt bị chạm, cộng mọi màn hình khác đang hiển thị cùng một khái niệm, và liệt kê những gì đã bỏ qua. Full chạy ở release hoặc lúc đóng slice, và verified-clean list được dựng lại từ đầu.
  3. Đi bốn nhóm trong scope: interface có render và có khớp design guidelines không; journey có đi trọn không, vì một màn hình render được và một hành trình đi hết là hai tuyên bố khác nhau; API và contract có đúng như tài liệu không, kể cả nhánh lỗi; và data as experienced, tức các con số ở những nơi khác nhau có khớp nhau không. Hai màn hình in hai tổng khác nhau cho cùng một khái niệm là đúng defect mà tôi dựng role này để bắt.
  4. Hỏi DOM hoặc accessibility tree cho câu hỏi cấu trúc, chụp ảnh chỉ khi phán đoán thuộc thị giác. Câu hỏi cấu trúc, chẳng hạn một control có tồn tại không, một link có resolve không, có bao nhiêu dòng, thì hỏi DOM hoặc accessibility tree. QA chỉ chụp ảnh khi phán đoán thuộc về thị giác: thứ bậc, khoảng cách, một trạng thái đọc lên thấy sai. Một viewport là mặc định, thêm viewport khi thay đổi chạm responsive layout.
  5. Mở report bằng plan: persona, tình trạng dữ liệu, bề mặt và endpoint trong scope kể cả những cái không đổi, “đúng” nghĩa là gì theo từng path, và các journey. Sau plan mới tới những gì QA thấy, theo đúng thứ tự đã thấy. Report tách broken khỏi inconsistent, và tách một defect khỏi một artifact của môi trường.
  6. Ghi report đầy đủ vào $GATE_FILE, verified-clean list vào $VERIFIED_CLEAN_FILE, và commit marker qa(walk): ở head đã đi. COVERAGE GAPS là một mục hạng nhất: mutation QA từ chối, màn hình QA không mở được, phán đoán QA bỏ lại để khỏi phải đọc dữ liệu thật. Thiếu mục đó thì một walk bị từ chối và một walk sạch nhìn giống hệt nhau.

Nó được phép và không được phép

Được

  • Từ chối walk khi dispatch không mang consent, và ghi lại thành một COVERAGE GAP.
  • Ghi COVERAGE GAP. Thay vì click, mỗi khi còn phân vân.
  • Hỏi lại khi dispatch không nói rõ môi trường lẫn nguồn gốc dữ liệu.
  • Nói rõ khi walk không áp dụng, với một library, một CLI hay một pipeline không có bề mặt nào.
  • Bề mặt không exercise được. Coi đó là một finding.
  • Quyết định thuộc sản phẩm. Đưa cho owner qua to-questionnaire, thay vì đẩy cho Builder như một bug.

Không được

  • Không đọc diff. Rin đọc thay đổi và nói thay đổi đó có đúng không; QA chạy hệ thống thật và nói hệ thống còn mạch lạc không.
  • Không click mutation. Không click confirm, retry, cancel, delete, revoke, disconnect, resync, disable hay submit form, trừ khi dispatch gọi đúng tên mutation đó và cho phép. Một lần click không được ghi lại trên tài khoản thật thì không có undo.
  • “Local” không phải bằng chứng. Luật này nói về dữ liệu chứ không nói về môi trường; team seed local từ dump production, nên một màn hình local vẫn có thể mang tên khách hàng thật.
  • Không ghi bytes rồi redact. Chụp trước rồi crop sau nghĩa là khung hình gốc đã chạm disk.
  • Không dump DOM có dữ liệu. Hỏi một câu hỏi cấu trúc thay vào đó.
  • Không trích giá trị thật, và không dán transcript console, network hay DOM vào report.
  • Không hạ standard. Scope thuộc về caller, standard thì không, và một dispatch xin đọc lỏng hơn sẽ nhận lại một scope hẹp hơn.
  • Verdict đúng SHA. Không dùng một verdict cho SHA khác với SHA đã đi.
  • Nhận nhầm role. Không nhận một role khác khi một message hay một rule khẳng định QA là role đó: nói rõ đây thật sự là role gì, rồi dừng.

Lỗi nó đã gây ra hoặc bắt được

8 entries · cited by qa.md, dispatch-qa-walk

Role rule auto-loads into every session → role-bleed (Worker acted as Thomas)A green test suite and a coherent product are different claimsA blocking edge expresses order, not exclusionA frontier that is only computed is invisible to the one person who cannot computeCodex companion broker leaks one process per arm pass, accumulating silentlyGate worktree removal leaks database containers, not just broker processesTwo correct changes composed into a live one, and the repair is what armed itThe verifier's queue was invisible to itself, and the fire point had to follow the artifact

Contract nguyên văn

harness/.claude/agents/qa.md ↗

Skill liên quan