Projeto 2: Skill Multi-arquivo com Dicionários e Validadores

content-voice-guard/
|-- SKILL.md
|-- scripts/
|   |-- voice_guard.py         # Orquestrador principal
|   |-- accent_checker.py      # Validador de acentos
|   |-- cliche_checker.py      # Validador de cliches
|   `-- credential_checker.py  # Validador de credenciais
|-- dicionarios/
|   |-- acentos_pt_br.json     # 300+ palavras -> versao correta
|   |-- cliches_proibidos.json # Lista de proibidos
|   |-- credenciais.json       # Credenciais canonicas por pessoa
|   `-- dominios_validos.json  # Whitelist de dominios
|-- templates/
|   `-- report.md
|-- references/
|   `-- editorial-guide.md     # Guia completo (opcional)
`-- tests/
    |-- fixtures/              # Textos de teste
    `-- test_voice_guard.py

# dicionarios/acentos_pt_br.json (extrato de exemplo)
{
  "entradas": {
    "nao": "nao -> não",
    "voce": "voce -> você",
    "publicacao": "publicacao -> publicação",
    "informacao": "informacao -> informação",
    "relatorio": "relatorio -> relatório"
  },
  "exceptions_regex": [
    "^[A-Z]{2,4}$",              # Siglas em caixa alta (AI, GEO, CMO)
    "^https?://",                 # URLs nunca sao corrigidas
    "\\bfrom\\s+[a-zA-Z_.]+\\s+import\\b"  # Imports Python
  ],
  "skip_contexts": [
    "code_block",                 # Blocos ``` nao sao validados
    "inline_code",                # `codigo` nao e validado
    "url",                        # slugs, href, src
    "jsx_attribute"               # prop={"texto"}
  ]
}

# Comentario: o campo `entradas` faz a correcao direta.
# `exceptions_regex` impede falsos positivos (AI != AI).
# `skip_contexts` diz para nunca corrigir dentro desses blocos.

# scripts/voice_guard.py (excerto essencial)
from pathlib import Path
import json, sys, argparse
from accent_checker import check_accents
from cliche_checker import check_cliches
from credential_checker import check_credentials

BASE = Path(__file__).parent.parent
DICT_DIR = BASE / "dicionarios"

def load_dict(name: str) -> dict:
    return json.loads((DICT_DIR / name).read_text(encoding="utf-8"))

def main() -> int:
    parser = argparse.ArgumentParser()
    parser.add_argument("--file", required=True)
    parser.add_argument("--strict", action="store_true",
                        help="warnings tambem bloqueiam")
    args = parser.parse_args()

    text = Path(args.file).read_text(encoding="utf-8")

    accents = check_accents(text, load_dict("acentos_pt_br.json"))
    cliches = check_cliches(text, load_dict("cliches_proibidos.json"))
    creds = check_credentials(text, load_dict("credenciais.json"))

    issues = accents + cliches + creds
    blocking = [i for i in issues if i["severity"] == "error"]
    warnings = [i for i in issues if i["severity"] == "warning"]

    print(json.dumps({
        "file": args.file,
        "total_issues": len(issues),
        "blocking": len(blocking),
        "warnings": len(warnings),
        "issues": issues,
    }, indent=2, ensure_ascii=False))

    return 1 if blocking or (args.strict and warnings) else 0

if __name__ == "__main__":
    sys.exit(main())

---
name: variacoes-anuncio
description: Gera variações de títulos e descrições de anúncios (Google Ads, Meta, LinkedIn) dentro dos limites de caracteres e das regras de marca. Use quando pedirem variações, novos títulos, headlines ou textos de anúncio.
allowed-tools: Read Write
hooks:
  PostToolUse:
    - matcher: "Write|Edit"
      hooks:
        - type: command
          command: "python3 ${CLAUDE_PROJECT_DIR}/.agents/skills/variacoes-anuncio/scripts/checar_marca.py"
---

# Variações de anúncio

1. Leia references/marca.json: termos proibidos, promessas vetadas,
   limites de caracteres por plataforma e tom de voz.
2. Gere 15 títulos e 4 descrições por grupo de anúncios, em PT-BR.
3. Salve em anuncios/<campanha>-<data>.csv (plataforma, tipo, texto, caracteres).
4. Se o verificador apontar problema, corrija só as linhas citadas
   e salve de novo. Não entregue com aviso pendente.

# scripts/checar_marca.py lê o JSON do hook na entrada padrão,
# abre o arquivo de tool_input.file_path, confere limites e termos
# e sai com código 2 listando as linhas fora da regra: no PostToolUse
# o Claude Code mostra essa saída ao agente, que corrige em seguida.