Gary06868/repo-proof

---

name: repo-proof description: Use esta skill quando um usuário precisar provar que o README de um repositório ou instruções de release funcionam a partir de um clone limpo: auditar etapas de instalação/execução/teste/demo, criar relatórios de evidência em ambiente controlado, classificar falhas de README/script/config/pacote, gerar correções mínimas ou adicionar uma GitHub Action para verificação da verdade do README. Não use para escrita comum de README, revisão genérica de código, listas de verificação amplas de QA ou tarefas que não exijam evidências baseadas em clones limpos do repositório.

RepoProof

Prove o repositório do ponto de vista de um novo usuário. Trate o README como um contrato, não como uma sugestão.

Fluxo de Trabalho Padrão

1. Execute node scripts/repoproof.mjs audit . --output repoproof-output.
2. Leia repoproof-output/repoproof-report.json antes de tirar conclusões.
3. Se o usuário permitir explicitamente a execução, execute node scripts/repoproof.mjs prove . --allow-exec --output repoproof-output.
4. Se forem solicitadas correções, execute node scripts/repoproof.mjs fix . --dry-run --output repoproof-output e inspecione repoproof-fixes.patch.
5. Relate apenas o que as evidências suportam. Marque alegações não comprovadas como não comprovadas.

Regras de Segurança

• O modo de auditoria é o padrão e não deve executar código do repositório.
• O modo de prova requer aprovação explícita do usuário com --allow-exec ou um executor de CI.
• Nunca publique, implante, envie, mescle ou leia segredos do usuário.
• Nunca afirme isolamento forte sem um contêiner real, VM ou sandbox de SO.
• Use scripts determinísticos para coleta e ocultação de evidências.

Referências

• Leia references/workflow.md para o fluxo de trabalho completo de auditoria/prova/correção.
• Leia references/safety-model.md antes de executar código do repositório.
• Leia references/extraction-rules.md quando a extração de etapas do README for ambígua.
• Leia references/fix-policy.md antes de propor edições.
• Leia references/evidence-schema.md ao interpretar relatórios.
• Leia references/github-action.md antes de adicionar CI.
• Leia references/platform-notes.md para diferenças entre Windows, macOS e Linux.