Communitygithub.com

SailRain/habilidades-de-plotagem-cientifica

Plota dados numéricos no domínio do tempo como séries temporais puras ou trajetórias de fase com formas de onda, ou renderiza planos categóricos MAT como fatias deslocadas; organiza, exporta e verifica figuras para o local de destino. Não use para gerar dados de simulação, modificar modelos, resolver numericamente, projetar critérios de classificação ou analisar mecanismos dinâmicos.

O que é habilidades-de-plotagem-cientifica?

Esta habilidade especializada permite que agentes de IA (como Claude Code, Cursor ou Codex) realizem tarefas de plotagem científica com precisão, utilizando arquivos de dados de séries temporais existentes ou planos categóricos MAT. Ela suporta três tipos principais de plotagem: séries temporais puras, gráficos de trajetória de fase combinados com formas de onda, e fatias deslocadas de planos categóricos MAT, sendo especialmente útil para pesquisadores e engenheiros que precisam visualizar dados de sistemas dinâmicos ou resultados de classificação. O fluxo de trabalho prioriza a leitura direta dos dados originais, sem modificações, e aplica regras rigorosas de configuração, como a centralização de parâmetros (entrada, tipo de plotagem, posicionamento, esquema de cores) a partir dos arquivos de dados e instruções do usuário. A habilidade também gerencia o posicionamento das figuras em documentos de uma ou duas colunas, verifica a precisão das dimensões físicas (dentro de 0,1 mm) e garante que os scripts MATLAB gerados sejam reproduzíveis, preservando os dados de entrada como somente leitura. Regras comuns de gráficos incluem o uso da fonte Times New Roman (8 pt padrão), tela branca, itálico para variáveis e itálico reto para unidades, além da aplicação de um esquema de cores compartilhado (SailRain por padrão). A habilidade não deve ser usada para gerar dados de simulação, modificar modelos, resolver numericamente, projetar critérios de classificação ou analisar mecanismos dinâmicos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SailRain/scientific-plotting-skill/tree/HEAD/scientific-plotting

Perguntar na sua IA favorita

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

Documentação

Fluxo de Trabalho de Plotagem Científica

As instruções atuais do usuário e as configurações confirmadas na conversa atual têm precedência sobre os padrões desta habilidade. Leia e siga as instruções aplicáveis do AGENTS.md para o projeto atual do usuário, usando o escopo do projeto e do diretório estabelecido pelo ambiente host. Resolva essas instruções a partir do diretório do projeto ativo, não do diretório da habilidade instalada. Se nenhum arquivo de instrução de projeto aplicável existir, prossiga de acordo com as outras instruções aplicáveis e os padrões desta habilidade. Os tipos de plotagem atualmente incluídos são séries temporais puras, trajetórias de fase com formas de onda pareadas e fatias deslocadas de planos categóricos MAT. Estabeleça um fluxo de trabalho correspondente antes de usar qualquer outro tipo de plotagem; não aplique regras específicas a um tipo de plotagem semelhante.

1. Roteamento do Tipo de Plotagem e Posicionamento

Para cada tarefa, determine primeiro o tipo de plotagem e, em seguida, o posicionamento final, e leia exatamente um arquivo correspondente para cada um:

  1. Tipo de plotagem
  2. Posicionamento
  3. Dimensões físicas fornecidas explicitamente na solicitação atual do usuário substituem os campos padrão correspondentes no arquivo de posicionamento; campos sem substituições mantêm suas predefinições existentes. Se o posicionamento selecionado não tiver dimensões padrão, confirme as dimensões ausentes. Não pegue valores emprestados de outro posicionamento.

Os esquemas de cores são uma configuração compartilhada entre essas duas dimensões. Leia a referência de esquema de cores ao selecionar cores para curvas ou categorias. Use o esquema selecionado, ou SailRain por padrão, a menos que cores explícitas do usuário ou uma configuração de tarefa confirmada o substituam. Um esquema altera apenas as cores; ele não altera a tipografia, geometria, posicionamento da barra de cores ou requisitos de exportação.

