Files
Starlight_Lancher/.agents/skills/oiloil-ui-ux-guide/references/review-template.md

61 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Review Output Template (Concise)
Use this template for `review` outputs. Keep each bullet short and implementable.
## Context
- Surface: (web/app) + page type (list/detail/form/dashboard/settings)
- Primary user task:
- Primary CTA:
- Constraints/assumptions:
## Diagnosis (pick one per major issue)
- Execution gulf (执行鸿沟): user cant find *how* to do it (entry/signifier/IA/choices)
- Evaluation gulf (评估鸿沟): user cant tell *what happened* (state/feedback/results)
- Slip (失误): goal is correct, execution goes wrong (misclick, fat-finger, wrong target)
- Mistake (错误): mental model is wrong (labels/mapping/conceptual model misleads)
## Findings (prioritized)
### P0 (blocker)
- Problem:
- Evidence:
- Diagnosis: execution gulf / evaluation gulf; slip / mistake
- Why it hurts:
- Fix (specific, implementable):
- Acceptance check:
### P1 (important)
- Problem:
- Evidence:
- Diagnosis: execution gulf / evaluation gulf; slip / mistake
- Fix:
- Acceptance check:
### P2 (polish)
- Problem:
- Diagnosis: execution gulf / evaluation gulf (optional)
- Fix:
## Quick wins (optional)
- 3 small changes that noticeably improve clarity or polish.
## Checklist to verify (copy/paste)
- Task clarity: primary CTA obvious and singular
- IA: groups and headings match mental model
- Feedback: loading/empty/error/success states present and helpful
- Consistency: components and wording stable across screens
- Affordance: clickable elements look clickable; icon-only is rare
- Errors: prevention + recovery + actionable messages
- Cognitive load: defaults and progressive disclosure reduce thinking
- CRAP: hierarchy, alignment, spacing, grouping feel intentional
- Modern minimal: restrained color, spacious layout, minimal copy
- Icons: no emoji; consistent set; labels where ambiguity exists