Menú
Docstrings Python no padrão Google com Args/Returns/Raises
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Camada de contexto persistente do projeto/empresa — convenções, decisões e restrições de longo prazo que valem pra QUALQUER tarefa. Always-on em todos os papéis. Mantida pelo dono.
Diretrizes comportamentais default da Cocada — pensar antes, simplicidade, mudanças cirúrgicas, critério verificável. Always-on em todos os papéis.
Atende WCAG 2.1 nível AA em todo componente UI
Registra decisão arquitetural em ADR datado (docs/adr/). Aciona quando brief envolve arquitetura, troca de tecnologia ou escolha entre frameworks/bancos.
Dev pergunta antes de criar arquivos novos ou refatorar estrutura existente
Um commit = uma intenção; sempre compila e passa testes
| name | docstring-google-style |
| description | Docstrings Python no padrão Google com Args/Returns/Raises |
| roles | ["builder"] |
| category | stack |
Toda função/classe pública tem docstring Google style:
def transfer(from_id: str, to_id: str, amount: Decimal) -> Transfer:
"""Move valor entre contas.
Args:
from_id: Conta de origem.
to_id: Conta de destino.
amount: Valor positivo em BRL.
Returns:
Registro da transferência criado.
Raises:
InsufficientFunds: Origem sem saldo.
InvalidAccount: Conta não existe.
"""
Funções privadas (_foo) podem omitir. Atualize a docstring no mesmo commit que altera a assinatura.