Skip to content

Enxugar a skill da taiga-cli - #19

Merged
cedric-lamalle merged 3 commits into
mainfrom
skill-enxuta
Oct 5, 2026
Merged

cedric-lamalle merged 3 commits into
mainfrom
skill-enxuta

Conversation

@cedric-lamalle

Copy link
Copy Markdown
Member

Sem story no Taiga: o uso do Claude Code atribuiu 13% do consumo à skill taiga-cli, e o SKILL.md é carregado inteiro a cada uso (Claude Code, Codex e opencode). Este PR reduz o arquivo sem mudar o comportamento do agente.

model/effort no frontmatter foram descartados de propósito: trocar de modelo no meio do turno perde o cache de prompt, e o Codex e o opencode ignoram esses campos.

O que muda

arquivo antes depois
skills/taiga-cli/SKILL.md 181 linhas / 14.971 B 132 linhas / 8.079 B (-46%)
references/conferencia.md (novo) — 4.902 B
references/comandos.md (novo) — 3.490 B
references/instalacao.md 4.231 B inalterado
  • Fica no SKILL.md: decidir pelo code e não pelo exit; escrita incerta tratada como gravada; todas as proibições de autenticação; CLI antes do MCP; --dry-run antes de lote; taiga api não confere escritas; "seguro repetir"; os comandos mais comuns.
  • references/conferencia.md: a tabela "gravado ou talvez gravado" e as exceções que convergem, literais. O SKILL.md manda abri-la antes do próximo comando em qualquer *_unconfirmed, write_applied, *_postcondition_failed, *_link_failed, epic_replace_incomplete, project_apply_interrupted ou project_changed.
  • references/comandos.md: a tabela de comandos completa, literal, mais escrita com version, board da Basis e taiga api. Aberta antes de montar comando de anexo, campo, épico, swimlane, project plan|apply ou taiga api; a exceção vale só para executar um comando com as flags já escritas na conferência (escrita residual, como field set --unset, exige comandos.md ou --help).
  • Cortado: duplicações entre topo e referências, a tabela de autenticação por código (quase todas as linhas diziam "pare e peça login"), histórico ("desde a US #274") e o que já está no --help/README.

Frontmatter idêntico (name e description, mesmos gatilhos). Nenhum link do repositório aponta para âncoras removidas.

Conferência

  • Cenários de pressão (método da superpowers:writing-skills), subagentes respondendo sem executar taiga, versão antiga × nova: update incerto com pressa para repetir; session_expired com senha à vista; version_conflict; CLI e MCP juntos; caminho feliz; story_created_link_failed; epic_replace_incomplete com DELETE recusado; field_values_postcondition_failed exigindo --unset. A versão nova cumpriu as regras de segurança em todos. Limites: 1 a 2 amostras por cenário, respostas declaradas sem transcript de chamadas; ramos raros não amostrados.
  • Revisão adversarial (Codex) em 3 rodadas: R1 epic_replace_incomplete fora do gatilho (bloqueante, corrigido); R4 exceção do gatilho de comandos.md ampla demais (bloqueante, corrigido); duplicações e avaliação dos cenários (não bloqueantes, corrigidos). Rodada 3 aprovada sem achados. A revisão conferiu as 20 linhas de conferência e as 12 de comandos literalmente preservadas, os comandos e flags contra o --help e o código, e os links.

Depois do merge

  • npx skills update --global --yes para a cópia instalada sair da versão de 14,9 KB.

@cedric-lamalle
cedric-lamalle merged commit 51ca290 into main Oct 5, 2026
2 checks passed
@cedric-lamalle
cedric-lamalle deleted the skill-enxuta branch October 5, 2026 12:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant