메뉴
Implementa alteracoes em codigo Python usando governanca base, convencoes de projeto e validacao proporcional. Use quando a tarefa exigir adicionar, corrigir, refatorar ou validar codigo Python. Nao use para tarefas sem codigo Python.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | python-implementation |
| version | 1.0.0 |
| description | Implementa alteracoes em codigo Python usando governanca base, convencoes de projeto e validacao proporcional. Use quando a tarefa exigir adicionar, corrigir, refatorar ou validar codigo Python. Nao use para tarefas sem codigo Python. |
Etapa 1: Carregar base obrigatoria
AGENTS.md foi cumprido.references/architecture.md.pyproject.toml, setup.py ou requirements.txt para identificar dependencias e versao de Python.bash .agents/skills/agent-governance/scripts/detect-toolchain.sh para descobrir comandos de fmt, test e lint.Patterns frequentes (inline — evitar carregar patterns.md para estes)
Depends(). Depender de Protocol ou ABC em fronteiras de IO.dataclass ou attrs para value objects e DTOs. Usar frozen=True para imutabilidade. Usar __post_init__ para invariantes.Indice de referencias (consultar antes de carregar — evita leitura desnecessaria)
| Arquivo | Descricao |
|---|---|
references/architecture.md | Principios de arquitetura compartilhados |
references/conventions.md | Estrutura de projeto, organizacao de modulos, padroes de importacao |
references/testing.md | Pytest fixtures, parametrize, cobertura |
references/api.md | FastAPI/Flask handlers, middlewares, DTOs, validacao |
references/patterns.md | Strategy, composicao, organizacao de modulos |
references/concurrency.md | Asyncio, threading, multiprocessing, event loop |
references/resilience.md | Retries, circuit breakers, timeouts, health checks |
references/build.md | Dockerfile, CI, packaging, gerenciamento de dependencias |
references/graceful-lifecycle.md | Shutdown gracioso, SIGTERM/SIGINT, asyncio cleanup |
references/configuration.md | Pydantic settings, variaveis de ambiente, inicializacao |
references/persistence.md | SQLAlchemy repositories, transactions, migrations |
references/observability.md | Logging, tracing, metricas |
references/security.md | Autenticacao, autorizacao, validacao, rate limiting, CORS |
references/messaging.md | Producao/consumo de mensagens, eventos, filas, idempotencia |
references/examples-domain-flow.md | Esqueleto end-to-end com dataclass/pytest |
references/examples-testing.md | Fixtures, parametrize, schema validation |
references/examples-infrastructure.md | Paginacao, API versioning |
Etapa 2: Selecionar apenas o contexto necessario
references/conventions.md quando a tarefa envolver estrutura de projeto, organizacao de modulos ou padroes de importacao.references/testing.md quando a tarefa envolver estrategia de testes, fixtures ou cobertura.references/api.md quando a tarefa envolver handlers HTTP, middlewares, DTOs, validacao de request ou serializacao.references/patterns.md somente quando a tarefa envolver strategy, composicao vs heranca ou organizacao de modulos nao cobertos inline. DI, Repository e Dataclasses ja estao definidos acima.references/concurrency.md quando a tarefa envolver asyncio, threading, multiprocessing, controle de concorrencia ou paralelismo.references/resilience.md quando a tarefa envolver retries, circuit breakers, timeouts em chamadas externas, fallbacks ou health checks.references/build.md quando a tarefa envolver Dockerfile, pipeline de CI, packaging, gerenciamento de dependencias ou distribuicao.references/examples-domain-flow.md quando a tarefa precisar de esqueleto concreto de fluxo end-to-end. Para tarefas menores, usar o esqueleto inline Entity/dataclass -> UseCase(deps) -> Router(use_case) -> test.references/examples-testing.md quando a tarefa precisar de exemplos de fixtures, parametrize ou validacao de schemas.references/examples-infrastructure.md quando a tarefa precisar de exemplo de graceful shutdown, paginacao cursor-based ou versionamento de API.references/graceful-lifecycle.md quando a tarefa envolver shutdown gracioso, signal handling (SIGTERM/SIGINT), drain de conexoes, cleanup de asyncio tasks ou encerramento de workers.references/configuration.md quando a tarefa envolver carregamento de configuracao, variaveis de ambiente, pydantic-settings ou inicializacao de dependencias.../agent-governance/references/error-handling.md quando a tarefa criar, propagar, encapsular ou apresentar erros.references/persistence.md quando a tarefa envolver repositories, transactions, migrations, queries ou connection management.references/observability.md quando a tarefa envolver logging, tracing, metricas ou health checks.references/security.md quando a tarefa envolver autenticacao, autorizacao, validacao de input, rate limiting, CORS ou tratamento de segredos.references/messaging.md quando a tarefa envolver producao ou consumo de mensagens, eventos, filas, topicos ou idempotencia de consumidores.Economia de contexto Se mais de 4 referencias forem necessarias para a mesma tarefa, priorizar as 3 mais criticas para o escopo da mudanca e registrar as demais como contexto nao carregado. Carregar referencias adicionais apenas se a implementacao revelar necessidade concreta.
Etapa 3: Modelar a alteracao
Etapa 4: Implementar
Etapa 5: Validar
.agents/skills/agent-governance/SKILL.md.ruff para lint e format quando disponivel; caso contrario, black + flake8 ou o toolchain do projeto.Orquestra regras de governanca, DDD, tratamento de erros, seguranca e testes para tarefas com agentes de IA. Use quando a tarefa exigir aplicar padroes obrigatorios antes de analisar, editar ou validar codigo. Nao use para tarefas casuais sem alteracao de codigo nem para substituir skills especificas de linguagem.
Analisa a arquitetura de um projeto (monolito, monolito modular, monorepo, microservico), detecta stack e ferramentas de IA instaladas, e gera arquivos de governanca (CLAUDE.md, AGENTS.md, GEMINI.md, etc.) personalizados. Use quando precisar configurar ou atualizar a governanca orientada a IA em um projeto existente. Nao use para criar codigo de aplicacao ou alterar logica de negocio.
Corrige bugs pela causa raiz com testes de regressao obrigatorios e evidencia de validacao. Use quando o usuario pedir para corrigir bugs ou referenciar bugs.md, especialmente a partir de achados emitidos pela skill review. Nao use para review ou auditoria sem alteracao, nem para refatoracao sem defeito confirmado.
Executa uma tarefa de implementação aprovada por meio de codificação, validação, revisão e captura de evidências. Use quando um arquivo de tarefa estiver pronto para implementação e fechamento com testes, lint e evidência de revisão. Não use para planejamento, refatorações amplas sem tarefa ou exploração especulativa de código.
Implementa alteracoes em codigo Go usando governanca base, arquitetura, estilo, testes e padroes recorrentes. Use quando a tarefa exigir adicionar, corrigir, refatorar ou validar codigo Go, incluindo interfaces, generics, concorrencia e validacao da stack. Nao use para tarefas sem codigo Go, documentacao geral ou triagem sem alteracao.
Implementa alteracoes em codigo Node/TypeScript usando governanca base, convencoes de projeto e validacao proporcional. Use quando a tarefa exigir adicionar, corrigir, refatorar ou validar codigo Node.js ou TypeScript. Nao use para tarefas sem codigo Node/TypeScript.