用途:为功能模块搭建可配置的本地开发专用测试数据种子(seeder),默认仅在本地/开发环境启用,通过调用真实用户或 QC 会用的公开入口应用命令自动播种各功能的正常路径场景,实现自动化主用例自测,而非直接写数据库。
主要能力:先发现项目既有种子约定(基类、环境开关键、次数配置键、注册方式)并严格匹配;次数可配置,未配置时取小默认值,为 0 则不执行;同一机制兼顾自测主用例与扩充数据量(模拟多用户、性能测试、首次初始化);幂等,已播种不重复;可重启续跑,从已有数量循环到目标数量;每次迭代使用独立 DI 作用域;只播种应用本身可产生的可达状态,并带合理相对时间戳。
使用方式:默认 Generate 模式,按 Phase 0 判定任务类型(新建/增强/修复),依次执行发现约定、校验开发配置键、分析功能范围与应用命令、查找或创建 seeder、实现(环境门禁优先→配置次数→幂等→重启安全循环→作用域 DI)、按通用规则校验、以 --mode=review 自审、再经全新代码评审与 $changes-review 收尾。--mode=review 为只读约定审计,按通用规则与项目约定逐条给出 file:line 的 PASS/FAIL,不修改代码,确认缺陷回退到 Generate 修复。
适用场景:本地开发或首次初始化时自动准备功能测试数据,模拟 QC 手工验证主流程,并为性能测试与真实初始化提供数据量。
限制:仅限本地/开发环境,禁止用于生产;不得直接写库或复制命令逻辑;次数不得硬编码;若必需步骤或工具在当前环境无法运行,应停止并询问用户;具体项目路径、命令与配置键需按项目实际约定确定,资料未提供具体值。