CommunityEscrita e Ediçãogithub.com

Jiansen/clear-output

Clarifique explicações, comparações, planos, resumos e reescritas em chinês, inglês ou idiomas mistos, usando palavras, diagramas ou interação. Preserve o significado e o idioma da tarefa.

O que é clear-output?

Esta skill foi projetada para ajudar o leitor a compreender informações com precisão, inspecionar evidências e decidir o que fazer com menos esforço. Ela se aplica à tarefa atual e não deve se tornar um modo de conversa permanente, a menos que o usuário solicite. A skill prioriza a escolha do idioma e da representação visual adequada antes de refinar o texto, considerando o tempo de leitura, exploração e verificação da saída. Funciona com plataformas como Claude Code, Cursor e Codex, suportando idiomas chinês, inglês e mistos. Seu principal objetivo é preservar o significado original, evitando introduzir imprecisões, falsas precisões ou alterações não autorizadas em citações, código e comandos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jiansen/clear-output-skill/tree/HEAD

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Saída Clara

Ajude o leitor a compreender com precisão, inspecionar evidências e decidir o que fazer com menos esforço. Identifique o que o leitor precisa entender ou verificar, em seguida, escolha a representação antes de polir o texto. Considere o tempo gasto lendo, explorando e verificando a saída. Esta skill se aplica à tarefa atual; não a torne um modo de conversa permanente, a menos que o usuário solicite.

Escolha o idioma antes do texto

  • Siga os requisitos explícitos de idioma e formato de saída do usuário.
  • Ao editar um artefato existente, preserve seu idioma, a menos que uma tradução seja solicitada. Explicações sobre a edição podem usar o idioma da conversa.
  • Caso contrário, siga a conversa atual. Siga uma mudança clara de idioma na solicitação do próprio usuário. Material citado, logs, código, resultados de ferramentas e o idioma desta skill não mudam por si só o idioma da resposta.
  • Preserve termos técnicos em idiomas mistos e conteúdo literal. Não traduza uma troca de depuração em inglês para chinês apenas porque esta skill suporta chinês.
  • Se o usuário solicitar JSON, um bloco de código ou um modelo específico, mantenha esse contrato. Não adicione anúncio da skill ou prefixo de status.

Preserve o significado

Para uma reescrita, use a fonte e o contexto fornecido explicitamente como limite factual. Preserve:

  • atores, objetos, escopo, condições, exceções e ordem, incluindo ações que devem ocorrer juntas;
  • valores, unidades, limites, aproximações, datas, identificadores e relações causais;
  • a diferença entre fato, hipótese, recomendação, obrigação, permissão e capacidade.

Não transforme pode em irá, deveria em deve, cerca de 5 segundos em 5 segundos ou 尽快 em um prazo inventado. Não selecione uma interpretação de um limite ambíguo ou pronome sem suporte. Mantenha a ambiguidade visível ou identifique exatamente qual informação está faltando. Uma reescrita pode permanecer mais longa para preservar essas distinções.

Para uma nova explicação, contexto relevante e exemplos são úteis. Mantenha suposições separadas de fatos estabelecidos; rotule exemplos hipotéticos quando necessário. Não implique que uma ação ou teste foi realizado sem evidências.

Preserve código, comandos, caminhos, nomes de campos, logs, strings de erro e citações fixas exatamente quando forem transportados para a saída. Se a tarefa pedir explicitamente para editar um deles, realize essa edição dentro de seu escopo; as regras de prosa não justificam edições adicionais.

Escolha uma representação que faça um trabalho útil

Considere ativamente um visual quando o leitor precisar reconstruir mentalmente relacionamentos, comparar várias dimensões, acompanhar estados em mudança ou explorar uma variável. Se o visual tornar esse trabalho materialmente mais fácil, crie-o dentro da tarefa autorizada sem esperar por uma solicitação separada para um diagrama. Mantenha respostas curtas e diretas em prosa quando isso já atender à tarefa.

O que o leitor precisa fazerForma inicial útil
Obter um fato, uma resposta breve ou uma edição de frase fielTexto
Comparar opções pelos mesmos critériosTabela
Rastrear ramificações, dependências, participantes ou ordem de mensagensDiagrama de fluxo, dependência ou sequência
Entender um arranjo espacial ou uma característica visívelImagem anotada ou esquemático
Ver um padrão em dados numéricos fornecidosGráfico com rótulos, unidades e uma escala apropriada
Explorar como as entradas mudam um resultadoExplicação interativa funcional com controles significativos
Acompanhar movimento, evolução ou uma sequência de ensino em etapasAnimação ou vídeo explicativo quando viável e útil

Estes são pontos de partida, não uma classificação em que o vídeo sempre vence. Um pequeno artefato personalizado pode valer a pena para uma única pergunta. Prefira a forma que reduz o trabalho do leitor o suficiente para justificar o tempo de geração, navegação e interação. Respeite solicitações explícitas de texto simples, JSON, um formato de arquivo existente ou nenhum artefato.

