Engineering Skills

Engineering Skills é um marketplace de plugins do OpenAI Codex voltados a práticas de engenharia de software. Ele distribui workflows reutilizáveis como plugins instaláveis, sem vincular o repositório a uma única metodologia de engenharia.

Plugins

sdd

Um toolkit de Spec-Driven Development para preparar trabalhos de software antes da implementação.

Skills disponíveis:

• project-bootstrap — prepara repositórios para adotar o workflow SDD, com instruções estáveis para agentes e estrutura documental mínima.
• spec-author — transforma problemas, necessidades, funcionalidades e mudanças de software em especificações prontas para implementação.
• spec-reviewer — revisa especificações em busca de ambiguidades, lacunas, inconsistências e riscos de implementação.
• architecture-designer — transforma specifications maduras em propostas de arquitetura técnica rastreáveis e justificadas.
• api-designer — conduz discovery interativo e projeta contratos de API rastreáveis sem assumir protocolo, requisitos ou conhecimento técnico prévio.
• security-reviewer — revisa riscos e controles de segurança iterativamente, com evidências e sem assumir contexto ou mitigação.
• reliability-reviewer — revisa failure modes, resiliência e capacidade com evidências, sem presumir controles ou métricas.
• adr-author — conduz discovery de decisões arquiteturais e registra ADRs rastreáveis com o status apropriado.
• implementation-planner — transforma specifications, arquitetura e ADRs confirmados em planos de implementação incrementais e rastreáveis.
• test-designer — projeta estratégias e casos de teste rastreáveis, validando consistência entre requirements, decisões e implementação observada.
• implementation — executa planos SDD incrementalmente, modificando código com validação contínua, controle de escopo e rastreabilidade.
• code-reviewer — revisa código e diffs de forma independente, priorizando bugs, regressões e riscos reais em vez de preferências pessoais.
• implementation-verifier — verifica independentemente a aderência da implementação aos artefatos SDD e às evidências disponíveis.

Instalação

Adicione este repositório como um marketplace do Codex:

codex plugin marketplace add Waelson/engineering-skills --ref main

Instale o plugin sdd a partir do marketplace engineering-skills:

codex plugin add sdd@engineering-skills

Verifique o marketplace configurado e o plugin:

codex plugin marketplace list
codex plugin list --marketplace engineering-skills

Os comandos acima seguem a sintaxe disponibilizada pela versão atual da CLI do Codex. Após a instalação, inicie uma nova tarefa no Codex para que as novas skills sejam carregadas.

Uso

Invoque a skill explicitamente em um prompt do Codex:

Use $spec-author para criar uma especificação para um MCP Registry distribuído.

A skill cria ou atualiza uma especificação, como SPEC.md; ela não implementa o software.

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE.