Agent Skills
› odoo/odoo
› odoo-web-guidelines
odoo-web-guidelines
GitHub定义Odoo插件Web框架代码规范，涵盖JavaScript、Owl模板及SCSS在static目录下的编写、审查与重构标准。提供文件组织、避免Getter及补丁等具体指南，用于统一前端开发实践。
Trigger Scenarios
编写或审查Odoo插件静态资源代码
决定新代码在static/src/中的位置
修改SCSS样式或添加资产
Install
npx skills add odoo/odoo --skill odoo-web-guidelines -g -y
SKILL.md
Frontmatter
{
"name": "odoo-web-guidelines",
"description": "House rules for the web framework code of Odoo addons: the JavaScript, Owl templates and SCSS in static\/src\/ and static\/tests\/ of any addon (community, enterprise, or custom). Use when writing, reviewing, or moving files under static\/ in an Odoo addon."
}
Odoo web guidelines
These rules apply to the web framework code an addon ships in static/src/ and
static/tests/: JavaScript, Owl templates (XML) and SCSS. They do not apply to
static/lib/, which holds vendored or library-style code, nor to the images and
static/description/ an addon ships alongside. They are house rules, not general web
development advice.
Guidelines are grouped by domain, one file per domain in guidelines/, one section per
guideline. No rule outranks another. Read the sections that match the code you are
touching instead of loading whole files.
| Guideline | Read it when |
|---|---|
| Organize files by feature | creating a file, or deciding where new code lives |
| Avoid getters | adding a computed value to a class or a component |
| Avoid patching JavaScript code | extending or overriding behaviour that already exists |
| SCSS and CSS | touching *.scss |
| Assets | adding an image, font, or library |
To add a guideline, follow AUTHORING.md.
Version History
- 5.0.0-2-addons Current 2026-09-27 17:16
