Revisão de roteiros
Cada roteiro é um arquivo markdown. O revisor o lê em uma página local, e suas anotações voltam para você como markdown. Todos os comandos são python3 scripts/script_review.py <comando>, com o caminho relativo à pasta desta skill. Python 3.9 ou superior, nenhum pacote para instalar.
O ciclo de revisão
- Salve o roteiro. Escreva o corpo em um arquivo temporário e execute
script_review.py new --title "<título>" --body-file <arquivo> --status drafted. Ele imprime o id do roteiro, o caminho do arquivo e o endereço da página. Coloque uma frase ou batida em cada linha da leitura, para que cada linha possa receber seu próprio comentário. - Inicie a página. Execute
script_review.py up, depoisscript_review.py open <id>. Forneça ao revisor o endereço. - Aguarde as anotações. Execute
script_review.py wait <id>em segundo plano. Ele imprime as anotações quando o revisor clicar em Enviar anotações e sai com código 2 após duas horas sem envio. - Aplique as anotações. Edite o arquivo do roteiro com a menor alteração que responda a cada anotação. A página aberta recarrega-se e marca as linhas que mudaram.
- Repita a partir do passo 3 até que as anotações digam "Looks good." Esse envio também move um rascunho para o status aprovado.
Se você não estava esperando quando as anotações foram enviadas, script_review.py inbox imprime todo conjunto não lido.
Regras para revisão
- Mantenha as edições do revisor palavra por palavra. Linhas listadas em "edições (já salvas no arquivo)" são suas próprias palavras e já estão no arquivo antes de você ver as anotações. Altere uma apenas quando uma anotação pedir.
- Altere apenas o que uma anotação cobre. Não reescreva linhas que não têm comentário.
- Aplique "Edições que não chegaram" manualmente. A linha foi movida antes do envio, então o arquivo não foi alterado.
- Deixe chaves do frontmatter que você não definiu. Altere o status com
script_review.py status <id> <status>, não editando o arquivo. - Não exclua um arquivo de roteiro a menos que o revisor peça.
O formato do arquivo
---
type: script
id: 2026-01-15-three-prompt-habits
title: Três hábitos de prompt
status: drafted
---
## Roteiro Falado
Sua primeira linha, uma frase por linha.
A segunda linha.
## Aberturas alternativas
Abertura 2 (pergunta): Uma segunda linha de abertura para filmar.
## Legenda
Qualquer outra coisa que você mantenha com o roteiro.
Cópia de leitura na página copia a seção Roteiro Falado como um parágrafo, depois cada abertura alternativa de abertura 2 em diante como "Dois. ". Um arquivo sem seção Roteiro Falado é lido por inteiro. script_review.py read <id> imprime o mesmo texto.
Outros comandos
list [--status <status>] [--json]: cada roteiro com seu status e contagem de palavras.status <id> <status>: define um status (idea,drafted,ready,filmed,postedpor padrão).config: as configurações em uso e o caminho do arquivo de configuração.down: para o servidor da página.
Configurações (pastas, porta, nomes de seções, status, nome do revisor) e acesso por telefone via Tailscale estão descritos no README na raiz do repositório.