/video-ask
Orienta o usuário em uma tela: onde ele está, qual é o estado das coisas, o que digitar em seguida.
1. Leia o estado a partir dos arquivos, não da memória
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-ask/scripts/status.py"
Passe uma pasta como primeiro argumento quando o usuário perguntar sobre uma que não seja a pasta atual.
Adicione --json se você precisar dos campos (caminhos, versões, estágios) para responder a uma pergunta precisa.
O script infere o estágio de cada vídeo a partir dos arquivos que docs/contracts.md define, estágio mais
recente alcançado: brief não assinado, assinado, fontes obtidas, verdade, especificações, narração, construído, renderizado, QA falhou,
QA aprovado, entregue. Um relatório de QA só conta quando seu sha256 corresponde ao render mais recente, então um
novo render após QA mostra como renderizado novamente. Confie no script em vez do que uma conversa anterior disse: um subagente
pode ter alterado arquivos desde então.
2. Responda
Mostre a saída do script como ela é (já é curta), depois o próximo comando em sua própria linha. Se o usuário fez uma pergunta (o argumento), responda-a após o status, usando estas fontes em ordem, e informe qual arquivo você usou:
$PVS_HOME/README.md(o que são os skills, a instalação, as entradas que um produto precisa)$PVS_HOME/docs/contracts.md(formatos de arquivo, layout de pastas, linhas de comando)- O
SKILL.mddo skill sobre o qual a pergunta é, em$PVS_HOME/skills/ - O
kit/RULES.mddo produto para perguntas do tipo "por que esta regra está aqui"
Se a resposta não estiver nesses arquivos, diga isso em vez de adivinhar.
3. Coisas a destacar quando você as vir
- Configuração não concluída: o próximo comando é
/video-setup. Nada mais funciona de forma confiável antes dele. - Chave de voz não configurada: o usuário a cola no
.envda bancada em seu próprio editor, nunca no chat.voice.provider: sayfunciona sem uma. Nunca leia.envpara verificar: o script já informa se está configurado ou não. - Na raiz da bancada com produtos: cada produto é seu próprio projeto do Claude Code, com seus
próprios skills e hooks. O usuário executa
cd produtos/<slug> && claudepara trabalhar nele. - Brief não assinado: a construção espera de propósito as duas assinaturas do revisor. Na produção de onde vêm esses skills, 9 de 26 versões aconteceram porque ninguém havia concordado sobre quais funcionalidades um vídeo deve explicar. Não sugira editar os campos de assinatura para o revisor.
- QA falhou: aponte para
qa/REPORT.mddesse vídeo para as verificações que falharam.
Não comece a construir, corrigir ou entregar a partir daqui. Este skill só informa; o usuário digita o próximo comando.