fancydirty/mediary-scout

Skill clawd-media-track

PRIMEIRAS AÇÕES (OBRIGATÓRIAS)

Antes de qualquer raciocínio ou uso de ferramentas do clawd-media-track:

1. Leia references/00-bootstrap-init.md
2. Verifique se o bootstrap está completo
3. Se o bootstrap estiver incompleto, permaneça no modo init e não entre nos Tipos 1 / 2 / 3 ainda
4. Se o bootstrap estiver completo, leia references/01-environment-contract.md
5. Leia references/02-global-constraints.md
6. Leia references/03-methods-reference.md
7. Determine se a tarefa é Tipo 1, Tipo 2 ou Tipo 3
8. Leia a checklist correspondente ao tipo
9. Saída do checkpoint atual como [Tipo X - Etapa N]
10. PARE e aguarde a confirmação do usuário antes de qualquer ação com efeito colateral

NÃO:

• pule referências obrigatórias
• adivinhe o tipo da tarefa
• afirme "nenhum recurso" antes de completar/repetir a consulta
• execute ações de transferir/criar/excluir/marcar sem confirmação explícita do usuário
• pule a verificação pós-ação

Notas Críticas de Segurança

Este sistema pode fazer chamadas destrutivas ou sensíveis a limite de taxa ao 115 se usado descuidadamente.

Leia as referências em ordem e siga a checklist para o tipo de tarefa atual. Não improvise ao redor delas.

Em particular:

• Os diretórios alvo vêm da configuração CID baseada no ambiente, não de suposições.
• flatten_directory() é válido apenas em diretórios finais de destino:
  • diretórios de filmes diretamente sob MOVIES_CID
  • diretórios de temporada que terminam com Temporada <número>
• Diretórios raiz/mídia/categoria são protegidos e nunca devem ser usados como alvos de aplainamento.
• list_files() é superficial por padrão. Varreduras recursivas em diretórios protegidos são bloqueadas por segurança.
• Se um método levantar SAFETY_VIOLATION, pare e relate o alvo/caminho exato em vez de repetir com suposições.
• As barreiras de segurança em nível de código são um apoio, não um substituto para ler a checklist e escolher o alvo correto.

Este skill é dividido para carregamento progressivo.

Leia apenas o necessário, mas nunca pule as regras de segurança/necessárias para o tipo de tarefa atual.

Ordem de Leitura Obrigatória

Para qualquer tarefa clawd-media-track, leia nesta ordem:

1. references/00-bootstrap-init.md (portão init para bootstrap Etapa 1 e Etapa 2)
2. references/01-environment-contract.md (contrato de configuração necessário após bootstrap)
3. references/02-global-constraints.md (regras de segurança duras + protocolo de execução)
4. references/03-methods-reference.md (apenas métodos de módulo permitidos)

Em seguida, encaminhe por tipo de tarefa:

• Tipo 1 (aquisição única: filmes / séries concluídas): leia references/05-type1-checklist.md
• Tipo 2 (inicialização de rastreamento: em andamento/incompleto): leia references/06-type2-checklist.md
• Tipo 3 (monitoramento agendado / cron): leia references/07-type3-checklist.md

Leia referências adicionais quando necessário:

• Tratamento de erros, repetições, dedup, estratégia de divisão de temporada: references/04-error-and-dedup-rules.md
• Estrutura de diretórios e erros comuns: references/08-directory-and-mistakes.md

Regras Inegociáveis (Sempre Reforçadas)

• DEVE seguir: Evidência → Fatos Derivados → Decisão antes de cada ação crítica
• DEVE processar coleções protegidas com .each(); NÃO fatie/amostre/top-N elas
• NÃO DEVE usar scripts de cola, auxiliares de regex ou análise de strings ad-hoc para tomar decisões lógicas
• DEVE executar o Tipo 3 Etapa 3b (ramo de cobertura faltante vs. existente) sem pular
• DEVE vincular URLs de transferência uma vez e executar via variável(éis) vinculada(s); NÃO re-extraia entre decisão e transferência
• DEVE verificar efeitos colaterais (transferir/excluir/marcar/criar) com re-leituras de verificação
• DEVE tratar qualquer regra pulada como falha de tarefa e relatar honestamente

Se qualquer regra dura for violada, pare e relate a falha em vez de improvisar.

Contexto de Execução

• Diretório do projeto: raiz do repositório do skill
• Runtime Python: ./.venv/bin/python
• Autenticação/configuração: construtores leem configuração baseada no ambiente; não codifique cookies, tokens, URLs base ou CIDs no skill

Mapa de Arquivos

• references/00-bootstrap-init.md
• references/01-environment-contract.md
• references/02-global-constraints.md
• references/03-methods-reference.md
• references/04-error-and-dedup-rules.md
• references/05-type1-checklist.md
• references/06-type2-checklist.md
• references/07-type3-checklist.md
• references/08-directory-and-mistakes.md

Nota de Migração

Esta refatoração mantém o conteúdo processual original, mas roteia o material detalhado para referências para confiabilidade e eficiência de contexto.