stribus/pygerengastos / .agents/skills/reversa-screen-translator
reversa-screen-translator
VerifiedQuinto agente do Time de Migração. Traduz as telas do sistema legado em especificações executáveis, fechando a lacuna entre o catálogo do design-system e o código pronto. Opera em duas fases. Fase 1: detecta plataforma origem/alvo, apresenta os modos (literal, modernizado, híbrido) e exige decisão humana, produzindo screen_modernization_decision.md. Fase 2: gera target_screens.md, screen_deviation_log.md e, quando o oráculo legado roda, golden files com manifest.yaml para o Inspector consumir. Ativação: /reversa-screen-translator (geralmente invocado por /reversa-migrate, entre Designer e Inspector).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.6 KB |
| references/adapter-pairs.md | markdown | 6.6 KB |
| references/platform-detection.md | markdown | 5.9 KB |
| references/templates/golden_manifest.yaml | config | 2.8 KB |
| references/templates/inventory.schema.json | config | 5.1 KB |
| references/templates/screen_deviation_log.md | markdown | 2.2 KB |
| references/templates/screen_modernization_decision.md | markdown | 4.7 KB |
| references/templates/target_screens.md | markdown | 6.7 KB |
references/templates/golden_manifest.yaml
View on GitHub# golden/manifest.yaml
#
# Manifesto dos golden files emitidos pelo Screen Translator. O Inspector consome
# este arquivo para construir parity tests construtivos quando o oráculo legado
# está disponível e a captura foi possível.
#
# Em v1, captura automatizada via Docker/Wine/emulador é OQ-02 (não implementada).
# Este manifesto descreve o comando sugerido por tela; usuário roda manualmente.
# Em projetos sem oráculo executável, este arquivo pode existir vazio (lista de
# golden files com `present: false`) ou não existir, e o Inspector ignora.
schemaVersion: 1
generatedAt: <ISO-8601>
reversa:
version: "x.y.z"
producedBy: screen-translator
sourcePlatform: <slug>
targetPlatform: <slug>
oracleAvailable: true | false
oracleHash: "sha256:<hash do binário ou container do oráculo, quando aplicável>"
oracleCommand: "<comando base para invocar o oráculo, ex: 'docker run --rm -i legacy-atm:1.0'>"
normalizationRules:
# Regras aceitas na comparação byte-a-byte. Tudo fora daqui é divergência real.
- lineEndings: "\n" # converter CRLF → LF antes de comparar
- trimTrailingSpaces: false # padrão: nunca trimmar
- stripAnsiColors: false # padrão: nunca strippar; ANSI faz parte do contrato
- normalizeUtf8: true # converter encoding heterogêneo para UTF-8
- injectClock: "2026-01-01T00:00:00Z" # clock fake para captura determinística
- seedRandom: 42 # seed fixo
screens:
- name: <nome-canonical-da-tela>
legacyOrigin: "<arquivo:linha>"
capture:
command: "<comando completo de captura, ex: 'echo -e \"1\\n123456\\n0\\n\" | docker run --rm -i legacy-atm:1.0 > tela_login.txt'>"
expectedExitCode: 0
determinismStrategy: "fake-clock + fixed-seed"
file: "tela-login.txt" # caminho relativo a _reversa_sdd/screens/golden/
format: "ansi-byte-stream" # ansi-byte-stream | png | html-css-snapshot | raw
present: true # false quando o usuário ainda não rodou a captura
captureBy: "<nome-do-usuario-ou-CI>"
capturedAt: "<ISO-8601>"
sha256: "<hash do arquivo capturado, ou null quando present=false>"
deviations: [DEV-XXX, DEV-YYY] # lista de deviations conhecidas para esta tela
notes: "<observações específicas, ex: 'oráculo emite trailing space que ignoramos via trimTrailingSpaces na comparação'>"
- name: <segunda-tela>
# ...
# Telas para as quais a captura determinística não foi possível.
nonDeterministic:
- name: <tela-com-relogio-externo>
reason: "<descrição da fonte de não-determinismo>"
fallback: "amostragem por N execuções; golden file = comum a todas"
samples: 5
deviations: [DEV-021]
# Telas em projetos sem UI ou em modo skipped.
skipped:
reason: "<ex: legado é batch puro, agente Screen Translator pulado>"
emittedAt: <ISO-8601>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |