SuperAPI AI 工具集

layout-check

编程与开发

查看项目

更新于 10-16 09:54

技能介绍

用途:核查 React Native 视觉布局是否符合官方 Flexbox 与样式文档,定位元素位置、尺寸、间距与对齐问题,并给出修复建议。

主要能力与流程:

  1. 捕获与分析:派发子代理(general-purpose、haiku)运行 ${CLAUDE_SKILL_DIR}/../ios-sim/scripts/capture.sh view 截图,并运行 ${CLAUDE_SKILL_DIR}/../ios-sim/scripts/ui.sh describe-all 解析无障碍树;若失败(如未安装 AXe)则仅凭截图估算位置,并在报告中注明。子代理返回元素位置、间距分析、潜在问题(溢出、零尺寸、错位、重叠、文字截断、被挤出屏幕)。截图与无障碍树只在子代理中处理,不进入主上下文。
  2. 计算样式(可选):先运行 ${CLAUDE_SKILL_DIR}/../_shared/scripts/metro.sh status,退出码为 1 则跳过。Metro 运行时用 ${CLAUDE_SKILL_DIR}/../_shared/scripts/cdp-bridge.js eval 读取 React fiber 树中 flexDirection、justifyContent、alignItems、flex、alignSelf、flexWrap、backgroundColor、borderWidth、borderColor、borderRadius 等样式;需遍历 hook.renderers 获取渲染器 ID,不要硬编码。
  3. 查文档:在主上下文对 ${CLAUDE_SKILL_DIR}/../../refs/react-native-docs/ 检索,重点文件含 flexbox.md、style.md、layout-props.md、dimensions.md。
  4. 诊断与建议:结合子代理发现与文档定位根因,输出视觉评估、疑似问题、具体修改。

常见问题映射:溢出查 overflow、flex;不换行查 flexWrap;显式尺寸被覆盖查 flex、flexBasis;绝对定位错位查 position 与父容器尺寸;零尺寸查 width、height、flex;间距不均查 gap、justifyContent;文字截断查 flexShrink、numberOfLines;居中错误区分 justifyContent 与 alignItems。

限制与注意:需 iOS 模拟器与相关脚本;无障碍树依赖 AXe;Metro 未运行或新架构渲染器 ID 变化会影响取样式;RN 默认 flexDirection 为 column、alignItems 为 stretch、position 为 relative,flex: 1 等价于 flexGrow 1、flexShrink 1、flexBasis 0,overflow 在 Android 默认 hidden、iOS 默认 visible,百分比尺寸需父级在该轴有确定尺寸。版本等事实资料未提供。