Skip to content

Commit a3ce65c

Browse files
committed
feat: react component in message
1 parent 387ebe6 commit a3ce65c

2 files changed

Lines changed: 23 additions & 1 deletion

File tree

skills/use-react-intl-universal/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ At a high level:
7878
2. Explore the page and reachable interactions as thoroughly as is safe: navigation, tabs, filters, dropdowns, buttons, dialogs, tooltips, forms, and validation states.
7979
3. Watch for localized UI issues such as truncation, overflow, overlap, misalignment, untranslated text, raw ICU placeholders, raw rich tags, inconsistent terminology, or unnatural copy.
8080
4. Capture screenshots throughout the inspection.
81-
5. Produce an inspection report with two required parts: the full inspection process with screenshots, and the issues found with screenshots and reproduction steps.
81+
5. Produce an inspection report with two required parts: the full inspection process with screenshots, and the issues found with screenshots, reproduction steps, and likely root-cause classification.
8282

8383
## Core Rules
8484

skills/use-react-intl-universal/references/ui-inspection-mode.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,24 @@ Localized UI quality:
9090
- Tables, filters, tabs, menus, and dialogs remain readable.
9191
- Compact UI such as placeholders, badges, sidebars, breadcrumbs, and table cells still works.
9292

93+
## Root-Cause Classification
94+
95+
When a finding is recorded, include a likely root-cause field. Classify the issue as one of:
96+
97+
- frontend application issue: local page code, CSS/layout, component usage, routing, i18n usage, locale wiring, or message composition likely caused the problem;
98+
- backend/API issue: an API response, server-rendered data, missing localized field, malformed placeholder value, permission state, or test data likely caused the problem;
99+
- external dependency issue: a shared frontend component package, module federation remote, design-system package, third-party SDK, browser extension, or hosted asset likely caused the problem;
100+
- unknown or needs investigation: the browser evidence is not enough to assign ownership safely.
101+
102+
Do not overclaim ownership. Use "likely" language unless the browser evidence clearly proves the cause. Add a short rationale with the evidence used, such as:
103+
104+
- console error or stack trace;
105+
- network request URL, status, and relevant response shape;
106+
- visible component/module boundary if known;
107+
- whether the issue reproduces before or after data loads;
108+
- whether the same text renders correctly in another page state;
109+
- whether the defect appears inside a shared component, remote module, or third-party widget.
110+
93111
## Screenshot Requirements
94112

95113
The report must include all screenshots captured during the inspection.
@@ -166,6 +184,8 @@ For each issue, include:
166184
- actual result;
167185
- screenshot link;
168186
- likely category: language quality, truncation, overflow, overlap, misalignment, untranslated text, raw placeholder/tag, terminology inconsistency, or interaction defect;
187+
- likely root cause: frontend application issue, backend/API issue, external dependency issue, or unknown/needs investigation;
188+
- root-cause evidence: one or two concise observations supporting the classification;
169189
- suggested next step.
170190

171191
Example:
@@ -180,6 +200,8 @@ Example:
180200
- Actual: The translated label overlaps the chevron icon.
181201
- Screenshot: [004](screenshots/004-filter-overlap.png)
182202
- Category: overlap, compact UI length
203+
- Likely root cause: frontend application issue
204+
- Root-cause evidence: The API returned the expected translated label, and the overlap happens inside the page's local filter button layout after the text is rendered.
183205
- Suggested next step: Allow the button to wrap or increase the min-width for localized labels.
184206
```
185207

0 commit comments

Comments
 (0)