Skip to content
descobrindo-odoo-estrutura logo

Descobrindo Odoo Estrutura

descobrindo-odoo-estrutura

Descobre campos e estrutura de qualquer modelo do Odoo. Lista campos de tabela, busca campo por nome, inspeciona registro, faz consulta generica. Use quando: nao conhecer um modelo Odoo, precisar descobrir nome de campo, explorar estrutura de tabela, consulta em modelo nao mapeado.

SKILL.md

Full skill instructions

Descobrindo Odoo Estrutura

Skill para descoberta de campos e estrutura de modelos do Odoo.

QUANDO USAR: Quando o Agent nao conhecer um modelo/​campo especifico do Odoo e precisar descobrir a estrutura para enriquecer a resposta ao usuario.

Casos de Uso

  1. Usuario pergunta sobre dado que nao esta mapeado

    • Agent usa esta skill para descobrir campos
    • Retorna informacao enriquecida ao usuario
  2. Implementar nova consulta

    • Descobrir estrutura do modelo
    • Mapear campos relevantes
    • Documentar em rastreando-odoo (references/​relacionamentos.md)
  3. Debug de integracoes

    • Inspecionar registro especifico
    • Verificar valores de campos

Script Disponivel

descobrindo.py

source .venv/​bin/​activate && \
python .claude/​skills/​descobrindo-odoo-estrutura/​scripts/​descobrindo.py [opcoes]

Operacoes Disponiveis

OperacaoFlagDescricaoExemplo
Listar campos--listar-camposLista todos os campos do modelo--modelo res.partner --listar-campos
Buscar campo--buscar-campoBusca campo por nome/​descricao--modelo res.partner --buscar-campo cnpj
Inspecionar--inspecionarMostra todos os campos de um registro--modelo res.partner --inspecionar 123
Consulta generica--filtroConsulta com filtro JSON--modelo res.partner --filtro '[["name","ilike","teste"]]'

Parametros

ParametroObrigatorioDescricao
--modeloSimNome do modelo Odoo (ex: res.partner, account.move)
--listar-camposNaoLista todos os campos do modelo
--buscar-campoNaoTermo para buscar nos nomes/​descricoes dos campos
--inspecionarNaoID do registro para inspecionar
--filtroNaoFiltro em formato JSON
--camposNaoCampos a retornar (JSON), usado com --filtro
--limitNaoLimite de resultados (padrao: 10)
--jsonNaoSaida em formato JSON

Exemplos de Uso

Descobrir campos de um modelo

python .../​descobrindo.py --modelo l10n_br_ciel_it_account.dfe --listar-campos

Buscar campo especifico

python .../​descobrindo.py --modelo res.partner --buscar-campo cnpj

Inspecionar registro

python .../​descobrindo.py --modelo res.partner --inspecionar 123

Consulta generica com filtro

python .../​descobrindo.py \
  --modelo res.partner \
  --filtro '[["vat","ilike","93209765"]]' \
  --campos '["id","name","vat"]' \
  --limit 5

Cenarios Praticos de Descoberta

Cenario 1: Usuario pergunta sobre campo desconhecido

Situacao: "Qual o campo que guarda o codigo de barras do produto?"

# Passo 1: Buscar campos relacionados a "barcode" no modelo product.product
source .venv/​bin/​activate && \
python .claude/​skills/​descobrindo-odoo-estrutura/​scripts/​descobrindo.py \
  --modelo product.product \
  --buscar-campo barcode

# Resultado esperado: Lista campos como barcode, barcode_ids, etc.

Acao apos descoberta: Documentar no CLAUDE.md ou references/​MODELOS_CAMPOS.md se for campo frequentemente usado.


Cenario 2: Debug de campo com valor inesperado

Situacao: "Qual o valor do campo X no registro Y?"

NOTA: Para RASTREAR documentos (NF, PO, SO), use a skill rastreando-odoo em vez desta.

