Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

odoo-guidelines

/odoo-guidelines

Pilnuje zasad kodu dodatków Odoo: strukturę modułu, manifest, ORM, widoki XML, raporty QWeb, uprawnienia i testy.

Licencja
LGPL
Ostatnia zmiana repozytorium
07.11.2026

Ocena i bezpieczeństwo

81/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść16 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
15
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 07.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

LGPL, otwarta.

Co robi i kiedy

Pilnuje zasad kodu dodatków Odoo: strukturę modułu, manifest, ORM, widoki XML, raporty QWeb, uprawnienia i testy.

Oryginalny opis (EN)

House rules for Odoo addon code: module structure, manifest, Python/ORM, fields, controllers, XML views and data, QWeb reports, access rights and record rules, performance, tests. Use when writing or reviewing any file in an Odoo addon outside static/ (for the JavaScript, Owl templates and SCSS under static/, see odoo-web-guidelines).

Jak działa

SKILL.md bez nagłówków drugiego poziomu · 37 linii, 359 słów

Podgląd SKILL.md
---
name: odoo-guidelines
description: >-
  House rules for Odoo addon code: module structure, manifest, Python/ORM,
  fields, controllers, XML views and data, QWeb reports, access rights and
  record rules, performance, tests. Use when writing or reviewing any file in
  an Odoo addon outside static/ (for the JavaScript, Owl templates and SCSS
  under static/, see odoo-web-guidelines).
---

# Odoo addon guidelines

House rules for code in Odoo addons (`addons/*` and `odoo/addons/*`).
Everything an addon ships under `static/` has its own skill:
`odoo-web-guidelines`.

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 files you are
touching instead of loading whole files.

| Guideline | Read it when |
| --- | --- |
| [Module structure and file naming](guidelines/module_structure.md#module-structure-and-file-naming) | creating or moving files in an addon, or adding a module |
| [Manifest](guidelines/manifest.md#manifest) | touching `__manifest__.py` |
| [Imports](guidelines/python.md#imports) | writing Python anywhere in an addon |
| [Naming and model layout](guidelines/python.md#naming-and-model-layout) | naming a model, field, method or variable; laying out a model class |
| [Translate only static literals](guidelines/python.md#translate-only-static-literals) | user-facing strings in Python |
| [Recordsets, domains and context](guidelines/orm.md#recordsets-domains-and-context) | reading records, building domains, passing context |
| [Computes, onchange and constraints](guidelines/orm.md#computes-onchange-and-constraints) | computes, onchange, constraints, indexes, `create` overrides |
| [End `_order` on a unique field](guidelines/orm.md#end-_order-on-a-unique-field) | setting a model's `_order`, or fixing records that come back in a random order |
| [Methods and extension points](guidelines/orm.md#methods-and-extension-points) | adding a model method, or one another module will override |
| [Transactions and exceptions](guidelines/orm.md#transactions-and-exceptions) | cursors, commits, savepoints, `try`/`except` |
| [Fields](guidelines/fields.md#fields) | declaring or modifying field definitions |
| [Controllers](guidelines/controllers.md#controllers) | touching `controllers/` or `@route` |
| [Views, actions and data records](guidelines/xml.md#views-actions-and-data-records) | touching `views/`, `data/`, or any XML records |
| [Anchor view inheritance on names, never on position](guidelines/xml.md#anchor-view-inheritance-on-names-never-on-position) | extending or overriding an existing view |
| [QWeb PDF reports](guidelines/reports.md#qweb-pdf-reports) | report templates or `_get_report_values` |
| [Access rights](guidelines/security.md#access-rights) | touching `security/` (`ir.access.csv`, groups) |
| [Batch ORM calls](guidelines/performance.md#batch-orm-calls) | ORM calls (`create`/`search*`/aggregates) inside a loop |
| [Performance conventions](guidelines/performance.md#performance-conventions) | code that loops over records or filters query results |
| [Tests](guidelines/tests.md#tests) | touching `tests/` |
| [Plain ASCII punctuation in comments and messages](guidelines/comments.md#plain-ascii-punctuation-in-comments-and-messages) | writing a comment, a docstring, a user-facing string, or a commit message |
| [Changes in a stable version](guidelines/stable.md#changes-in-a-stable-version) | any change targeting a released branch rather than master |

To add or restructure a guideline, follow [AUTHORING.md](AUTHORING.md).
Pliki w paczce (15)
  • AUTHORING.md 2 KB
  • SKILL.md 4 KB
  • guidelines/comments.md 2 KB
  • guidelines/controllers.md 1 KB
  • guidelines/fields.md 2 KB
  • guidelines/manifest.md 1 KB
  • guidelines/module_structure.md 1 KB
  • guidelines/orm.md 4 KB
  • guidelines/performance.md 2 KB
  • guidelines/python.md 4 KB
  • guidelines/reports.md 1 KB
  • guidelines/security.md 1 KB
  • guidelines/stable.md 2 KB
  • guidelines/tests.md 2 KB
  • guidelines/xml.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie odoo-guidelines.

Migawka bazy z 13.11.2026 · wersja paczki 95ef99ea1f9d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 81odoo-web-guidelines
    Pilnuje zasad pisania kodu webowego dodatków Odoo: JavaScript, szablony Owl i SCSS w katalogu static.
  • 95odoo-18
    Pomaga w rozwoju modułów Odoo 18: modele i ORM, widoki XML, raporty QWeb, uprawnienia, migracje i testy.
  • 95odoo-17
    Zawiera materiały referencyjne do programowania w Odoo 17: modele Pythona i ORM, widoki XML, klient OWL i JS, raporty QWeb, bezpieczeństwo, zadania cron, migracje, testy, i18n i wydajność.
  • 100odoo-specialist
    Odpowiada na pytania o Odoo w roli persony Fabiena Pinckaersa: rozwój modułów, ORM, widoki XML, QWeb, bezpieczeństwo, multi-company, księgowość, produkcję i wdrożenie na Odoo.sh.
  • 90odoo-review
    Przegląda kod dodatków Odoo według zasad domu, sprawdzając każdy zmieniony plik względem wytycznych i wymagań bezpieczeństwa.
  • 90odoo_web_agent
    Wspiera pracę nad widokami XML, akcjami, raportami QWeb i komponentami OWL w Odoo od 17 do 20.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.