xianyan/.windsurf/workflows/flutter-component.md

description

description
Flutter 组件开发

Flutter 组件开发工作流

用于创建符合规范的 Flutter 组件。

执行步骤

1. 创建组件文件

   • 添加标准文件头注释：创建时间、更新时间、名称、作用、上次更新内容
   • 使用 Cupertino 组件优先
   • 确保文件名使用小写加下划线

2. 定义组件接口

   • 定义必要的参数
   • 使用命名参数
   • 添加参数注释

3. 实现组件逻辑

   • 使用 StatefulWidget 处理状态
   • 实现响应式布局
   • 添加必要的空指针检查

4. 添加样式和主题

   • 使用主题色和主题样式
   • 保持设计一致性
   • 支持动态主题

5. 添加交互功能

   • 实现用户交互逻辑
   • 添加适当的反馈动画
   • 确保交互流畅

6. 添加调试支持

   • 添加调试按钮/布局（如需要）
   • 提供测试数据接口
   • 添加调试日志

7. 编写组件注释

   • 添加类注释说明作用
   • 为重要方法添加注释
   • 说明复杂逻辑

8. 测试组件

   • 测试不同屏幕尺寸
   • 测试空值情况
   • 测试边界情况

9. 更新 CHANGELOG

   • 记录组件创建
   • 说明功能变更
   • 更新版本号（如需要）