用途:在 quick-math-swift 的界面(如 home、game、reward)改动后进行快速、确定性的 UI 质量检查,用于对间距、对齐、尺寸一致性、截断风险与配色协调做快速迭代。它不做主观通过/不通过判断,而是给出可测量、可操作的反馈,供代理修补 SwiftUI 代码后重跑。
前提:quick-math-swift 仓库存在且可构建;ui-percept 仓库位于 /Users/vabole/repos/ui-percept 或通过 --ui-percept-dir 指定;具有 iOS 模拟器与 xcodebuild 用于截图捕获。
使用方式:在 quick-math 根目录运行脚本,例如 bash .apple-skills/skills/ui-percept-rapid-feedback/scripts/run-feedback.sh --mode improve --screens game。随后按顺序查看 .ui-captures/ui-percept-skill/<run-name>/ 下的 feedback-overview.json、codex-jury-prompt.md、codex-decision-log.md、feedback-report.md,仅在深入排查时看 feedback-report.json。修复优先级为:blocker 与 major 级 lint 问题、报告摘要中重复出现的规则簇、signals.json 中的首要建议。可切换 --mode build、用 --screens home,game,reward 选择多屏、用 --skip-capture 复用既有截图、用 --tree/--screenshot/--screen-name/--run-name 直接分析归档产物。归档可用 archive-round.sh,如 --phase before/after、--archive-stage、--archive-user、--git-hash、--no-history-commit。
限制与说明:该技能依赖 references/high-bar-rules.yaml 提高视觉标准;反馈基于证据(元素 ID、测量值与可重复信号);遵循上下文清洁规则,先加载 feedback-overview.json,只在修复具体问题时打开对应单屏明细;主观 UX/美学评审参考 references/jury-review-mode.md,轮次历史与提交纪律参考 references/round-commit-workflow.md。