SuperAPI AI 工具集

create-engine-installer

写作与研究

查看项目

更新于 10-15 22:17

技能介绍

用途:在编写或审查 Rails engine 的安装生成器时使用,处理迁移、配置与路由挂载等安装步骤。触发词包括 install generator、engine setup、copy migrations。

主要能力与工作流(硬性门槛):按顺序执行五步,未完成第 3、4 步不得交付。1)GENERATE:在干净宿主应用上运行生成器,展示命令与终端输出(标注 Observed output),确认文件落在正确宿主路径(初始化器在 config/initializers/、迁移在 db/migrate/、路由挂载在 config/routes.rb)。2)VERIFY:用 shell 命令确认初始化器、路由、迁移文件存在。3)RERUN:第二次运行,确认不产生重复文件、路由或初始化块,展示幂等行为。4)TEST:在生成器 spec 中覆盖单次运行与重跑行为。5)DOCUMENT:列出生成内容与需手动完成的事项,含必需环境变量、回滚步骤与安装文档。

实现规则:仅在初始化器中配置,避免启动期变更;记录所有必需环境变量及回滚步骤;提供易于编辑的合理默认值。幂等守卫:所有生成动作须可多次安全运行,在创建文件与注入处加守卫,例如创建初始化器前检查 File.exist?,路由注入使用 inject_into_file 并设 force: false,避免重复插入。重跑 spec 示例:运行两次后断言 config/routes.rb 中 mount 语句只出现一次。较大安装器可将扩展守卫模式与 spec 模板抽到生成器旁的专用文件(如 lib/generators/my_engine/install/install_generator_patterns.rb),并在注释中引用。

集成:设计引擎结构时衔接 create-engine;记录安装或升级步骤时衔接 document-engine;添加生成器 spec 或 dummy 应用安装覆盖时衔接 test-engine。

限制:资料未提供具体收费、平台或效果信息。