ui-checkpoint

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

UI Checkpoint (Human-in-the-loop nhẹ)

UI 检查点（轻量人机协作）

Vì sao dùng cách này thay vì auto vision QA

为什么选择这种方式而非自动视觉QA

Việc dùng thêm một model vision để tự chấm "UI đạt >90% chuẩn design" mỗi lần build tốn thêm lệnh gọi model không cần thiết cho một solo dev đang tự review. Cách rẻ và đủ tốt hơn: chụp ảnh, hỏi 1 câu, để user (chính là bạn) quyết định trực tiếp.

使用视觉模型在每次构建时自动判定“UI符合设计标准>90%”，对于正在自行审核的独立开发者来说，属于不必要的模型调用开销。更经济且足够有效的方式是：截图、问一个问题，让用户（也就是你）直接做决定。

Quy trình

流程

Qua MCP, chụp screenshot màn hình/tính năng vừa build xong (không cần chụp toàn bộ app, chỉ màn hình liên quan đến thay đổi vừa rồi).
Hiển thị ảnh trong chat kèm đúng 1 câu hỏi dạng:

"Giao diện [tên màn hình] đã ổn chưa? (Gõ 'ok' để commit, hoặc mô tả ngắn cần chỉnh)"
Dừng lại, chờ phản hồi user - đây là điểm dừng chủ đích duy nhất trong luồng chính, không tự ý bỏ qua.

通过MCP截取刚构建完成的界面/功能截图（无需截取整个应用，仅需与本次修改相关的界面）。
在聊天中展示图片，并附带一句标准提问：

“[界面名称]的显示是否正常？（输入‘ok’进行提交，或简要描述需要调整的内容）”
暂停流程，等待用户回复——这是主流程中唯一的主动暂停点，不可跳过。

Xử lý phản hồi

回复处理

User gõ "ok"/"được"/tương đương → chuyển sang
```
git-checkpoint/SKILL.md
```
.
User mô tả điều chỉnh ngắn (ví dụ "to chữ lên", "xanh hơn", "cách xa nhau hơn") → map sang token cụ thể trong
```
design-system/SKILL.md
```
, sửa, quay lại
```
mcp-loop/SKILL.md
```
để build lại, rồi lặp lại bước UI-checkpoint này.
User nói bug logic (không phải UI, ví dụ "bấm không lưu được") → không xử lý ở đây, quay lại
```
mcp-loop
```
để debug logic, không nhầm với chỉnh UI thẩm mỹ.

用户输入“ok”/“可以”/类似表述 → 跳转至
```
git-checkpoint/SKILL.md
```
。
用户简要描述调整需求（例如“字体放大”、“颜色更蓝”、“间距加大”） → 映射到
```
design-system/SKILL.md
```
中的具体标识，进行修改，返回
```
mcp-loop/SKILL.md
```
重新构建，然后重复此UI检查点步骤。
用户反馈逻辑bug（非UI问题，例如“点击无法保存”） → 此处不处理，返回
```
mcp-loop
```
调试逻辑，请勿与UI美观调整混淆。

Tắt bước này khi cần

需要时跳过此步骤

Nếu user đã dặn trước (ví dụ trong

openspec/config.yaml

mục

rules

có ghi "auto-approve UI, không cần hỏi"), bỏ qua bước này và tự động chuyển sang

git-checkpoint

. Mặc định (chưa dặn gì) LUÔN hỏi.

如果用户预先指定（例如在

openspec/config.yaml

的

rules

项中写入“auto-approve UI, không cần hỏi”），则跳过此步骤并自动跳转至

git-checkpoint

。默认（无预先指定）情况下，始终询问。

Giới hạn phạm vi

适用范围限制

Không dùng skill này để duyệt logic nghiệp vụ hay dữ liệu - chỉ để duyệt phần nhìn (UI/UX). Logic sai thuộc về

mcp-loop

, dữ liệu sai thuộc về

schema-migration

请勿使用此技能审核业务逻辑或数据——仅用于审核视觉部分（UI/UX）。逻辑错误属于

mcp-loop

的处理范畴，数据错误属于

schema-migration

的处理范畴。