fosmvvm-fields-generator

核心用法

fosmvvm-fields-generator 是 FOSMVVM 架构体系中的表单规范生成工具，采用"定义一次，处处使用"的设计理念。开发者通过该 Skill 生成 {Name}Fields 协议，该协议同时被 HTTP 请求体、ViewModel 表单渲染层和持久化模型实现，确保验证规则、本地化字符串和字段定义在三层架构中完全一致。

使用流程极为简洁：通过 /fosmvvm-fields-generator 调用后，Skill 自动分析对话上下文中的表单需求（创建、编辑、筛选等场景），识别字段类型、约束条件和实体关系，最终生成三件套文件：协议定义文件（含 FormField 配置与验证方法）、本地化消息结构体、以及 YAML 多语言资源文件。

显著优点

架构一致性是该 Skill 的核心价值。传统开发中，前端表单验证、API 参数校验、数据库约束往往分散维护，极易出现规则不一致。FOSMVVM 通过协议继承强制统一：同一套 ValidatableModel 实现被 ServerRequestBody、、ViewModel、、Model 同时采纳，任何规则变更自动同步至全链路。

本地化工程化设计同样出色。字段标题、占位符、错误提示全部通过 @LocalizedString 宏管理，YAML 文件作为唯一翻译源，支持多语言无缝扩展。相比硬编码字符串，这种声明式方案大幅降低了国际化维护成本。

开发体验优化体现在丰富的输入语义支持。从 .emailAddress 的键盘适配与自动填充，到 .password 的安全输入模式，再到 .date 的日期选择器集成，FormInputType 枚举覆盖了 iOS/macOS 平台的原生交互范式，减少开发者自行处理平台细节的负担。

潜在缺点与局限性

生态锁定是首要考量。该 Skill 深度绑定 FOSMVVM 架构体系，生成的代码依赖 FOSFoundation、FOSMVVM 等特定框架，迁移至其他技术栈成本极高。对于未采用 FOS 系列工具链的项目，直接适用性有限。

学习曲线陡峭。Skill 文档假设用户已熟悉 Swift 协议导向编程、属性包装器（Property Wrapper）和 YAML 本地化机制。新手开发者需要额外投入理解 @FieldValidationModel、、LocalizableString` 等自定义宏的工作原理。

灵活性约束体现在验证规则的预设模式上。虽然覆盖了必填、长度范围、数值范围、日期范围等常见场景，但复杂业务规则（如跨字段依赖验证、异步服务端校验）需要开发者手动扩展验证方法，模板生成部分无法完全覆盖。

适合的目标群体

该 Skill 最适合以下场景：采用 Swift 全栈开发（SwiftUI/Vapor 组合）的团队；需要严格保证客户端与服务端验证一致性的金融、医疗等合规敏感领域；以及已有 FOSMVVM 架构基础、希望标准化表单开发流程的中大型项目。对于快速原型开发或技术栈未定的探索性项目，建议评估架构锁定成本后再做决策。

使用风险

运行时依赖风险：生成的代码依赖 FOS 系列框架的版本兼容性，框架升级可能引入破坏性变更，需关注版本锁定策略。

本地化同步风险：YAML 文件与 Swift 结构体通过宏生成关联，手动修改一方而未同步更新会导致编译期或运行期错误。

验证逻辑遗漏：Skill 生成的验证方法为模板基础，复杂业务场景需人工补充，存在因遗漏扩展而导致验证失效的风险。