# Inspecionar TODOS os campos de um registro especifico
source .venv/​bin/​activate && \
python .claude/​skills/​descobrindo-odoo-estrutura/​scripts/​descobrindo.py \
  --modelo res.partner \
  --inspecionar 12345

Resultado: Ver todos os valores de campos do registro para debug.


Cenario 3: Preparar nova integracao

Situacao: "Preciso criar integracao com modelo stock.picking (movimentacao de estoque)"

# Passo 1: Listar TODOS os campos do modelo
source .venv/​bin/​activate && \
python .claude/​skills/​descobrindo-odoo-estrutura/​scripts/​descobrindo.py \
  --modelo stock.picking \
  --listar-campos \
  --json > /​tmp/​stock_picking_campos.json

# Passo 2: Buscar campos especificos de interesse
python .claude/​skills/​descobrindo-odoo-estrutura/​scripts/​descobrindo.py \
  --modelo stock.picking \
  --buscar-campo partner

python .claude/​skills/​descobrindo-odoo-estrutura/​scripts/​descobrindo.py \
  --modelo stock.picking \
  --buscar-campo origin

# Passo 3: Pegar um registro de exemplo para entender estrutura
python .claude/​skills/​descobrindo-odoo-estrutura/​scripts/​descobrindo.py \
  --modelo stock.picking \
  --filtro '[["state","=","done"]]' \
  --limit 1 \
  --inspecionar

Proximo passo: Usar skill integracao-odoo para criar o Service com os campos descobertos.

Modelos Conhecidos (Referencia)

ModeloDescricaoSkill Relacionada
l10n_br_ciel_it_account.dfeDocumentos Fiscaisrastreando-odoo
l10n_br_ciel_it_account.dfe.lineLinhas dos DFErastreando-odoo
res.partnerParceiros (clientes, fornecedores)rastreando-odoo
account.moveFaturas/​Lancamentosrastreando-odoo
account.move.lineLinhas de faturarastreando-odoo
purchase.orderPedidos de comprarastreando-odoo
sale.orderPedidos de vendarastreando-odoo
product.productProdutos-

Fluxo de Trabalho

Usuario pergunta sobre dado desconhecido
        │
        ▼
Agent verifica: modelo/​campo conhecido?
        │
        ├── SIM → Usa rastreando-odoo para consultar fluxos
        │
        └── NAO → Usa esta skill para descobrir
                    │
                    ▼
              descobrindo.py --modelo X --listar-campos
                    │
                    ▼
              Retorna informacao ao usuario

Relacionado

SkillUso
rastreando-odooConsultas e rastreamento de fluxos documentais (NF, PO, SO, titulos)
integracao-odooDesenvolvimento de novas integracoes
gerindo-expedicaoConsultas de carteira, separacoes e estoque

More skills from majiayu000

xiaohongshu logo
majiayu000/claude-arsenal

xiaohongshu

xiaohongshu

286 148
View
agent-task-conductor logo
majiayu000/claude-skill-registry

agent-task-conductor

Conduct multi-agent task orchestration and workflow coordination.

663 1
View
conductor-setup logo
majiayu000/claude-skill-registry

conductor-setup

Initialize project with Conductor artifacts (product definition,

663 1
View
animation-designer logo
majiayu000/claude-skill-registry

animation-designer

Expert in web animations, transitions, and motion design using Framer Motion and CSS

663 1
View
diagramming logo
majiayu000/claude-skill-registry

diagramming

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...

663 1
View
h3-pg logo
majiayu000/claude-skill-registry-data

h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

23 1
View
conductor-development logo
majiayu000/claude-skill-registry

conductor-development

Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...

663 1
View
conductor-status logo
majiayu000/claude-skill-registry

conductor-status

Display project status, active tracks, and next actions

663 1
View
dockerization logo
majiayu000/claude-skill-registry

dockerization

Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.

663 1
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View