Files

王冕 a619938e0c Initial commit: 小羚羚小程序 Axhub Make workspace.

Include xll-miniapp prototype, PRD resources, annotation directory sync, agent skills, and cloud publishing setup.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-30 15:32:30 +08:00

5.3 KiB

Raw Blame History

UI Review 指导

用于审查 Axhub Make client 原型页面的 UI 质量、设计一致性、响应式、可访问性和核心元件表现。

审查入口

优先使用官方 Impeccable 技能的 critique 流程：

/impeccable critique <target>

<target> 应明确到原型或页面，例如：

/impeccable critique src/prototypes/beginner-guide
/impeccable critique beginner-guide/install-agent

如果用户说「UI review」「审查这个页面」「检查设计质量」「帮我挑一下 UI 问题」，按本规则约束 /impeccable critique 的产物，不另起一套审查流程。

审查依据

审查依据只允许是一个 DESIGN.md：

用户明确指定的 DESIGN.md 或主题目录下的 DESIGN.md
用户未指定时，使用项目默认设计的 DESIGN.md
如果没有用户指定或项目默认的 DESIGN.md，必须停止，要求用户提供

禁止把以下内容作为审查依据：

PRODUCT.md
theme.json
tokens.json
CSS 变量文件
截图
README 或其他说明文档

这些文件可以作为证据或实现参考，但不能替代 DESIGN.md 的规范地位。

Impeccable 使用约束

使用 /impeccable critique 时，必须在执行前附加或内化以下约束：

Use /impeccable critique as the review method, but follow Axhub rules:
1. Use only the selected DESIGN.md as the design basis.
2. Ignore PRODUCT.md and all other design files as normative criteria.
3. If no DESIGN.md is available, stop and ask for one.
4. Do not write .impeccable critique artifacts as the deliverable.
5. Produce a Markdown report, not JSON.
6. Write the result to the target prototype .spec directory.
7. Include sections in order: 总体点评, P0-P3 优先级问题, 核心元件.
8. Priorities must contain at most 5 P0-P3 findings.

如果 Impeccable 的原始流程要求 PRODUCT.md、.impeccable/critique 或额外上下文，与本规则冲突时，以本规则为准。

Markdown 模板

# UI Review

- 审查目标：src/prototypes/<prototype-id>
- 使用设计依据：src/themes/<theme-id>/DESIGN.md
- 生成时间：2026-05-22 00:00

## 总体点评

用 1-3 段总结整体设计质量、与 DESIGN.md 的一致性、主要风险和最值得保留的亮点。

## P0-P3 优先级问题

### P1 - Finding title

- 证据：说明出现位置、截图/预览观察或源码线索。
- 影响：说明对用户任务、理解、可访问性或品牌一致性的影响。
- 修复方向：给出可执行的设计或实现建议。

## 核心元件

### Hero / Header / Form / Navigation

按关键 UI 区块点评是否符合 DESIGN.md，指出保留点和调整点。

## 响应式与可访问性

记录桌面/移动端差异、键盘/语义/对比度等发现。没有明显问题时也要说明已检查。

## 证据与评估说明

- 浏览器/截图：说明是否使用。
- Scanner：说明是否使用。
- 独立评估：full 或 degraded，并说明原因。

分组要求

前三组固定且顺序不可变：

总体点评
P0-P3 优先级问题，最多 5 条
核心元件

可以追加额外分组，例如 响应式与可访问性、证据与评估说明，但必须放在前三组之后。

优先级

P0：阻断核心任务完成，或违反 DESIGN.md 中强制规则
P1：显著增加用户完成任务的难度，或造成 WCAG AA 级别可访问性问题
P2：明显体验摩擦，但存在可用绕行
P3：低影响 polish，修复后更好但不影响主要任务

不要使用 P4 或更低优先级。

子代理与独立评估

有子代理能力时，优先拆成两个独立评估：

设计评估：只看目标、DESIGN.md、截图/预览和源码
证据评估：看 scanner、响应式、可访问性和实现风险

两个评估完成前不要互相暴露结论。没有子代理时，先完成设计评估笔记，再看 scanner/证据，并在 证据与评估说明 中标记独立评估为 degraded。

当审查 3 个以上独立页面或组件时，优先按目标拆分并行审查，最后统一综合成 .spec/ui-review.md。

交付说明

最终回复至少包含：

审查目标
使用的 DESIGN.md
写入的 .spec/ui-review.md 路径
P0-P3 数量
是否使用浏览器/截图/scanner
独立评估是否完整

5.3 KiB Raw Blame History Unescape Escape