菜单
Use para auditar a conformidade da esteira SDD — roda o validador estrutural (frontmatter, links, specs) e checa o que exige julgamento (rastreabilidade AC→teste→commit, DoD, specs órfãs, docs vivas atualizadas). Reporta violações com o arquivo. Acione com /auditar.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | auditar |
| description | Use para auditar a conformidade da esteira SDD — roda o validador estrutural (frontmatter, links, specs) e checa o que exige julgamento (rastreabilidade AC→teste→commit, DoD, specs órfãs, docs vivas atualizadas). Reporta violações com o arquivo. Acione com /auditar. |
Verifica se o projeto respeita o padrão da esteira. Duas camadas: estrutural (script, determinístico) e semântica (julgamento do agente).
Rode os validadores e reporte a saída:
node scripts/audit-esteira.mjs .
node scripts/validate-mermaid.mjs .
O primeiro cobre: frontmatter presente + dialeto certo (alwaysApply nos docs; name+description
nas skills), links relativos quebrados e toda specs/NNNN-*/ com spec.md. O segundo valida os
blocos Mermaid (tipo, aspas, delimitadores). Exit ≠ 0 em qualquer um = falhou.
O script não pega tudo. Verifique também:
AC-N da spec aparece em tasks.md (coluna "Cobre AC") e tem teste?specs/ sem PR/implementação correspondente, ou paradas há tempo
(cruze com STATE.md).context-map.md refletem os termos/fronteiras atuais? ADRs cobrem
as decisões difíceis de reverter já tomadas?SPEC_DEVIATION aberto ou AC sem teste.alwaysApply: o que é base está true; o resto false com description que diz quando puxar.Liste as violações por arquivo, separando estrutural (corrigir já) de semântica (revisar). Ofereça corrigir as triviais (frontmatter, links). Não invente conformidade — relate o que achou.
Esta skill é o complemento humano/agente do gate de CI (
/setup-ciroda o mesmo script).
Use para uma SABATINA — entrevista implacável que transforma intenção difusa em entendimento compartilhado antes de construir. Caminha pela árvore de decisão UMA pergunta por vez, resolvendo dependências entre escolhas, sempre com uma resposta recomendada; explora o codebase/docs em vez de perguntar quando a resposta já existe. Ideal no gate da spec (AC testáveis / Definition of Ready) e do design (decisão difícil de reverter). Produz um resumo de entendimento que alimenta product.md/design.md/spec.md. Chamada por /nova-feature, /kickoff, /roadmap e /validar, ou acione direto com /clarificar.
Use ao iniciar OU dar continuidade a um projeto com o boilerplate SDD. Primeiro descobre o modo — greenfield (começando do zero) ou brownfield (já rodando) — e roteia. Greenfield conduz uma entrevista Lean Inception (visão, personas, MVP). Brownfield mapeia o estado atual (as-is), identifica gaps vs o padrão SDD e captura decisões históricas. Os dois caminhos passam pelo kickoff técnico nos 5 eixos (tech stack, arquitetura, infra, qualidade, observabilidade), propõem a camada agêntica do projeto (rules, subagents, skills, workflows/CI) e convergem num roadmap incremental, gerando a "constituição" do projeto. As integrações com ferramentas do time (Jira, Confluence, MCPs) são uma skill separada (/integracoes) — rode antes para insumos read-first, ou depois. Acione com /kickoff.
Use para abrir uma nova feature no padrão SDD. Decide o tier (trivial/pequeno/arquitetural), cria specs/NNNN-<nome>/ com os templates certos, conduz o preenchimento de cima pra baixo pelos gates (product → design → domain → spec → tasks) e, quando há MCP conectado, importa a story do Jira no início e cria as issues na quebra de tasks. Acione com /nova-feature.
Use para construir ou atualizar docs/product/roadmap.md em horizontes Now/Next/Later, com valor, esforço, dono e dependências, priorizando quick wins de baixo risco. No brownfield inclui a adoção incremental do SDD. Pensado para revisar com o time a cada ciclo. É chamada pelo /kickoff e também roda sozinha periodicamente. Acione com /roadmap.
Use APÓS implementar uma feature para validá-la (UAT) — roda os gates de docs/engineering/TESTING.md, mapeia cada AC-N ao seu teste e aponta ACs sem cobertura, resolve SPEC_DEVIATION pendente, checa o Definition of Done e atualiza docs/STATE.md. Acione com /validar.
Use para acompanhar métricas de entrega/fluxo — Lead Time (tempo até produção) e Throughput (itens concluídos por ciclo) — a maturidade de Continuous Delivery vs Continuous Deployment, e a qualidade de código (cobertura e análise estática) como tendência rastreável. Lê git/Jira/CI e os artefatos de qualidade quando há MCP conectado e atualiza docs/engineering/metrics.md. Acione com /metricas.