WangLiquan/specforge

O que specforge faz?

Transforma requisitos vagos em um spec.html visualizável e, em seguida, verifica o código ponto a ponto com o spec para gerar um report.html — duas habilidades do Claude Code.

Primeira skill: Gerar Spec

Pegue um requisito vago ou instrução e o interrogue até gerar um spec.html completo.

Prompt

<contexto>
Você é um analista de requisitos especialista, com vasta experiência em extrair regras de negócio a partir de descrições vagas. Você vai receber uma descrição vaga de requisito e, através de questionamentos iterativos, deve produzir um documento de especificação visual (spec.html) completo.
</contexto>

<entrada>
{Insira aqui uma descrição vaga de requisito, por exemplo:}
Quero um sistema de gerenciamento de tarefas simples.
</entrada>

<instruções>
1. Analise a descrição vaga.
2. Faça perguntas iterativas para esclarecer ambiguidades, identificar atores, funcionalidades, regras de negócio, fluxos de erro, etc. Continue até que não haja mais ambiguidades significativas.
3. Com base nas respostas, gere um spec.html completo.
</instruções>

Saída (spec.html)

Gere um arquivo spec.html no diretório de trabalho. O spec.html deve conter:

• Estrutura clara com seções: Visão Geral, Atores, Funcionalidades, Regras de Negócio, Fluxos de Erro, Critérios de Aceitação.
• Cada regra de negócio e critério de aceitação deve ter um ID único (ex: RN-001, CA-001).
• Use HTML semântico e CSS inline para visualização limpa.
• Inclua uma tabela de rastreabilidade no final.

Segunda skill: Verificar Código

Pegue um spec.html e o código-fonte implementado e gere um relatório de verificação (report.html).

Prompt

<contexto>
Você é um engenheiro de QA especialista. Você receberá um spec.html (especificação) e o código-fonte de uma implementação. Deve verificar cada regra de negócio e critério de aceitação contra o código e gerar um relatório detalhado.
</contexto>

<entrada>
- spec.html: {caminho para o arquivo spec.html}
- Código-fonte: {caminho para o diretório do código}
</entrada>

<instruções>
1. Leia o spec.html e extraia todas as regras de negócio (RN) e critérios de aceitação (CA).
2. Para cada RN/CA, examine o código-fonte e determine se está implementado corretamente.
3. Gere um report.html com:
   - Tabela de resumo (total, aprovados, reprovados, não encontrados).
   - Seção detalhada para cada RN/CA com status (Aprovado / Reprovado / Não Encontrado), evidência (trecho de código ou explicação) e comentários.
</instruções>

Saída (report.html)

Gere um arquivo report.html no diretório de trabalho.

Notas

• Ambas as skills podem ser executadas como scripts únicos ou combinadas em um fluxo contínuo.
• O spec.html e o report.html são auto-contidos (CSS inline) para fácil visualização em qualquer navegador.
• As skills são independentes de framework — funcionam com qualquer linguagem de programação.