Repository navigation
Releases
Releases · LaBiOmicS/whoqol-toolkit
v0.3.0
Adicionado
- Catorze chaves de instrumento além do WHOQOL-BREF, entre elas: WHOQOL-OLD, EUROHIS-QOL 8 (também a partir de uma planilha do
WHOQOL-BREF), WHOQOL-HIV-BREF, WHOQOL-SRPB BREF, módulo WHOQOL-SRPB, WHOQOL-DIS para incapacidades físicas e
intelectuais (escalas de 3 pontos), WHOQOL-100, WHOQOL-HIV (120 itens) e WHOQOL-100 + SRPB. Regras transcritas dos
manuais da OMS e das sintaxes oficiais (distribuídas pelo grupo WHOQOL da UFRGS); textos dos itens em português
dos formulários brasileiros. - Modelo de instrumento generalizado: escores como média × multiplicador (soma no WHOQOL-OLD, DIS e EUROHIS),
domínios compostos pela média de facetas com facetas invertidas (24 − faceta), escores totais oficiais, escalas de
resposta por item (1–3 na versão ID do DIS), códigos de itens nos cabeçalhos (F1.1,F11,old_01,HBREF_1,
SP1.1,dis_01) e numeração do formulário. guide instruments(references/instruments.md): qual chave usar, fontes de cada regra, convenções adotadas onde
as fontes são omissas e divergências entre fontes (EUROHIS soma × média; F2.1 invertido por engano nas sintaxes
do WHOQOL-HIV e do SRPB; pontuação do DIS na sintaxe brasileira × manual da OMS; regra de ausentes do WHOQOL-100
no texto × na sintaxe). O guiascoringde cada instrumento traz as notas, e o rascunho de métodos declara as
convenções.- WHOQOL-DIS nos formulários brasileiros: itens nacionais Q40–Q43 pontuados como na sintaxe da UFRGS
(whoqol-dis-br,whoqol-dis-id-br) e versão por representante (proxy) para incapacidade intelectual
(whoqol-dis-id-proxy, escalas de 5 pontos, textos em terceira pessoa; Schmidt et al., 2010). whoqol-100-bref: os quatro domínios do WHOQOL-BREF calculados a partir de uma planilha do WHOQOL-100 ou do
WHOQOL-HIV (códigos do apêndice 8 do manual da OMS), para comparação com estudos que usaram o WHOQOL-BREF.- Textos em inglês das 100 questões do WHOQOL-100 (apêndice 4 do manual), reconhecidos nos cabeçalhos também no
WHOQOL-HIV e no WHOQOL-100 + SRPB. - AFC em Python por facetas nos instrumentos longos (escores das facetas como indicadores dos domínios) e figura de
respostas por item desenhada por domínio acima de 40 itens. - Testes de referência para cada instrumento, com as regras transcritas das fontes e respondentes calculados à mão.
Alterado
- O texto de métodos descreve a pontuação de cada instrumento (somas, facetas, mínimos por escore); o do
WHOQOL-BREF não muda. - Psicometria dos instrumentos longos: confiabilidade, análise multitraço e HTMT por faceta; AFC de segunda ordem
por itens no script lavaan. results.json:descriptives_raw_4_20passa a serdescriptives_raw, com a amplitude de cada escore.
v0.2.0
Alterado
- O whoqol-toolkit agora é um plugin de Claude Code e Antigravity no mesmo formato do academic-peer-review e do
congress-abstract-review: a skill rodaskills/whoqol/scripts/whoqol_cli.pycomuv run, que declara as
dependências (PEP 723). O pacote foi paraskills/whoqol/scripts/whoqol/e os guias metodológicos para
skills/whoqol/references/, onde o agente os lê diretamente. - Marketplace único
labiomics: omarketplace.jsondos três repositórios LaBiOmicS lista os três plugins, e
whoqol-toolkit@labiomicssubstituiwhoqol-toolkit@labiomics-whoqol. install.shno formato dos outros plugins: sem oagyno PATH, copia o plugin para
~/.gemini/antigravity-cli/plugins/.- READMEs reorganizados como os dos outros plugins (instalação por CLI, uso interativo e sem agente, custo).
- Python 3.14 suportado (a suíte de testes passa; o limite
<3.14foi removido).
Adicionado
- Regras de integridade: texto de interpretação e de métodos/resultados como rascunho assistido por IA, com aviso e
lembrete de declaração de uso de IA; idioma do relatório (rules/AGENTS.md). - Defesa contra conteúdo malicioso na planilha (
security.py): oinspectmostra cabeçalhos e valores limpos
(sem caracteres ocultos ou de controle bidirecional, com tamanho limitado) e lista emsecurity_flagsos que
parecem instruções a uma IA, em português, inglês e espanhol. Colunas podem ser indicadas pela posição (#n) em
--mapping,-g,-c,--covariatee--id-column. - Testes de referência da pontuação escritos a partir do manual da OMS, independentes da definição do instrumento:
respondente calculado à mão nos quatro domínios, itens invertidos, mínimo de itens válidos em cada domínio, média
dos itens respondidos, exclusão com menos de 21 itens e extremos da escala; testes da sanitização e do script de
entrada da skill.
Removido
- Servidor MCP (
whoqol-mcp,.mcp.json,mcp_config.json) e a dependênciamcp. - Extensão do Gemini CLI (
gemini-extension.json,commands/whoqol.toml) e o comando/whoqol; no Claude Code a
skill é chamada por/whoqol-toolkit:whoqolou pelo pedido em linguagem natural.