Chuva Para Decisao
ASecurityDescreve o que o registro de chuva de um local mostra para apoiar uma decisão de plantio ou de manejo: calendário mensal, veranicos, chuva por decêndio e início e fim das águas, sempre em contagem de anos. Usa as ferramentas da ClaudIA Clima: a tabela mensal desde 1998, o ano em curso e, em uma janela de dias que o usuário escolhe, o dia a dia de vários anos. Um script confere a transcrição contra os totais da ferramenta antes de calcular e entrega tabelas, gráficos e PDF. Os cortes e as regr...
- 2 stars
- 0 votes
- 0 copies
- 1 view
- Added November 15, 2026
Works with
Security analysis
100/100Pro scans all 11 files and shows the line behind each finding
npx -y skills add guilherme-iaparaagronomos/skills-agro --skill chuva-para-decisao --agent claude-codeAre you the author of Chuva Para Decisao?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/guilherme-iaparaagronomos-chuva-para-decisao)---
name: chuva-para-decisao
description: >-
Descreve o que o registro de chuva de um local mostra para apoiar uma decisão
de plantio ou de manejo: calendário mensal, veranicos, chuva por decêndio e
início e fim das águas, sempre em contagem de anos. Usa as ferramentas da
ClaudIA Clima: a tabela mensal desde 1998, o ano em curso e, em uma janela de
dias que o usuário escolhe, o dia a dia de vários anos. Um script confere a
transcrição contra os totais da ferramenta antes de calcular e entrega
tabelas, gráficos e PDF. Os cortes e as regras (dia seco, veranico,
milímetros do decêndio, início e fim das águas, base dos graus-dia) são do
usuário: a skill pergunta, não escolhe. É descrição do registro, não
previsão: não recomenda data de plantio, cultura nem manejo e não substitui
o ZARC. Acione com "quando costuma firmar a chuva", "em quantos anos teve
veranico em janeiro", "chance de chuva por decêndio", "início das águas",
"graus-dia da safra" ou quando o usuário pedir o histórico de chuva para
decidir uma data.
---
# Chuva para decisão
O usuário tem uma decisão que depende da chuva (a janela de plantio, a
safrinha, uma aplicação, a colheita) e quer saber como a chuva se comportou
naquela época nos outros anos. A skill entrega, sempre como **contagem de
anos** ("em 7 de 10 anos"):
1. o **calendário da chuva**: por mês, a mediana, a faixa onde ficou a maioria
dos anos, o menor e o maior com o ano; o total de cada ano agrícola; o mês
em que as águas firmaram e terminaram; os graus-dia;
2. o **ano em curso** ao lado dos outros, com as frases da ferramenta;
3. a **janela dia a dia** que ele escolher, em vários anos: chuva por decêndio,
veranicos, a data em que as águas firmaram e, noutra janela, a data em que
terminaram;
4. o relato em texto, as tabelas em CSV, os gráficos e um **PDF**.
Quem produz o dado são as ferramentas do conector ClaudIA Clima. Quem faz as
contas é o script `scripts/chuva.py`, a partir do texto que as ferramentas
devolveram.
## A regra que vale para tudo: descrição, não previsão
- Diga sempre "em k de N anos", com os anos. Não converta em "chance de 70%",
"probabilidade", "risco alto" ou "risco baixo".
- NUNCA diga quanto vai chover, que o ano será igual a outro, nem que uma data
é a certa, a ideal, a melhor ou a segura. Não recomende data de plantio,
cultura, cultivar, ciclo nem manejo. A decisão é do responsável técnico.
- Se o usuário pedir a conclusão ("planto dia 10?"), entregue as contagens e
devolva a decisão a ele.
- Amostra pequena: 10 a 28 anos mostram o que é comum, não o que é raro. "Em 0
de 10 anos" não quer dizer que não acontece. Diga isso junto do resultado.
- **Os números das regras são do usuário.** Dia seco, tamanho do veranico,
cortes de milímetros, regra do início e do fim das águas, base dos
graus-dia: mostre os valores de uso comum, pergunte e use o que ele
disser. O script recusa calcular sem eles.
- O relato não é o Zoneamento Agrícola de Risco Climático (ZARC) e não o
substitui.
- Cada número vai com a fonte, nas palavras da ferramenta.
## O que precisa estar disponível
- **Conector ClaudIA Clima**, com `clima_historico` e `contexto_chuva`. Sem
ele, avise e pare.
- **Ambiente que roda Python** com `numpy` e `matplotlib`. Sem ele, entregue só
o que as ferramentas dizem (o resumo de cada chamada e as frases do ano em
curso) e avise que as contagens entre anos não foram feitas. Não conte de
cabeça.
- **O local**: fazenda salva na conta (`listar_fazendas` mostra os nomes),
perímetro (GeoJSON, KML ou WKT) ou latitude e longitude. Use o MESMO local
em todas as chamadas.
## Antes de chamar: as perguntas (em uma mensagem só)
1. **O local** e o nome dele para o título.
2. **A decisão**: o que ele quer decidir e em que época do ano. Daí sai quais
blocos fazer; não faça os quatro se ele só quer um.
3. **A janela dia a dia**, se a pergunta for de decêndio, veranico ou data das
águas: o dia e o mês de início e de fim (a mesma em todos os anos), com até
92 dias de preferência, e **quantos anos**. O padrão são as 10 últimas
janelas já encerradas; aceite de 5 a 20. Para a data do início das águas, a
janela precisa começar ainda na seca e terminar pelo menos 30 dias depois
da data mais tardia que ele espera.
4. **As regras**, só as dos blocos pedidos:
- dia seco: abaixo de quantos milímetros (uso comum: 1 ou 2 mm);
- veranico: quantos dias seguidos (uso comum: 7, 10 e 15);
- corte do decêndio, em mm (depende da cultura e do solo: 10, 20, 30);
- início das águas: quantos mm, em quantos dias, e quantos dias secos
seguidos nos dias seguintes anulam o início (uso comum: 20 mm em 1 a 3
dias, sem 7 a 10 dias secos nos 30 dias seguintes);
- fim das águas: quantos dias secos seguidos (uso comum: 15 a 20);
- mês de águas, para a regra mensal: quantos mm (uso comum: 100);
- graus-dia: a temperatura-base da cultura, o mês do plantio, o mês final
e, se quiser, o alvo.
5. **Onde o ano agrícola começa**: julho serve para onde a seca é no inverno.
Onde a chuva é de inverno, ou no extremo norte, pergunte.
O que ele já disse, não pergunte de novo. Se ele não souber um número, mostre
os de uso comum e peça que escolha; não escolha por ele.
## A conta das consultas (diga antes de chamar)
Cada chamada conta uma consulta de clima da conta do usuário, e o texto de cada
resposta ocupa a conversa.
| Bloco | Chamadas | Tamanho do texto |
|---|---|---|
| Tabela mensal desde 1998 | 1 | cerca de 12 mil tokens |
| Ano em curso | 1 | pequeno |
| Janela dia a dia | 1 por ano | cerca de 3 mil tokens por ano em uma janela de 77 dias |
| Janela do fim das águas | 1 por ano | idem |
Some, diga o total ("são 12 consultas") e só chame com o de acordo dele. Dez
anos de uma janela de até 92 dias cabem bem; para mais anos, encurte a janela.
Se a ferramenta recusar por limite, repita o motivo como ela disse e ofereça
menos anos.
## Fluxo de trabalho (siga nesta ordem)
1. **Tabela mensal.** `clima_historico` com `escala` = `mes`, `data_inicio` no
dia 1º do mês em que o ano agrícola começa (`1998-07-01` quando começa em
julho) e `data_fim` no último dia do último ano agrícola já encerrado. Se
houver graus-dia, passe `base_gdd_c` com a base que o usuário informou.
Grave em `mensal.txt` as linhas `Chuva — ...`, `RESUMO` e `TEMPERATURA` como
vieram e uma linha por mês (formatos em `references/arquivos.md`). No fim
de cada arquivo que você gravar, cole o bloco "FONTES DOS DADOS" da
resposta, como veio: é dele que o relato tira a fonte de cada dado.
2. **Ano em curso**, só se a decisão é para a safra que está começando ou em
andamento: `contexto_chuva` no mesmo local. Grave as frases em
`contexto.txt` e repasse como vieram.
3. **Janela dia a dia.** Uma chamada de `clima_historico` por ano, com
`escala` = `dia` e as MESMAS datas de dia e mês em todos os anos. As
chamadas podem ir juntas. O ano em andamento fica de fora: a ferramenta
corta o período e a janela dele sai diferente das outras. De cada
resposta, grave em `janela.txt` as linhas `Chuva — ...`, `RESUMO` e `AGRO`
**como vieram** e os milímetros de cada dia, na ordem, em linhas `mm:`.
Copie os números como a ferramenta escreveu. Dia "SEM DADO" vira `SD`.
4. **Janela do fim das águas**, se pedida: do mesmo jeito, noutro arquivo
(`janela_fim.txt`), com a janela do fim da estação.
5. **Confira antes de calcular**:
`python scripts/chuva.py --conferir --mensal mensal.txt --janela janela.txt`
O script confere cada ano contra o que a ferramenta informou (número de
dias, total, dia da maior chuva e veranico máximo) e mostra o que leu. Se
recusar, releia a resposta da ferramenta daquele ano e corrija a
transcrição. NUNCA altere um valor só para a soma fechar.
6. **Mostre a conferência ao usuário e confirme as regras** que faltarem.
7. **Calcule**, com as regras dele:
```
python scripts/chuva.py --mensal mensal.txt --corte-mes 50,100 --firme-mm 100 \
--gdd-de 10 --gdd-ate 2 --gdd-alvo 1400 \
--janela janela.txt --seco-mm 2 --veranico-dias 7,10,15 --corte-decendio 20,40 \
--inicio-mm 20 --inicio-dias 3 --falso-dias 10 --falso-janela 30 \
--janela-fim janela_fim.txt --fim-dias 15 \
--contexto contexto.txt --local "Fazenda X" --saida saida_chuva
```
Os números acima são exemplo de sintaxe. Use só os blocos pedidos; cada
bloco é independente.
8. **Entregue**: o relato que o script imprime (as frases já vêm no formato
certo; não reescreva em tom de previsão), o `relatorio.pdf` e os CSV.
Abra o PDF e olhe antes de entregar.
9. **Repita os avisos** que vierem na seção "Avisos" do relato e os da
ferramenta, com as palavras dela: a confiança da chuva, os dias que "ainda
podem ser revisados", a linha `AVISOS`.
## Como ler o que sai
- **Calendário mensal**: "P20 a P80" é a faixa onde ficaram cerca de 6 de cada
10 anos. Nos meses secos, valores pequenos e repetidos de um ano para outro
são o piso do dado mensal; não leia diferença entre eles.
- **Regra mensal das águas**: só diz o mês. Para a data, use a janela.
- **Decêndio**: contam só os decêndios inteiros dentro da janela.
- **Veranico**: é a sequência seca DENTRO da janela, pela régua do usuário. Se
encosta na borda, pode ter sido maior; a tabela marca. O "veranico máximo"
que a ferramenta informa usa a régua dela e vai ao lado, na tabela.
- **Início das águas**: "sem conferência" quer dizer que a regra fechou perto
do fim da janela e faltaram dias para ver se era falso início; esse ano fica
fora da contagem. Se acontecer em vários anos, a janela está curta.
- **Tabela mensal e janela não se misturam.** Os milímetros da chamada longa
(mensal) e os da chamada curta (dia a dia) saem de réguas diferentes da
ferramenta e não fecham entre si. Compare ano com ano dentro de cada bloco.
- A "média histórica" e o "→ %" que a ferramenta devolve em uma janela curta
não entram no relato: a skill compara os anos entre si.
## O que a skill não faz
- Não prevê chuva e não diz quando plantar, o que plantar nem como manejar.
- Não consulta o ZARC, a previsão do tempo nem a janela de pulverização (a
previsão é das ferramentas `previsao_dias` e `previsao_horas`).
- Não faz balanço hídrico: chuva sem a evapotranspiração e a água do solo não
diz se faltou água para a planta.
- Não trabalha com mais de um local por vez nem com janela acima de 180 dias.
- Não chama a ferramenta de novo para "melhorar" um resultado e não completa
ano que faltou com estimativa.
## Fontes dos dados
A fonte de cada dado é a que a ferramenta escreve no bloco "FONTES DOS DADOS",
no fim de cada resposta. O script lê essas linhas dos arquivos e as põe no fim
do relato, inteiras e como vieram, dizendo de que parte é cada uma quando
mudam (a do ano em curso não é igual à da tabela mensal); se o bloco não foi
colado, ele avisa e você corrige o arquivo antes de entregar. Não troque por
um nome genérico, não acrescente fonte que a ferramenta não informou e não
descreva como os dados são combinados nem processados: não cite plataforma,
biblioteca, nuvem nem modelo. Se o usuário perguntar como é feito, o
processamento é das ferramentas da comunidade agrônomo10X (OagronomIA) e não é
divulgado.
As regras, as fórmulas e os limites: `references/metodo.md`. O formato dos
arquivos: `references/arquivos.md`.
Files in this skill
- README.md
- SKILL.md
- references/arquivos.md
- references/metodo.md
- scripts/chuva.py
- scripts/janela.py
- scripts/leitura.py
- scripts/mensal.py
- scripts/relato.py
- scripts/saidas.py
- scripts/sintetico.py
Attribution
Related skills
View all in ai-agents →Comments
Loading comments…
Newsletter
Get the weekly list of safe new skills, and the ones we pulled.