@andespindola/crow-skills 0.6.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Skills com escopo explícito, conhecimento especializado preservado e fluxos comuns reutilizáveis.
|
|
4
4
|
|
|
5
|
-
**Versão 0.6.
|
|
5
|
+
**Versão 0.6.1** ([mudanças](CHANGELOG.md)): crow-behaviour mostra o progresso na própria conversa e no plano nativo do host, sem abrir janela ou painel. A 0.6.0 trouxe as regras de entrega das 32 skills especialistas, a partir da [validação no Codex](docs/evaluations/2026-10-26-codex.md).
|
|
6
6
|
|
|
7
7
|
**Reconstrução em andamento.** A primeira versão com 32 contratos genéricos não atende à preservação de capacidades solicitada. Não use esse número nem o mapeamento por categoria como prova de substituição das originais. A revisão passa a abranger cada definição e seus recursos, modos e dependências, sem número fixo de skills ou limite artificial de linhas. Veja [critérios e progresso](docs/reconstruction.md).
|
|
8
8
|
|
|
@@ -30,7 +30,7 @@ Exemplos:
|
|
|
30
30
|
O pacote de cada skill é somente sua pasta em `skills/`. O [CLI crow-skills](docs/cli.md) instala cópias completas e versionadas em agentes/escopos explícitos, com preview, saída JSON, detecção de conflitos e recuperação. Requer Python 3.10+; Git para fontes em clone, Node 18+ para o launcher npm; mutações em macOS/Linux. A distribuição npm privada `@andespindola/crow-skills` inclui um snapshot completo das skills, sem clone ou hooks que as instalem automaticamente. Em `--global`, instalar a crow-behaviour também grava o guia aditivo do agente (claude, codex, gemini, devin) para usar as skills; `--no-guide` desliga. As integrações de interface (status line do Claude Code e do Codex, segmento tmux) seguem o mesmo fluxo, preservando a configuração existente; `--no-integrations` desliga.
|
|
31
31
|
|
|
32
32
|
```sh
|
|
33
|
-
npm install -g @andespindola/crow-skills@0.6.
|
|
33
|
+
npm install -g @andespindola/crow-skills@0.6.1
|
|
34
34
|
crow-skills progress
|
|
35
35
|
./bin/crow-skills list
|
|
36
36
|
./bin/crow-skills install crow-behaviour --agents claude,codex --global --dry-run
|
package/crow_skills/__init__.py
CHANGED
package/docs/cli.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# crow-skills CLI 0.6.
|
|
1
|
+
# crow-skills CLI 0.6.1
|
|
2
2
|
|
|
3
3
|
CLI local-first para humanos e agentes. Python 3.10+, sem bibliotecas Python externas; Git é necessário para fontes em clone, não para o snapshot npm. O launcher npm requer Node 18+. Mutações suportadas em macOS/Linux (locks POSIX). Não instala o agente, não executa scripts das skills e não muda modelos, prompts base ou permissões. Instruções de uso das skills (o guia do agente, abaixo) são gravadas pelo comando `guide` e, por padrão, por `install`/`update`/`uninstall` em `--global` quando a crow-behaviour fica instalada para um agente com mecanismo verificado; `--no-guide` desliga isso. Os mesmos comandos também aplicam as [integrações de interface](#integrações-de-interface-integrations) (status line do Claude Code e do Codex, segmento tmux); `--no-integrations` desliga. `crow-skills progress` mostra o [painel de progresso](#progresso-progress) da execução crow-behaviour ativa.
|
|
4
4
|
|
|
@@ -31,7 +31,7 @@ Para testar/distribuir o arquivo local sem registry:
|
|
|
31
31
|
|
|
32
32
|
```sh
|
|
33
33
|
npm pack
|
|
34
|
-
npm install -g ./andespindola-crow-skills-0.6.
|
|
34
|
+
npm install -g ./andespindola-crow-skills-0.6.1.tgz --ignore-scripts
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
O pacote contém o CLI Python e todas as skills do commit, com `release.json` de hashes. Não requer acesso ao GitHub ou clone para list/install. O launcher Node encaminha argumentos sem shell para Python em modo isolado, evitando imports pelo diretório do chamador/PYTHONPATH. `CROW_SKILLS_PYTHON` pode apontar para outro executável Python 3.10+. Não há dependências npm nem hooks de instalação que instalem skills automaticamente.
|
package/package.json
CHANGED
package/release.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"README.md": {
|
|
4
4
|
"executable": false,
|
|
5
5
|
"kind": "file",
|
|
6
|
-
"sha256": "
|
|
6
|
+
"sha256": "fe964a6eae4cfd2eafaaa3a21e6a5992a74c5c36899ae2d5e614f8960d0c5283"
|
|
7
7
|
},
|
|
8
8
|
"bin/npm-crow-skills.cjs": {
|
|
9
9
|
"executable": true,
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"crow_skills/__init__.py": {
|
|
19
19
|
"executable": false,
|
|
20
20
|
"kind": "file",
|
|
21
|
-
"sha256": "
|
|
21
|
+
"sha256": "3c04bdefdd487772917f0ebf729c9f7248b4ee2c4900b40f0e11380ac6e2fa84"
|
|
22
22
|
},
|
|
23
23
|
"crow_skills/__main__.py": {
|
|
24
24
|
"executable": false,
|
|
@@ -73,12 +73,12 @@
|
|
|
73
73
|
"docs/cli.md": {
|
|
74
74
|
"executable": false,
|
|
75
75
|
"kind": "file",
|
|
76
|
-
"sha256": "
|
|
76
|
+
"sha256": "cbffcfdcb59182bf7c857ceeb336df108a67d2b2ba235eb1e393a3993320b992"
|
|
77
77
|
},
|
|
78
78
|
"package.json": {
|
|
79
79
|
"executable": false,
|
|
80
80
|
"kind": "file",
|
|
81
|
-
"sha256": "
|
|
81
|
+
"sha256": "b73c4f3f6b1381e9fdf8d988cc4e95888e4ecc72af23b99f5202ee8e6605ad0b"
|
|
82
82
|
},
|
|
83
83
|
"skills/crow-accessibility/SKILL.md": {
|
|
84
84
|
"executable": false,
|
|
@@ -108,7 +108,7 @@
|
|
|
108
108
|
"skills/crow-behaviour/SKILL.md": {
|
|
109
109
|
"executable": false,
|
|
110
110
|
"kind": "file",
|
|
111
|
-
"sha256": "
|
|
111
|
+
"sha256": "0e1360266fb7b5943f4fc0f9710b2294db08e14400a742d441deb23567a0ea2b"
|
|
112
112
|
},
|
|
113
113
|
"skills/crow-behaviour/agents/openai.yaml": {
|
|
114
114
|
"executable": false,
|
|
@@ -128,7 +128,7 @@
|
|
|
128
128
|
"skills/crow-behaviour/references/progress-ledger.md": {
|
|
129
129
|
"executable": false,
|
|
130
130
|
"kind": "file",
|
|
131
|
-
"sha256": "
|
|
131
|
+
"sha256": "70a03809def8c65fa1c6390d57158cfdcd553246c4a91382feb35927a84b3af9"
|
|
132
132
|
},
|
|
133
133
|
"skills/crow-behaviour/references/quality-patterns.md": {
|
|
134
134
|
"executable": false,
|
|
@@ -631,7 +631,7 @@
|
|
|
631
631
|
"sha256": "4b921ea30ae9b731b5210581873e3d180e830cadfdc02bdbb5b3419ec39baaab"
|
|
632
632
|
}
|
|
633
633
|
},
|
|
634
|
-
"revision": "
|
|
634
|
+
"revision": "15319b7830b484cb0c2f32ff54506ae589d7f85d",
|
|
635
635
|
"schema_version": 1,
|
|
636
|
-
"version": "0.6.
|
|
636
|
+
"version": "0.6.1"
|
|
637
637
|
}
|
|
@@ -40,7 +40,7 @@ Leia [padrões e critérios de conclusão](references/quality-patterns.md) quand
|
|
|
40
40
|
- Um responsável por arquivo ou recurso mutável em cada momento. Antes de escrita concorrente, use isolamento suportado e autorizado ou ownership disjunto. Não crie clones/worktrees por suposição. Sem isolamento seguro, serialize.
|
|
41
41
|
- O principal pode avançar uma unidade independente enquanto aguarda, mas não refazer em paralelo a mesma unidade atribuída ao worker. Reatribua explicitamente se o executor falhar ou ficar indisponível.
|
|
42
42
|
- Não deixe trabalhadores dispararem novas equipes sem escopo e limite atribuídos. Cancele trabalho obsoleto e aguarde processos relevantes antes de reiniciar ou declarar conclusão.
|
|
43
|
-
- Mantenha o ledger de progresso: o coordenador é o único que grava; registre cada unidade ao iniciar e ao terminar, mostre o
|
|
43
|
+
- Mantenha o ledger de progresso: o coordenador é o único que grava; registre cada unidade ao iniciar e ao terminar, mostre o progresso na própria conversa (plano no início, resumo compacto a cada transição de fase, linha curta quando algo muda) e, se o host tiver uma ferramenta nativa de plano/tarefas, espelhe nela as mesmas unidades. Nunca abra janela, painel ou outro processo para exibir progresso; veja [ledger de progresso](references/progress-ledger.md).
|
|
44
44
|
|
|
45
45
|
### 4. Verifique antes de sintetizar
|
|
46
46
|
|
|
@@ -72,7 +72,7 @@ Entregue o resultado pedido, apoiado pelo **execution-ledger**: cobertura de req
|
|
|
72
72
|
- Relate o modo real quando relevante: workflow, subagentes ou sequencial. Não atribua trabalho a agentes que não existiram.
|
|
73
73
|
- Não declare implementação testada porque um revisor aprovou, nem deploy porque testes passaram.
|
|
74
74
|
- Registre o que ficou de fora e por quê; nenhum corte silencioso.
|
|
75
|
-
- Ao terminar, feche o ledger (`done`, `failed` ou `cancelled`),
|
|
75
|
+
- Ao terminar, feche o ledger (`done`, `failed` ou `cancelled`), marque as unidades no plano nativo do host e não deixe mutações/trabalhadores pendentes sem responsável informado.
|
|
76
76
|
|
|
77
77
|
## Limites e composição
|
|
78
78
|
|
|
@@ -66,17 +66,15 @@ Sem Python ou sem acesso ao script, escreva o JSON acima diretamente com as ferr
|
|
|
66
66
|
|
|
67
67
|
## O que mostrar ao usuário
|
|
68
68
|
|
|
69
|
-
|
|
70
|
-
- Se o host tiver ferramenta nativa de plano ou tarefas, espelhe nela as mesmas unidades e estados; algumas interfaces mostram esse plano na barra de status.
|
|
71
|
-
- Tarefa grande (várias fases ou muitas unidades) rodando dentro do tmux (`$TMUX` definido): abra um painel lateral com o painel ao vivo e feche-o ao terminar. Use `crow-skills progress --watch` se o comando existir no PATH; ele mostra também tokens lidos dos logs do host e sai sozinho após o fim da execução.
|
|
69
|
+
O progresso aparece na própria conversa, exibido pelo agente que está trabalhando. Nunca abra janela, painel, aba, terminal, navegador ou outro processo para mostrar progresso (nada de `tmux split-window`, `new-window` ou `crow-skills progress --watch` em outro painel), nem peça ao usuário para abrir um.
|
|
72
70
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
71
|
+
- **Início:** ao começar uma tarefa substantiva, mostre o plano em poucas linhas: fases, unidades e o que será entregue.
|
|
72
|
+
- **Plano nativo do host:** se o host tiver ferramenta de plano ou tarefas (lista de tarefas, plano de etapas), espelhe nela as mesmas unidades e mantenha os estados em dia: uma unidade em andamento por responsável, concluída assim que tiver evidência. É o jeito preferido de mostrar progresso contínuo, porque a interface do próprio host o exibe sem outra janela.
|
|
73
|
+
- **Transições:** a cada transição de fase e no fim, inclua no chat o resumo compacto (`crow_ledger.py show`): árvore de fases e unidades com barras ASCII. Não repita o resumo a cada unidade.
|
|
74
|
+
- **Entre transições:** uma linha curta quando uma unidade demorada começa ou termina, ou quando algo muda o plano (falha, achado, decisão pendente). Em espera longa (job em segundo plano, workflow, CI), diga o que está rodando e quando vai checar de novo.
|
|
75
|
+
- **Proporção:** o progresso informa, não substitui a resposta. Sem transcrição de coordenação, sem resumo repetido e sem barra inventada.
|
|
78
76
|
|
|
79
|
-
Não
|
|
77
|
+
Não instale nada para exibir progresso.
|
|
80
78
|
|
|
81
79
|
## Limites
|
|
82
80
|
|