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 生成的验证方法为模板基础，复杂业务场景需人工补充，存在因遗漏扩展而导致验证失效的风险。

FOSMVVM Fields Generator 综合评估

核心用法

FOSMVVM Fields Generator 是一个专为 Swift 开发者设计的纯文档型代码生成技能。它遵循 FOSMVVM 架构模式，帮助开发者在项目中快速生成完整的 Form Specification（表单规格），包括 Fields 协议、FormField 定义、验证方法以及配套的本地化字符串文件（YAML）。其核心理念是"定义一次，处处使用"（defined once, used everywhere），生成的同一套字段协议可同时被 Request Body、ViewModel 和 DataModel 所采纳，从而确保客户端与服务端拥有一致的验证规则和共享的本地化资源，极大减少了重复代码和潜在的不一致问题。

显著优点

该技能最突出的优势在于其高度自动化和架构一致性。它并非简单的代码片段输出，而是从对话上下文中智能识别表单目的（创建、编辑、搜索等）和实体关系，并严格遵循命名约定生成包含占位符的、可直接套用的协议、结构体和 YAML 文件模板。其次，它深度集成了 FOSMVVM 生态，与 ViewModel、Fluent DataModel 生成器联动，形成的 Form Specification 是类型安全、可验证且支持 Codable 和 Sendable 的。此外，作为纯文档型技能，它零依赖、零外部 API 调用，对项目环境没有任何侵入性。

潜在缺点或局限性

首先，该技能严格绑定于 FOSMVVM 这一特定 Swift 架构，对于不使用该框架或使用 UIKit/SwiftUI 原生方案的项目，其生成的代码模板和模式可能无法直接迁移。其次，它依赖 Agent 从对话上下文中提取需求，如果前期沟通不充分或需求描述模糊，生成的字段定义和约束可能与预期有偏差，需要人工二次调整。再者，生成的 YAML 本地化资源结构较为特定，在需要对接大型翻译管理系统（TMS）时可能需要额外适配。此外，该技能未声明显式开源许可证，虽不影响使用，但对于计划将其作为依赖项纳入商业项目的团队，可能存在合规性上的不确定性。

适合的目标群体

此技能非常适合已采用或计划采用 FOSMVVM 架构进行 iOS/macOS 应用开发的 Swift 团队。对于需要快速定义大量表单（如复杂设置页、多步骤创建流程、后台管理系统）的开发者，它能极大提升效率。它也适合那些追求客户端与服务端验证逻辑高度统一的团队，以及重视通过代码生成来减少手写样板代码和人力错误的项目。对于初学者，它同样是一个学习 FOSMVVM 命名约定和架构模式的良好模板参考。

使用风险

由于该技能是纯文本生成模板，本身不执行任何代码，因此使用风险极低。主要风险集中于生成后的人工使用阶段：用户需确保占位符被正确替换为实际项目名称，否则会导致编译错误。生成的验证逻辑（如范围常量）需开发者确认是否符合具体业务需求。此外，任何从外部上下文生成的代码都可能存在注入风险，但此技能是为开发者生成辅助代码，最终代码会进入项目且接受人工审查，因此风险完全可控。在安全认证中，该技能获得了S级评级和T2来源可信度，无任何安全发现，可放心使用。