2. Princípios Comuns de Configuração e Entrada

  1. Inspecione os arquivos originais, metadados e programas existentes aplicáveis especificados diretamente pelo usuário. Não substitua por capturas de tela, saídas históricas ou dados mais antigos com nomes semelhantes. Configure campos de entrada, colunas, orientação da matriz, variáveis, unidades, contagem de figuras e ordem a partir da fonte real ou instruções confirmadas.
  2. Centralize a configuração das entradas e sua ordem, tipo de plotagem, posicionamento, semântica de exibição, intervalos, arranjo, dimensões, cores, texto e local de saída. Determine esses itens a partir dos dados originais, programas existentes e conversa atual primeiro. Pergunte apenas sobre informações que não podem ser verificadas e que afetariam o resultado.
  3. Trate os dados originais como somente leitura: não sobrescreva, reordene, reformate ou exclua. Por padrão, use fielmente as amostras originais ou células de classificação sem interpolação, redução de amostragem, suavização ou alterações nos valores numéricos. Aplique as verificações de validade e orientação no arquivo do tipo de plotagem selecionado.
  4. Não infira variáveis, unidades, períodos, atratores ou categorias a partir de nomes de arquivos, magnitudes numéricas, códigos ou cores de exemplo. Identifique discrepâncias entre fontes conflitantes. Se a semântica não puder ser verificada, confirme primeiro ou, se o usuário aceitar, use fielmente os códigos originais como rótulos.
  5. Preserve a ordem dos arquivos e figuras especificada pelo usuário ou confirmada na conversa atual. Não reordene automaticamente por nome de arquivo ou valor numérico.

3. Regras Comuns de Gráficos e Implementação

  1. Todo texto visível, incluindo rótulos de ticks, rótulos de eixos, rótulos de painéis, texto de parâmetros, texto da barra de cores e quaisquer títulos ou legendas solicitados pelo usuário, deve usar Times New Roman. O texto principal usa como padrão 8 pt; subscritos podem usar um tamanho menor conforme necessário para o layout. Use outro tamanho de fonte quando especificado explicitamente pelo usuário. Verifique a disponibilidade da fonte antes de renderizar; informe uma fonte ausente e resolva antes de declarar a aceitação da tipografia. Não substitua silenciosamente.
  2. Use uma tela branca por padrão. Italicize variáveis e subscritos que representam variáveis; use tipo reto para unidades e subscritos descritivos. Siga os requisitos do usuário para símbolos específicos, capitalização e glifos.
  3. Resolva as cores usando as regras do esquema de cores compartilhado e o arquivo do tipo de plotagem selecionado. Preserve as cores explícitas do usuário e os mapeamentos de tarefa confirmados; caso contrário, use o esquema selecionado ou o padrão SailRain. Registre o esquema e as atribuições reais de cores na configuração da tarefa. Não transfira significados semânticos de figuras históricas, rótulos de proveniência do esquema ou outros conjuntos de dados.
  4. Mantenha scripts MATLAB reproduzíveis. Construa caminhos com mfilename('fullpath') e configuração explícita, em vez de depender de mudanças manuais de diretório. Use nomes em inglês para novos arquivos, funções e variáveis. Escreva novos comentários, prompts, títulos de figuras e rótulos em inglês americano, preservando símbolos matemáticos conforme exigido pela tarefa.
  5. Use nomes de saída especificados pelo usuário; caso contrário, use nomes em inglês snake_case que descrevam o conteúdo da figura. Não sobrescreva arquivos não relacionados com o mesmo nome; reporte conflitos primeiro. Não escreva dados reais ou resultados gerados no diretório da habilidade instalada.

4. Verificação e Entrega

  1. Execute o MATLAB até a conclusão. Verifique fontes de entrada, mapeamentos de exibição, contagens de amostras ou células de classificação e intervalos para confirmar que as figuras representam fielmente os dados originais.
  2. Verifique posições e dimensões físicas em relação ao tipo de plotagem, posicionamento e configuração do usuário atuais. Dimensões em milímetros especificadas explicitamente devem ser precisas dentro de 0,1 mm. Realize as verificações de saída, dados e visuais exigidas pelo arquivo do tipo de plotagem selecionado; não substitua por formatos de exportação de outro tipo de plotagem.
  3. Inspecione uma renderização de alta resolução dos arquivos de aceitação finais quanto a fontes, tamanhos de fonte, cores, espessuras de linha, rótulos, limites, recorte, sobreposição e espaço em branco desnecessário. Corrija quaisquer problemas, depois exporte e inspecione novamente.
  4. Entregue o programa reproduzível e os arquivos finais exigidos pelo tipo de plotagem selecionado. Descreva brevemente o tipo de plotagem, posicionamento, mapeamentos de entrada e exibição, substituições do usuário e local de saída. Relate se o MATLAB foi executado com sucesso e quais verificações de dimensão, arquivo e visuais foram concluídas. Divulgue claramente qualquer verificação que não foi concluída.

Habilidades Relacionadas