feat(dev): 新增组件样式与表单辅助 Skill

This commit is contained in:
zhiye.sun
2026-08-25 17:16:03 +08:00
parent da5678f260
commit dec3855ce6
27 changed files with 335 additions and 14 deletions
@@ -0,0 +1,16 @@
# 表单布局规则
## 结构
- 按用户任务和信息语义分组,避免只按后端对象机械排列。
- 标签、控件、提示和错误信息保持可关联且可读。
- 列数和字段跨度由容器宽度、内容长度和目标设备决定,不采用固定通用值。
- 条件字段应有稳定的布局位置,并明确隐藏、禁用、清空和保留策略由谁决定。
- 动态必填只呈现已确认的业务规则,不从界面结构反推规则。
- 操作区的位置、主次关系和滚动行为应与项目现有模式一致。
## 状态
- 编辑、只读、禁用、加载、空值和错误状态均应可辨识。
- 只读展示应保留字段语义,不能只依赖颜色表达状态。
- 小视口下优先保持阅读和操作顺序,处理标签换行、控件溢出和操作区遮挡。
@@ -0,0 +1,12 @@
# 表单评审清单
- 字段分组和顺序是否符合用户完成任务的流程。
- 标签是否与控件程序化关联,必填含义是否可感知。
- 键盘能否按合理顺序访问控件和操作。
- 焦点、错误、禁用、只读和加载状态是否清晰。
- 错误信息是否靠近相关字段,并能在提交失败后定位。
- 条件字段切换是否造成焦点丢失、布局跳动或隐藏错误残留。
- 小视口、缩放和长文本下是否溢出或遮挡。
- 组件契约是否有项目源码、类型、测试或对应版本官方文档作为证据。
- 接口、字典、回填和业务校验是否被明确标为外部输入,而非凭空补全。
- 未执行构建、浏览器或辅助技术检查时,是否如实标注验证边界。