CommunityEscrita e Ediçãogithub.com

AaronCx/claude-code-practices

Entrevista o usuário em profundidade sobre uma funcionalidade e, em seguida, escreve um SPEC.md autocontido para implementar em uma nova sessão. Use antes de construir algo grande.

O que é claude-code-practices?

Esta skill conduz uma entrevista detalhada com o usuário sobre uma funcionalidade a ser desenvolvida, utilizando a ferramenta `AskUserQuestion` para explorar implementação técnica, UI/UX, casos extremos, preocupações e trade-offs. O objetivo é cobrir todos os aspectos críticos que o usuário pode não ter considerado, evitando perguntas óbvias. Ao final, a skill gera um arquivo `SPEC.md` completo e autocontido, nomeando arquivos e interfaces envolvidas, declarando o que está fora do escopo e incluindo uma etapa de verificação ponta a ponta. Por fim, orienta o usuário a executar `/clear` e implementar a partir da especificação em uma nova sessão, garantindo que o contexto de implementação contenha apenas o spec. É ideal para ser usada antes de construir qualquer funcionalidade grande, especialmente com assistentes como Claude Code.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronCx/claude-code-practices/tree/HEAD/skills/spec-interview

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O usuário deseja construir: $ARGUMENTS

Entreviste-o em detalhes usando a ferramenta AskUserQuestion. Pergunte sobre implementação técnica, UI/UX, casos extremos, preocupações e trade-offs. Não faça perguntas óbvias; aprofunde-se nas partes difíceis que ele pode não ter considerado. Continue entrevistando até que tudo esteja coberto.

Em seguida, escreva uma especificação completa em SPEC.md. As especificações mais úteis são autocontidas: nomeie os arquivos e interfaces envolvidos, declare o que está fora do escopo e termine com uma etapa de verificação ponta a ponta que comprove o funcionamento da funcionalidade.

Finalize informando ao usuário para executar /clear e implementar a partir do SPEC.md em uma nova sessão, de modo que o contexto de implementação contenha apenas a especificação.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas