사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-interviewer시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Conversar com uma spec pelo estado atual
Preparação obrigatória
Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa. Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma pendência.
Modo de interação
Modo de interação: perguntas. Antes de formular qualquer pergunta, leia e aplique o Contrato de perguntas numeradas de .specsfy/Spec.md.
Leia a spec.md pelo ID informado e confirme a pasta de estado. A pasta é o estado operacional; Status é seu espelho verificável. Preserve a spec como fonte normativa e registre apenas respostas, escolhas e justificativas confirmadas pela pessoa responsável.
Conduzir a conversa
- Leia a spec, seus gates, tarefas, evidências e o contexto do projeto.
- Identifique a lacuna real que mais afeta a próxima etapa e monte uma rodada
conforme o contrato central.
- Reavalie a spec depois de cada rodada. Não repita informação confirmada nem
use perguntas como ritual.
- Atualize a seção adequada da spec após confirmar a resposta. Quando a nova
informação mudar capacidade necessária, ajuste também o Effort.
- Entregue a responsabilidade de validação, implementação ou transição à skill
correspondente. Esta skill não aprova gate, não executa tarefa e não move a spec.
Adaptar o foco à pasta
| Pasta | Foco da conversa |
|---|---|
draft | problema, atores, comportamento, regras, falhas e aceite |
defined | ambiguidade que afeta plano, dados, segurança ou testes |
planned | dependências, ordem de tarefas, estratégia de TDD e BDD |
in-progress | mudança tardia, descoberta de execução e impacto no escopo |
review | aceite observado, documentação, pendências de entrega e retorno |
completed | não entreviste para alterar a entrega; inicie ou reabra a mudança pelo fluxo correto |
inbox não recebe perguntas. backlog continua sob responsabilidade de $specsfy-02-backlog, que chama este protocolo de descoberta quando necessário.
Atualizar Effort
Use Effort como estimativa de capacidade de raciocínio e execução necessária, nunca como prazo. Escolha um inteiro de 1 a 10 e uma justificativa curta:
- 1–2: alteração atômica e padrão conhecido;
- 3–4: mudança local e testes diretos;
- 5–6: vários arquivos ou integração conhecida;
- 7–8: mudança transversal, migração ou integração externa;
- 9–10: arquitetura, alta incerteza ou revisão humana frequente.
Execute após a confirmação:
specsfy effort <id-da-spec> <1-10> --reason "<o que mudou a estimativa>"O comando atualiza Effort, data, justificativa e histórico em spec.md. Não vincule a estimativa ao nome de um modelo: use a faixa para escolher o perfil de execução light, standard, high ou maximum.
Integrar ClickUpfy quando presente
Se o projeto contiver uma skill clickupfy-* e a spec tiver ClickUp Task, depois de uma transição ou ajuste de Effort carregue a skill ClickUpfy apropriada. Use o mapeamento configurado pelo projeto ou, quando ausente, draft/defined/planned para To Do, in-progress para In Progress, review para In Review e completed para Complete.
O estado local permanece canônico. Se a atualização remota não ocorrer, registre a pendência na spec sem declarar sincronização concluída.
Limites
- Não inventar respostas, Effort, vínculo de tarefa ou status remoto.
- Não alterar uma spec em
completedcomo forma de iniciar mudança nova. - Não mover pastas por comando do sistema; use
specsfy transitionsomente na
skill responsável depois de seus gates.
- Não exigir ClickUp para uma spec sem integração configurada.
