feat(dev): 新增组件样式与表单辅助 Skill
This commit is contained in:
@@ -0,0 +1,23 @@
|
||||
---
|
||||
name: form
|
||||
description: 设计或检查前端表单的分组、列布局、响应式、条件字段、只读展示、错误位置和可访问性。适用于表单结构调整与布局评审;接口设计、业务校验规则、组件契约猜测和完整页面实现不应触发。
|
||||
---
|
||||
|
||||
# 表单结构设计
|
||||
|
||||
依据当前项目的真实组件契约和既有布局模式组织表单,不虚构组件接口、业务规则或固定列数。
|
||||
|
||||
## 工作流
|
||||
|
||||
1. 检查框架版本、现有表单、布局样式、需求和目标设备。
|
||||
2. 从当前项目证据或 `component` 的查证结果取得表单组件契约。
|
||||
3. 按 [布局规则](references/layout.md) 设计字段分组、标签、列、条件区域、操作区和响应行为。
|
||||
4. 按 [评审清单](references/review.md) 检查校验呈现、键盘操作、只读状态和小视口行为。
|
||||
5. 输出结构方案、采用的证据、待确认业务规则和剩余风险;只有用户要求时才修改现有表单文件。
|
||||
|
||||
## 边界
|
||||
|
||||
- 不设计接口、字典或数据回填协议。
|
||||
- 不自行确定字段必填、条件显示或业务校验逻辑;需求不明确时列为待确认。
|
||||
- 不使用未经验证的组件、属性、事件或插槽。
|
||||
- 视觉令牌和 CSS 交给 `style`,完整业务页面实现交给前端实现 Skill。
|
||||
@@ -0,0 +1,4 @@
|
||||
interface:
|
||||
display_name: "表单设计"
|
||||
short_description: "设计和检查前端表单结构与响应布局"
|
||||
default_prompt: "使用 $form 为当前需求设计表单结构,并列出证据与待确认项。"
|
||||
@@ -0,0 +1,16 @@
|
||||
# 表单布局规则
|
||||
|
||||
## 结构
|
||||
|
||||
- 按用户任务和信息语义分组,避免只按后端对象机械排列。
|
||||
- 标签、控件、提示和错误信息保持可关联且可读。
|
||||
- 列数和字段跨度由容器宽度、内容长度和目标设备决定,不采用固定通用值。
|
||||
- 条件字段应有稳定的布局位置,并明确隐藏、禁用、清空和保留策略由谁决定。
|
||||
- 动态必填只呈现已确认的业务规则,不从界面结构反推规则。
|
||||
- 操作区的位置、主次关系和滚动行为应与项目现有模式一致。
|
||||
|
||||
## 状态
|
||||
|
||||
- 编辑、只读、禁用、加载、空值和错误状态均应可辨识。
|
||||
- 只读展示应保留字段语义,不能只依赖颜色表达状态。
|
||||
- 小视口下优先保持阅读和操作顺序,处理标签换行、控件溢出和操作区遮挡。
|
||||
@@ -0,0 +1,12 @@
|
||||
# 表单评审清单
|
||||
|
||||
- 字段分组和顺序是否符合用户完成任务的流程。
|
||||
- 标签是否与控件程序化关联,必填含义是否可感知。
|
||||
- 键盘能否按合理顺序访问控件和操作。
|
||||
- 焦点、错误、禁用、只读和加载状态是否清晰。
|
||||
- 错误信息是否靠近相关字段,并能在提交失败后定位。
|
||||
- 条件字段切换是否造成焦点丢失、布局跳动或隐藏错误残留。
|
||||
- 小视口、缩放和长文本下是否溢出或遮挡。
|
||||
- 组件契约是否有项目源码、类型、测试或对应版本官方文档作为证据。
|
||||
- 接口、字典、回填和业务校验是否被明确标为外部输入,而非凭空补全。
|
||||
- 未执行构建、浏览器或辅助技术检查时,是否如实标注验证边界。
|
||||
Reference in New Issue
Block a user