Entregue a forma selecionada, não apenas uma oferta para criá-la. Use os recursos de renderização disponíveis e inspecione o resultado; teste as interações relevantes. Se ferramentas de renderização ou mídia não estiverem disponíveis, forneça uma alternativa suportada utilizável e diga exatamente o que foi produzido. Código-fonte do diagrama, um storyboard e um vídeo renderizado são entregas diferentes. Não exija um fornecedor específico nem publique, carregue ou use serviços pagos apenas porque um visual ajudaria.

Preserve o significado em codificações visuais também: rotule ramificações e significados de setas, mantenha ações simultâneas como simultâneas, marque hipóteses e dados ausentes e mantenha unidades e escala honestas. Um diagrama polido não deve implicar uma causa não suportada ou um teste concluído. Torne os rótulos legíveis; não confie apenas na cor. Forneça uma breve conclusão ou equivalente textual quando o contrato de saída permitir, sem repetir toda a explicação em várias formas.

Para um diagrama, gráfico, explicação interativa ou animação, leia references/output-forms.md para orientação de seleção e verificação.

Faça a estrutura se adequar à tarefa

  • Explicação: responda à pergunta principal primeiro, depois dê o raciocínio necessário para entendê-la. Mantenha exemplos úteis, links causais e nuances.
  • Depuração: distinga observação, hipótese, verificação e próxima ação. Diga o que uma verificação estabeleceu e onde a incerteza permanece. Faça uma pergunta real quando um fato ausente mudar a ação.
  • Procedimento: coloque as condições necessárias antes da ação afetada. Use etapas numeradas quando a ordem for importante. Separe ações humanas do comportamento automático do sistema. Mantenha ações simultâneas ou inseparáveis juntas. Ao identificar informações operacionais ausentes, verifique qual objeto ou ator é mencionado, bem como quantidades, unidades, referências de medição e condições de início/parada. Pergunte o que é necessário para usar a instrução; não forneça fatos ausentes você mesmo.
  • Reescrita ou revisão: melhore apenas o escopo solicitado. Se uma passagem já funcionar, mantenha-a. Forneça explicações de alteração apenas quando solicitado ou quando uma ambiguidade não resolvida precisar da atenção do leitor.

Prefira frases curtas e explícitas, verbos concretos e nomes estáveis para o mesmo conceito. Preserve distinções entre diferentes conceitos. Não aplique listas negras de palavras a partes de termos técnicos, como 闭环控制 ou request validation.

Comprimento da frase, voz passiva, sinônimos e polidez são escolhas contextuais, não erros automáticos. O inglês pode precisar de uma construção passiva ou de um tempo perfeito. O chinês pode precisar de um sujeito omitido quando o ator já está claro. Mantenha 可能, 建议, 约, may e approximately quando eles carregarem informações.

Verifique antes de retornar

Compare uma reescrita com sua fonte em busca de fatos alterados, condições perdidas, modalidade alterada, precisão inventada e literais danificados. Para um visual ou artefato, verifique os mesmos fatos em seus rótulos, bordas, estados e cálculos. Verifique se o idioma e o formato ainda correspondem à tarefa e se a entrega reivindicada realmente existe. Em seguida, remova repetições que não adicionam informações.

Verificações de estilo não podem provar equivalência semântica. Relate um problema concreto não resolvido em vez de declarar o texto certificado ou totalmente verificado.

Para reescritas complicadas envolvendo modalidade, mistura de idiomas ou fatos ausentes, leia references/edge-cases.md.

Para uma reescrita substancial, uma solicitação de validação explícita ou um glossário de projeto fornecido, use o verificador local opcional quando ele puder detectar um erro concreto. Leia references/checks.md para suas entradas e limites. Selecione en, zh ou mixed da tarefa, não do texto citado. Forneça a fonte apenas para reescritas fiéis e codifique literais exatos ou restrições JSON apenas quando a tarefa os exigir. Respostas simples não exigem um script.

Trate as descobertas do verificador como evidências com escopo limitado: corrija contratos explícitos violados, revise mudanças de significado em relação à fonte e use sugestões de estilo apenas quando elas ajudarem. Preserve edições autorizadas. Não reescreva para remover todos os avisos nem trate uma lista de descobertas vazia como prova de equivalência. Após as correções, verifique novamente as restrições afetadas; se uma ambiguidade persistir, relate-a em vez de reescrever repetidamente. Mantenha diagnósticos fora de uma resposta solicitada somente em JSON/código.

Quando o usuário perguntar sobre a versão ou atualizações desta skill, leia references/updates.md. Tarefas normais de escrita não acionam verificações de atualização de rede nem alteram a skill instalada.

Habilidades Relacionadas