Skip to content

Adicionar a skill da taiga-cli TG-254 - #18

Merged
cedric-lamalle merged 3 commits into
mainfrom
TG-254
Oct 4, 2026
Merged

cedric-lamalle merged 3 commits into
mainfrom
TG-254

Conversation

@cedric-lamalle

@cedric-lamalle cedric-lamalle commented Oct 4, 2026 •

Copy link
Copy Markdown
Member

US #254, parte A (só este repositório). A parte B, a migração da basis-ci-gitlab no BasisTI/skills, vem depois da release v0.3.0.

O que entra

  • skills/taiga-cli/SKILL.md (PT-BR), instalável com npx skills add BasisTI/taiga-cli, ensina agentes a usar a CLI:
    • qual comando curado usar;
    • decidir pelo code do erro, não pelo exit;
    • --dry-run antes de escrita em lote, e taiga api como saída de emergência;
    • nos erros de autenticação, parar e pedir o login à pessoa (D8): o agente nunca pede senha, nunca usa TAIGA_PASSWORD ou TAIGA_TOKEN e nunca move o state dir (D9);
    • para cada código "gravado ou talvez gravado" de docs/errors.md, a conferência antes de repetir, e as duas exceções que convergem (epic_link_unconfirmed e epic_replace_incomplete);
    • a CLI tem precedência sobre o MCP do Taiga, e não é aconselhado ter os dois (D6).
  • skills/taiga-cli/references/instalacao.md cobre:
    • o binário em ~/.local/bin, com o tar.gz da release conferido pelo SHA256SUMS como caminho principal e go install …@v0.3.0 como alternativa (D7, D12);
    • a config do Codex;
    • o keyring headless, como resumo com link para o README;
    • o completion (Redigir tokens na saída do completion TG-273 #17).
  • docs/examples/taiga-project.toml: o cabeçalho passa a declarar a convenção canônica do fluxo da basis-ci-gitlab (linha 9 da tabela D5). Os dados não mudam.
  • README.md e docs/guia.md apontam para a skill e para a instalação em ~/.local/bin. O guia também perdeu dois trechos desatualizados: "comandos curados ainda não chegaram" e "task field vem com a #253".
  • docs/superpowers/plans/2026-10-04-fase-4-skill-e-migracao.md: o plano da fase 4, com as decisões D1–D14 e as duas decisões tomadas nos PRs Tratar redirect em escritas como resultado incerto TG-274 #16 e Redigir tokens na saída do completion TG-273 #17.

Conferência

  • Códigos: todo código citado na skill existe em docs/errors.md.
  • Comandos e flags: todo comando taiga e toda flag citados existem no --help de um binário compilado desta branch.
  • Links: links relativos e âncoras resolvem.
  • Skills CLI, offline e num diretório temporário:
    • npx skills add <caminho> --list encontra a skill taiga-cli;
    • npx skills add <caminho> -s taiga-cli --copy -y instala o SKILL.md e o references/.
  • Receita de instalação: testada com a v0.2.0, porque a v0.3.0 ainda não existe.
  • Revisão adversarial: não houve achado crítico. Os 2 achados importantes, sobre o recovery que sugere TAIGA_TOKEN e a edição da config do Codex, foram corrigidos no segundo commit, junto com os menores.

Depois do merge (Cedric)

  • Tag v0.3.0. Os comandos com v0.3.0 da skill e do README só funcionam depois dela.
  • npx skills add BasisTI/taiga-cli a partir do GitHub (D14).

Skill em skills/taiga-cli (PT-BR), instalável pelo skills CLI: comandos
curados, parar e pedir login nos erros de autenticação, e a conferência
de cada código gravado ou talvez gravado antes de repetir. O TOML de
exemplo passa a ser a convenção canônica do fluxo da basis-ci-gitlab;
README e guia apontam para a skill e para a instalação em ~/.local/bin.
Plano da fase 4 com as decisões D1-D14.
Nos erros de autenticação, a regra da skill vale mais que o recovery:
o agente não define TAIGA_TOKEN, não roda secret-tool nem
gnome-keyring-daemon e não edita a config do Codex; repassa a sugestão
à pessoa. Login completo com --username, --force-version só por decisão
da pessoa, --unset só para checkbox e date, project apply parcial com
exit 2, 5 ou 6, field set com valores iguais e versão saltada, e a
skill instalada com --global.
O bloco de instalação do README e da skill roda num subshell com
set -eu: download, checksum ausente ou FAILED e extração interrompem
antes de instalar. A linha do checksum é escolhida pela plataforma em
P, e o macOS sem sha256sum usa shasum. A skill é instalada e atualizada
com --global em todos os documentos, os exemplos com v0.3.0 avisam que
dependem da release, e a skill diz que o project apply pode reordenar
status existentes.
@cedric-lamalle
cedric-lamalle merged commit ec08751 into main Oct 4, 2026
2 checks passed
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