用途:该技能为 Odoo 模块开发提供遵循 OCA 规范的专家指导,覆盖模块创建、结构组织、扩展、版本迁移与质量校验,适用于 Odoo 14.0 至 19.0。
主要能力:按 OCA 模板生成合规模块结构,包含 manifest.py、README、模型、视图与安全文件;提供模块命名约定(单数形式、base_、l10n_CC_、父模块前缀等);规范 manifest 必需键、版本格式与许可证;指导模型继承与视图 xpath 扩展;提供 OpenUpgrade 迁移模式,包括字段/模型/表重命名、值映射与数据清理;提供模块校验脚本检查必需文件、manifest 完整性、OCA 署名、许可证与命名。
使用方式:创建模块运行 python scripts/init_oca_module.py my_module_name --path /path/to/addons --version 17.0;校验模块运行 python scripts/validate_module.py /path/to/module;代码质量可安装 pre-commit 并运行 pre-commit run --all-files,或使用 flake8、pylint --load-plugins=pylint_odoo。迁移时在 migrations/<版本>/ 下编写 pre-migration.py 与 post-migration.py,使用 openupgradelib 的 rename_fields、rename_models、map_values 等函数。
适用场景:新建 Odoo 模块、扩展现有核心模块、跨版本迁移模块、检查模块是否符合 OCA 约定。
限制:资料未提供具体收费、价格、平台支持范围或实际效果数据;迁移与测试需在数据库副本上进行,外部依赖需自行声明与文档化。