@andespindola/crow-skills 0.13.0 → 0.13.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 +1 -1
- package/catalog.json +1 -1
- package/crow_skills/__init__.py +1 -1
- package/crow_skills/guide.py +5 -3
- package/crow_skills/hook.py +5 -3
- package/docs/cli.md +3 -3
- package/package.json +1 -1
- package/release.json +13 -13
- package/skills/crow-behaviour/SKILL.md +18 -8
- package/skills/crow-behaviour/references/orchestration.md +1 -1
- package/skills/crow-behaviour/references/progress-ledger.md +4 -2
- package/skills/crow-behaviour/references/quality-patterns.md +1 -1
package/README.md
CHANGED
|
@@ -26,7 +26,7 @@ npm install -g @andespindola/crow-skills && crow-skills setup --yes
|
|
|
26
26
|
4. Entregue o artefato com alvo/revisão, evidência e pendências. Desconhecido não significa aprovado.
|
|
27
27
|
5. Carregue outra skill só quando houver decisão distinta a tomar. Handoffs são opcionais, não dependências ocultas.
|
|
28
28
|
|
|
29
|
-
Para adotar uma atuação mais coordenada em qualquer domínio, use `crow-behaviour`:
|
|
29
|
+
Para adotar uma atuação mais coordenada em qualquer domínio, use `crow-behaviour`: todo pedido que não seja conversa, pergunta factual curta ou ajuste trivial e local recebe plano, delegação suportada, verificação e síntese, mantidos nos prompts seguintes da sessão; só essas exceções continuam diretas. A skill adapta o comportamento às ferramentas reais, inclusive execução sequencial, sem depender do Workflow do Claude. Fora dessas exceções ela mantém um ledger de progresso (`.crow/runs/`) e mostra na conversa o bloco de processos no formato da lista de agentes do host (`● main …` e `○ dono atividade` por unidade em andamento); `crow-skills progress --watch` e as status lines mostram o mesmo. `crow-skills mode on|off` (ou `/crow on|off`) a liga ou desliga em todos os CLIs. Com várias sessões ou CLIs no mesmo repositório, ela lê o crow-broadcast (`crow-skills broadcast`) para não duplicar trabalho nem trocar a branch de um clone em uso, e reserva as áreas que delega. Ela não muda o modelo/effort. [Escopo e evidência](analysis/crow-behaviour.md).
|
|
30
30
|
|
|
31
31
|
Exemplos:
|
|
32
32
|
- Plataforma nova: `crow-platform` coordena; `crow-discovery` e `crow-spec` definem o que falta; as especialistas implementam/verificam por fatia.
|
package/catalog.json
CHANGED
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
{
|
|
37
37
|
"name": "crow-behaviour",
|
|
38
38
|
"title": "Atuação coordenada",
|
|
39
|
-
"description": "Use PROATIVAMENTE, sem o usuário pedir,
|
|
39
|
+
"description": "Use PROATIVAMENTE, sem o usuário pedir, em QUALQUER pedido que não seja conversa pura, pergunta factual curta ou ajuste trivial e local — inclusive quando é um arquivo só, uma decisão só ou só um plano: implementar uma feature, refatorar, depurar, auditar, revisar, migrar, planejar, pesquisar a fundo, tarefa multi-etapa, com exploração e decisões, ou que exija verificação antes de entregar. Carregue-a ANTES de começar; na dúvida, carregue. Nunca pergunte ao usuário se deve usá-la nem ofereça um critério mais estreito: com o modo crow ON a decisão já está tomada. Uma vez ativa, segue em uso nos prompts seguintes da sessão — mesmo plano, mesmo ledger e mesma validação por fases, retomados por conta própria quando faltarem. Ao ativar: decomponha o trabalho, delegue com as capacidades reais do runtime, verifique de forma adversarial e sintetize evidências. Não simule agentes nem altere permissões.",
|
|
40
40
|
"role": "coordinator",
|
|
41
41
|
"owns": "execution-ledger",
|
|
42
42
|
"next": []
|
package/crow_skills/__init__.py
CHANGED
package/crow_skills/guide.py
CHANGED
|
@@ -239,12 +239,14 @@ def render_body(agent, catalog, revision, skills):
|
|
|
239
239
|
"## Modo crow (liga/desliga)",
|
|
240
240
|
"- O usuário liga ou desliga a crow-behaviour para todas as sessões e CLIs com `crow-skills mode on|off` (ou `/crow on|off`). O estado fica em `~/.config/crow-skills/mode.json`; sem esse arquivo, o modo é ON.",
|
|
241
241
|
"- Obedeça ao modo vigente mais recente: o hook do crow-skills o informa a cada prompt numa linha `[crow-skills] modo crow: ON|OFF`. Sem essa linha (hook ausente ou não aprovado), leia o arquivo uma vez no início da sessão.",
|
|
242
|
-
"- ON é o modo de orquestração permanente: as regras abaixo valem para
|
|
242
|
+
"- ON é o modo de orquestração permanente: as regras abaixo valem para todo pedido que não seja conversa, até o usuário desligar, inclusive após compactação de contexto.",
|
|
243
|
+
"- Com ON a decisão já está tomada: nunca pergunte se deve usar a crow-behaviour nem ofereça um critério mais estreito; carregue e siga.",
|
|
243
244
|
"- OFF: não carregue nem aplique a crow-behaviour, salvo se o usuário a invocar explicitamente no pedido; as skills especialistas continuam disponíveis.",
|
|
244
245
|
"",
|
|
245
246
|
"## crow-behaviour: quando aplicar (modo ON)",
|
|
246
|
-
"-
|
|
247
|
-
"- Vale também quando a entrega é só um plano, um diagnóstico ou uma revisão, ou quando não há código no diretório: depurar, auditar, investigar, migrar ou planejar uma mudança
|
|
247
|
+
"- Qualquer pedido que não seja conversa pura, pergunta factual curta ou ajuste trivial e local — inclusive quando é um arquivo só, uma decisão só ou só um plano: carregue a skill crow-behaviour ANTES de começar, por iniciativa própria, sem esperar pedido. Para carregar, " + mech["load"] + "; por exemplo, " + invoke(name="crow-behaviour") + ". Siga-a até a entrega.",
|
|
248
|
+
"- Vale também quando a entrega é só um plano, um diagnóstico ou uma revisão, ou quando não há código no diretório: depurar, auditar, investigar, migrar ou planejar uma mudança continua entrando. Na dúvida, carregue.",
|
|
249
|
+
"- Uma vez ativa, ela segue em uso nos prompts seguintes da sessão: mesmo plano, mesmo ledger e mesma validação por fases, e cada novo pedido entra como unidade nova em vez de recomeçar sem registro. Se perceber que parou de mantê-los, retome na mesma resposta, registre a lacuna e siga — sem pedir permissão.",
|
|
248
250
|
"- Conversa, pergunta factual curta ou ajuste trivial e local: responda direto, sem carregá-la.",
|
|
249
251
|
"",
|
|
250
252
|
"## Skills especialistas",
|
package/crow_skills/hook.py
CHANGED
|
@@ -165,9 +165,11 @@ def indicator(mode, unicode=True):
|
|
|
165
165
|
def context_line(mode):
|
|
166
166
|
"""The additionalContext a prompt hook injects; short, so it costs little per prompt."""
|
|
167
167
|
if mode == "on":
|
|
168
|
-
return ("[crow-skills] modo crow: ON. Modo de orquestração permanente declarado pelo usuário: em
|
|
169
|
-
"
|
|
170
|
-
"
|
|
168
|
+
return ("[crow-skills] modo crow: ON. Modo de orquestração permanente declarado pelo usuário: em todo pedido desta "
|
|
169
|
+
"sessão que não seja conversa, pergunta factual curta ou ajuste trivial e local, carregue e siga a skill "
|
|
170
|
+
"crow-behaviour — na dúvida, carregue, e não pergunte ao usuário se deve usá-la. Uma vez ativa, ela segue "
|
|
171
|
+
"em uso nos prompts seguintes: mesmo plano, mesmo ledger e mesma validação por fases. Vale até o usuário "
|
|
172
|
+
"desligar com /crow off ou crow-skills mode off.")
|
|
171
173
|
return ("[crow-skills] modo crow: OFF. Não carregue nem aplique a skill crow-behaviour, salvo se o usuário a invocar "
|
|
172
174
|
"explicitamente neste pedido. Religar: /crow on ou crow-skills mode on.")
|
|
173
175
|
|
package/docs/cli.md
CHANGED
|
@@ -242,7 +242,7 @@ crow-skills guide status
|
|
|
242
242
|
crow-skills guide uninstall --agents codex --global --yes
|
|
243
243
|
```
|
|
244
244
|
|
|
245
|
-
`guide` grava, no mecanismo nativo e sempre carregado de cada CLI, instruções curtas em pt-BR para o agente usar as skills instaladas: obedecer ao [modo crow](#modo-crow-mode) vigente (anunciado pelo hook a cada prompt ou, sem hook, lido de `~/.config/crow-skills/mode.json`), carregar a crow-behaviour por iniciativa própria antes de
|
|
245
|
+
`guide` grava, no mecanismo nativo e sempre carregado de cada CLI, instruções curtas em pt-BR para o agente usar as skills instaladas: obedecer ao [modo crow](#modo-crow-mode) vigente (anunciado pelo hook a cada prompt ou, sem hook, lido de `~/.config/crow-skills/mode.json`), carregar a crow-behaviour por iniciativa própria antes de qualquer pedido que não seja conversa, pergunta factual curta ou ajuste trivial e local (e, na dúvida, carregar), mantendo-a em uso nos prompts seguintes, responder direto nessas exceções, consultar a lista de skills disponíveis no agente (crow ou não) e carregar a especialista pertinente pelo nome. O conteúdo é gerado do catálogo e das skills gerenciadas pelo CLI naquele agente, com a forma de invocação dele. Exige a crow-behaviour instalada para o agente.
|
|
246
246
|
|
|
247
247
|
Aplicação automática (padrão em `install`, `update` e `uninstall` com `--global`, desligada por `--no-guide`):
|
|
248
248
|
|
|
@@ -278,7 +278,7 @@ crow-skills progress --run ID --json # leitura por agente/automação
|
|
|
278
278
|
|
|
279
279
|
O painel começa pela lista de processos no formato da lista de agentes do host: `● main <atividade do coordenador>` e uma linha `○ <dono> <atividade>` por unidade em andamento de outro dono (o prefixo `subagent:` sai do nome). É o mesmo bloco que a crow-behaviour mostra na conversa (`crow_ledger.py show`) e que a status line do Claude Code e do Antigravity exibem abaixo da linha principal.
|
|
280
280
|
|
|
281
|
-
Lê o ledger `crow-run/1` que a crow-behaviour mantém
|
|
281
|
+
Lê o ledger `crow-run/1` que a crow-behaviour mantém fora de conversa, pergunta factual curta e ajuste trivial (formato em `skills/crow-behaviour/references/progress-ledger.md`): `$CROW_LEDGER`, `.crow/runs/*.json` no diretório atual e nos pais, e `~/.crow/runs/`. Sem `--run`, prefere execuções do diretório (ou de pais e filhos dele), depois as em andamento, depois a mais recente; um ledger `running` sem atualização há mais de 2 h conta como abandonado. Status line e tmux só mostram execuções do próprio diretório. Somente leitura; não inicia agentes.
|
|
282
282
|
|
|
283
283
|
Tokens vêm dos logs locais do próprio host, filtrados pela janela da execução (`startedAt` até `endedAt` ou agora) e pela sessão (`session.id` no ledger) ou, sem ela, pelo diretório de trabalho (marcado como aproximado, pois outras sessões no mesmo diretório e janela entram na soma). Só campos numéricos de uso são lidos e impressos; conteúdo de mensagens, prompts e credenciais nunca é exibido.
|
|
284
284
|
|
|
@@ -464,7 +464,7 @@ crow-skills mode on
|
|
|
464
464
|
crow-skills mode toggle --json
|
|
465
465
|
```
|
|
466
466
|
|
|
467
|
-
O modo é um interruptor único para a crow-behaviour em todos os CLIs. `on` (padrão, também quando o arquivo não existe) é o modo de orquestração permanente: o agente carrega e segue a crow-behaviour em
|
|
467
|
+
O modo é um interruptor único para a crow-behaviour em todos os CLIs. `on` (padrão, também quando o arquivo não existe) é o modo de orquestração permanente: o agente carrega e segue a crow-behaviour em todo pedido que não seja conversa, pergunta factual curta ou ajuste trivial e local, sem o usuário pedir e sem perguntar se deve usá-la, e a mantém em uso nos prompts seguintes da sessão. `off`: o agente não a carrega nem aplica, salvo se o usuário a invocar no pedido; as especialistas continuam disponíveis. O estado fica em `~/.config/crow-skills/mode.json` (`crow-mode/1`, gravação atômica com `updatedAt` e quem mudou).
|
|
468
468
|
|
|
469
469
|
Como cada CLI fica sabendo, sem reiniciar a sessão:
|
|
470
470
|
|
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": "b9b4b095f1b12c8319c12f5c20911fd3d0ff04367eb73ea09eedb9d60d17f9d9"
|
|
7
7
|
},
|
|
8
8
|
"bin/npm-crow-skills.cjs": {
|
|
9
9
|
"executable": true,
|
|
@@ -13,12 +13,12 @@
|
|
|
13
13
|
"catalog.json": {
|
|
14
14
|
"executable": false,
|
|
15
15
|
"kind": "file",
|
|
16
|
-
"sha256": "
|
|
16
|
+
"sha256": "0b642f85eaade70b30850e0dc58024b56135105a05be10afc6f786d85320abd7"
|
|
17
17
|
},
|
|
18
18
|
"crow_skills/__init__.py": {
|
|
19
19
|
"executable": false,
|
|
20
20
|
"kind": "file",
|
|
21
|
-
"sha256": "
|
|
21
|
+
"sha256": "0cbf5cfa07077525faa04b8d9c83e18c372d143d76f95629c1d28c934f2aacf9"
|
|
22
22
|
},
|
|
23
23
|
"crow_skills/__main__.py": {
|
|
24
24
|
"executable": false,
|
|
@@ -58,12 +58,12 @@
|
|
|
58
58
|
"crow_skills/guide.py": {
|
|
59
59
|
"executable": false,
|
|
60
60
|
"kind": "file",
|
|
61
|
-
"sha256": "
|
|
61
|
+
"sha256": "0d6fd0a026954f8d9b72bafcad204f1929f3b96f89f84e0bea1c0c5deda91cdc"
|
|
62
62
|
},
|
|
63
63
|
"crow_skills/hook.py": {
|
|
64
64
|
"executable": false,
|
|
65
65
|
"kind": "file",
|
|
66
|
-
"sha256": "
|
|
66
|
+
"sha256": "0a192d2104af6f743af5ec399eb4b0d6121f17694f32f2e9a4a1a42c36fb7b9e"
|
|
67
67
|
},
|
|
68
68
|
"crow_skills/integrations.py": {
|
|
69
69
|
"executable": false,
|
|
@@ -123,12 +123,12 @@
|
|
|
123
123
|
"docs/cli.md": {
|
|
124
124
|
"executable": false,
|
|
125
125
|
"kind": "file",
|
|
126
|
-
"sha256": "
|
|
126
|
+
"sha256": "88d12559d02a8266f832e25ff66f9494c7c68822d5a5a1101f65d289089a4d3c"
|
|
127
127
|
},
|
|
128
128
|
"package.json": {
|
|
129
129
|
"executable": false,
|
|
130
130
|
"kind": "file",
|
|
131
|
-
"sha256": "
|
|
131
|
+
"sha256": "e119d60f6cd9e89db147ff84b86fa07f2e2f7d0d9bd89bf658a2ec7db1caf6c1"
|
|
132
132
|
},
|
|
133
133
|
"skills/crow-accessibility/SKILL.md": {
|
|
134
134
|
"executable": false,
|
|
@@ -158,7 +158,7 @@
|
|
|
158
158
|
"skills/crow-behaviour/SKILL.md": {
|
|
159
159
|
"executable": false,
|
|
160
160
|
"kind": "file",
|
|
161
|
-
"sha256": "
|
|
161
|
+
"sha256": "1d50b438c6a005a425b2a5f284eb34e3e5f6cbab36269309b538f8bd5b1af5c8"
|
|
162
162
|
},
|
|
163
163
|
"skills/crow-behaviour/agents/openai.yaml": {
|
|
164
164
|
"executable": false,
|
|
@@ -183,7 +183,7 @@
|
|
|
183
183
|
"skills/crow-behaviour/references/orchestration.md": {
|
|
184
184
|
"executable": false,
|
|
185
185
|
"kind": "file",
|
|
186
|
-
"sha256": "
|
|
186
|
+
"sha256": "2bbab27b1f4e84efa1fedf045aa4a977e964f9389b551eca2ef9cad8afca8a8c"
|
|
187
187
|
},
|
|
188
188
|
"skills/crow-behaviour/references/processes.md": {
|
|
189
189
|
"executable": false,
|
|
@@ -193,12 +193,12 @@
|
|
|
193
193
|
"skills/crow-behaviour/references/progress-ledger.md": {
|
|
194
194
|
"executable": false,
|
|
195
195
|
"kind": "file",
|
|
196
|
-
"sha256": "
|
|
196
|
+
"sha256": "72044f37c557409ddccb4d7faa66a79aa090f36ba0e0372ed61d075ae03ebf6f"
|
|
197
197
|
},
|
|
198
198
|
"skills/crow-behaviour/references/quality-patterns.md": {
|
|
199
199
|
"executable": false,
|
|
200
200
|
"kind": "file",
|
|
201
|
-
"sha256": "
|
|
201
|
+
"sha256": "a0fa2ce6204d875c8807d22d3cc7b4975f7502efdb91cc7d222fcef0484357b2"
|
|
202
202
|
},
|
|
203
203
|
"skills/crow-behaviour/references/resources.md": {
|
|
204
204
|
"executable": false,
|
|
@@ -716,7 +716,7 @@
|
|
|
716
716
|
"sha256": "e37132ef8b060548191fbf14a5a18a9dd3acd84ea9a35e802174455b9e374d3d"
|
|
717
717
|
}
|
|
718
718
|
},
|
|
719
|
-
"revision": "
|
|
719
|
+
"revision": "c6536c7fc71784f9beac4c0dd5e675963af6c77d",
|
|
720
720
|
"schema_version": 1,
|
|
721
|
-
"version": "0.13.
|
|
721
|
+
"version": "0.13.1"
|
|
722
722
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: crow-behaviour
|
|
3
|
-
description: "Use PROATIVAMENTE, sem o usuário pedir,
|
|
3
|
+
description: "Use PROATIVAMENTE, sem o usuário pedir, em QUALQUER pedido que não seja conversa pura, pergunta factual curta ou ajuste trivial e local — inclusive quando é um arquivo só, uma decisão só ou só um plano: implementar uma feature, refatorar, depurar, auditar, revisar, migrar, planejar, pesquisar a fundo, tarefa multi-etapa, com exploração e decisões, ou que exija verificação antes de entregar. Carregue-a ANTES de começar; na dúvida, carregue. Nunca pergunte ao usuário se deve usá-la nem ofereça um critério mais estreito: com o modo crow ON a decisão já está tomada. Uma vez ativa, segue em uso nos prompts seguintes da sessão — mesmo plano, mesmo ledger e mesma validação por fases, retomados por conta própria quando faltarem. Ao ativar: decomponha o trabalho, delegue com as capacidades reais do runtime, verifique de forma adversarial e sintetize evidências. Não simule agentes nem altere permissões."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Atuação coordenada
|
|
@@ -11,19 +11,29 @@ Transforme o agente principal em responsável pelo resultado completo: ele defin
|
|
|
11
11
|
|
|
12
12
|
Pedido atual, alvo e revisão, critérios de sucesso, restrições, artefatos já válidos e ferramentas efetivamente expostas pelo runtime. Reutilize o contexto disponível; pergunte apenas por uma decisão material que não possa resolver com evidência.
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
## Vigência
|
|
15
|
+
|
|
16
|
+
Instalação torna a skill disponível, não garante que o host a carregue em todo turno. Quando selecionada/invocada, aplique este comportamento ao pedido em curso e ao que vier depois na sessão.
|
|
17
|
+
|
|
18
|
+
O interruptor é do usuário: o modo crow (`crow-skills mode on|off`, `/crow on|off`), informado pelo host a cada prompt como `[crow-skills] modo crow: ON` ou `OFF`; vale o anúncio mais recente. ON é a declaração de modo de orquestração permanente na sessão, inclusive após compactação de contexto. OFF desliga esta skill: não a aplique, salvo se o usuário a invocar explicitamente no pedido em curso. Não edite prompts globais, hooks ou configurações para forçar ativação nem altere o modo por iniciativa própria; só o usuário liga ou desliga.
|
|
19
|
+
|
|
20
|
+
Com o modo ON a decisão de usar esta skill já está tomada e não volta ao usuário. Nunca pergunte se deve carregá-la ou segui-la, nunca ofereça escolha entre aplicá-la e um critério mais estreito (do tipo "só quando for realmente multi-etapa") e nunca trate a ativação como a decisão material que o passo 2 manda perguntar: carregue e siga. Fora dela ficam apenas conversa, pergunta factual curta e ajuste trivial e local — pedidos que não exigem a análise que esta skill entrega. Qualquer outro entra, inclusive quando é um arquivo só, uma decisão só, ou quando a entrega é só um plano, um diagnóstico ou uma revisão. Não há outra dispensa: "já verifiquei nesta revisão" permite reusar a evidência registrada em vez de repetir o teste, nunca dispensar plano, ledger ou verificação do que ainda não foi verificado. Na dúvida sobre o tamanho do trabalho, aplique-a: o reconhecimento curto do passo 2 dimensiona o resto.
|
|
21
|
+
|
|
22
|
+
Uma vez ativa, permanece em uso até o usuário desligar o modo ou substituir este comportamento; ela não expira no fim do turno. Cada novo prompt do mesmo trabalho continua o mesmo plano, o mesmo ledger e a mesma verificação por fases, e um pedido novo abre sua própria unidade (ou sua própria execução, quando for outro trabalho) em vez de recomeçar sem registro. Interrupção do usuário, pergunta no meio, espera longa, falha de ferramenta e compactação de contexto não suspendem nada: releia o ledger e continue de onde parou.
|
|
23
|
+
|
|
24
|
+
Autoaudite-se a cada turno. Ao perceber que deixou de manter progresso contínuo, ledger ou validação por fases, retome na mesma resposta: releia o ledger — ou abra-o agora, registrando o que já foi feito — marque a lacuna como falha da execução, ponha o plano em dia e só então prossiga. Constatar a falha e seguir sem corrigi-la não cumpre esta skill, e retomar não depende de permissão; relate a lacuna no fechamento.
|
|
15
25
|
|
|
16
26
|
## Trabalho
|
|
17
27
|
|
|
18
28
|
### 1. Escolha a forma de atuação
|
|
19
29
|
|
|
20
|
-
- Atue solo apenas
|
|
21
|
-
- Em qualquer
|
|
22
|
-
- Leia [adaptação ao runtime](references/orchestration.md) ao escolher workflow, subagentes ou execução sequencial. Não presuma nomes de ferramentas, paralelismo ou suporte a isolamento. Se o host exigir opt-in explícito do usuário para orquestração programável, esta skill não é esse opt-in.
|
|
30
|
+
- Atue solo apenas nas exceções da Vigência: conversa, pergunta factual curta e edição mecânica trivial. Nesses casos, faça diretamente e verifique o necessário, sem equipe nem plano cerimonial. Trabalho já verificado nesta revisão não é uma quarta exceção: ele dispensa repetir a verificação registrada, não o plano nem o ledger. Na dúvida entre responder solto e orquestrar, orquestre.
|
|
31
|
+
- Em qualquer outro pedido, orquestre por padrão sempre que o runtime permitir: construa um plano executável, delegue unidades delimitadas e verifique com executores separados. Produção indivisível não dispensa verificação por executor separado.
|
|
32
|
+
- Leia [adaptação ao runtime](references/orchestration.md) ao escolher workflow, subagentes ou execução sequencial. Não presuma nomes de ferramentas, paralelismo ou suporte a isolamento. Se o host exigir opt-in explícito do usuário para orquestração programável, esta skill não é esse opt-in: peça o opt-in da ferramenta, nunca permissão para aplicar esta skill, e sem ele siga com subagentes ou sequencialmente.
|
|
23
33
|
|
|
24
34
|
### 2. Planeje para produzir e verificar
|
|
25
35
|
|
|
26
|
-
Defina o resultado observável e as perguntas ainda abertas. Para cada unidade necessária, estabeleça entrada, responsável, saída, dependências, efeitos permitidos e evidência de aceite. Esse quadro é o **execution-ledger**; em tarefa
|
|
36
|
+
Defina o resultado observável e as perguntas ainda abertas. Para cada unidade necessária, estabeleça entrada, responsável, saída, dependências, efeitos permitidos e evidência de aceite. Esse quadro é o **execution-ledger**; em toda tarefa fora das exceções da Vigência, mantenha-o também como arquivo de progresso conforme [ledger de progresso](references/progress-ledger.md), atualizado a cada transição de unidade. O ledger obedece aos efeitos permitidos: em tarefa somente leitura no diretório ou em clone compartilhado, grave-o fora dele (`~/.crow/runs` ou `$CROW_LEDGER`).
|
|
27
37
|
|
|
28
38
|
Antes de produzir, audite os requisitos recebidos: procure pares que se contradizem (por exemplo "rotear por tag" junto de "preservar caminhos legados"), casos limite não tratados (reinício, truncamento por orçamento, variações de caixa ou formato) e termos ambíguos. Resolva por evidência, escolha a leitura que preserva compatibilidade e registre a decisão; pergunte somente quando a contradição for material e não houver evidência que a decida. Executar um requisito contraditório sem registrar a escolha é falha de planejamento.
|
|
29
39
|
|
|
@@ -51,7 +61,7 @@ Leia [padrões e critérios de conclusão](references/quality-patterns.md) quand
|
|
|
51
61
|
|
|
52
62
|
Trate o retorno do executor como alegação até haver evidência. Confira alvo/revisão, reproduza ou inspecione os pontos críticos e resolva contradições pelas fontes, não por prestígio do agente.
|
|
53
63
|
|
|
54
|
-
Por padrão, salvo trabalho trivial ou
|
|
64
|
+
Por padrão, salvo trabalho trivial ou cuja verificação nesta mesma revisão já esteja registrada no ledger (reuse a evidência registrada, nunca a presuma), submeta cada achado ou alegação a vários verificadores independentes instruídos a refutar, cada um com uma lente distinta (corretude, segurança, desempenho, reprodução). O achado cai se a maioria refutar, salvo evidência reproduzível que resista às refutações; registre a divergência. Fontes derivadas da mesma origem contam como uma só.
|
|
55
65
|
|
|
56
66
|
Todo revisor ou verificador de um trabalho produzido nesta execução nasce SEM o histórico (contexto limpo) e recebe só os requisitos originais, a revisão alvo e os artefatos brutos; herdar o contexto do produtor só vale com justificativa registrada no ledger, e então o julgamento é rotulado como não independente. O brief do revisor ordena explicitamente tentar quebrar a entrega (não aprová-la) e só aceita achado com reprodução concreta (comando, teste ou trecho de fonte primária); achado sem reprodução é descartado. Toda mudança de comportamento passa por um passo de compatibilidade: o que um consumidor existente perde ou vê diferente? Reproduza contra a revisão base e contra a nova, e cubra variações de formato, reinício/persistência, limites de orçamento ou tamanho, e se o teste novo falharia caso o código novo fosse removido.
|
|
57
67
|
|
|
@@ -81,7 +91,7 @@ Entregue o resultado pedido, apoiado pelo **execution-ledger**: cobertura de req
|
|
|
81
91
|
|
|
82
92
|
## Limites e composição
|
|
83
93
|
|
|
84
|
-
Esta skill é uma camada de comportamento, não um motor de agentes. Não muda modelo, effort, limites de concorrência, sandbox, autorização ou recursos disponíveis. Instruções de maior prioridade e escolhas atuais do usuário continuam vigentes. Se o host impedir delegação, execute o que puder sequencialmente sem pedir permissão ritual nem tentar contornar o bloqueio. Se o host condicionar a orquestração programável ao opt-in do usuário, use subagentes, ou descreva o plano e o custo aproximado e peça o opt-in; nunca trate esta skill como autorização.
|
|
94
|
+
Esta skill é uma camada de comportamento, não um motor de agentes. Não muda modelo, effort, limites de concorrência, sandbox, autorização ou recursos disponíveis. Instruções de maior prioridade e escolhas atuais do usuário continuam vigentes. Se o host impedir delegação, execute o que puder sequencialmente sem pedir permissão ritual nem tentar contornar o bloqueio. Se o host condicionar a orquestração programável ao opt-in do usuário, use subagentes, ou descreva o plano e o custo aproximado e peça o opt-in; nunca trate esta skill como autorização. Esse pedido é sobre a ferramenta de orquestração: não o transforme em pergunta sobre aplicar ou não esta skill, e, com o opt-in negado ou indisponível, execute sequencialmente.
|
|
85
95
|
|
|
86
96
|
Ela decide **como coordenar a execução**, não a estratégia de produto nem as regras técnicas das especialistas. Um coordenador de plataforma continua dono do mapa de entrega; uma especialista continua dona de seu artefato; esta skill mantém apenas plano operacional, progresso e qualidade da integração. Use uma única cadeia de coordenação, não um coordenador novo para cada skill carregada.
|
|
87
97
|
|
|
@@ -10,7 +10,7 @@ Leia ao definir o modo de execução. Use somente capacidades realmente disponí
|
|
|
10
10
|
| Subagentes/tarefas delegadas | O principal mantém o plano e distribui unidades delimitadas. Use só a concorrência que o host e os limites explícitos permitem. |
|
|
11
11
|
| Nenhuma delegação, ou delegação proibida | Execute unidades sequencialmente; separe produção e revisão por critérios explícitos. Não anuncie uma equipe simulada. |
|
|
12
12
|
|
|
13
|
-
Em
|
|
13
|
+
Em qualquer pedido que não seja conversa, pergunta factual curta ou ajuste trivial e local, orquestrar é o padrão; solo fica só para essas exceções. Verificação já registrada nesta revisão dispensa repeti-la, não o plano. Entre workflow e subagentes avulsos, escolha o workflow quando tornar a coordenação mais confiável (fan-out sobre uma lista, várias fases, verificação por item). Uma abordagem híbrida costuma ser a melhor: reconheça o terreno direto para descobrir a lista de itens e então faça o fan-out sobre ela.
|
|
14
14
|
|
|
15
15
|
Se o host exigir opt-in explícito do usuário para orquestração programável, esta skill não é esse opt-in: use subagentes, ou descreva o plano e o custo aproximado e peça o opt-in. Um modo de orquestração permanente declarado pelo usuário ou confirmado pelo host vale como opt-in enquanto estiver ligado. Não emule o Workflow do Claude inventando chamadas `agent()`/`pipeline()` em um host que não as expõe. Nomes de funções de um fornecedor não são uma API universal.
|
|
16
16
|
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# Ledger de progresso
|
|
2
2
|
|
|
3
|
-
Leia ao iniciar
|
|
3
|
+
Leia ao iniciar qualquer tarefa que não seja conversa, pergunta factual curta ou ajuste trivial e local. O ledger é a forma em arquivo do execution-ledger: permite que o usuário acompanhe unidades, barras e consumo, e que outra sessão retome o trabalho. Mantenha-o automaticamente, sem esperar pedido. Conversa, pergunta factual curta e ajuste trivial não abrem ledger.
|
|
4
|
+
|
|
5
|
+
Ele atravessa os turnos: um novo prompt do mesmo trabalho continua a execução aberta (mesmo `run-id`), um pedido novo entra como unidade nova — ou como execução nova, se for outro trabalho — e nada recomeça sem registro. Antes de agir num turno seguinte, releia o ledger; se ele não existir ou estiver atrasado porque você deixou de mantê-lo, abra-o ou atualize-o agora, registrando como feitas as unidades já concluídas e a lacuna como falha da execução, antes de prosseguir.
|
|
4
6
|
|
|
5
7
|
## Onde fica
|
|
6
8
|
|
|
@@ -76,7 +78,7 @@ Sem Python ou sem acesso ao script, escreva o JSON acima diretamente com as ferr
|
|
|
76
78
|
|
|
77
79
|
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.
|
|
78
80
|
|
|
79
|
-
- **Início:** ao começar uma tarefa
|
|
81
|
+
- **Início:** ao começar uma tarefa dessas, mostre o plano em poucas linhas: fases, unidades e o que será entregue.
|
|
80
82
|
- **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.
|
|
81
83
|
- **Bloco de processos:** a cada transição de fase e no fim, inclua no chat o bloco impresso por `crow_ledger.py show`, no mesmo formato da lista de agentes do host. Uma linha por processo em andamento; `main` é sempre a primeira; o dono vem sem o prefixo `subagent:`; a última linha conta as unidades:
|
|
82
84
|
|
|
@@ -51,7 +51,7 @@ Depois de uma falha, formule causa e correção, aplique o menor ajuste autoriza
|
|
|
51
51
|
|
|
52
52
|
O executor entrega o artefato e sua evidência; o revisor recebe requisitos e artefato e tenta refutar o aceite. Revise fronteiras: entradas inválidas, permissões, concorrência, compatibilidade, recuperação ou fidelidade de conteúdo, conforme o domínio real.
|
|
53
53
|
|
|
54
|
-
Por padrão, salvo trabalho trivial ou
|
|
54
|
+
Por padrão, salvo trabalho trivial ou cuja verificação nesta mesma revisão já esteja registrada no ledger (reuse a evidência registrada, nunca a presuma, e isso não dispensa plano nem ledger), submeta cada achado ou alegação a vários verificadores independentes instruídos a refutar, cada um com uma lente distinta (corretude, segurança, desempenho, reprodução). O achado cai se a maioria refutar, salvo evidência reproduzível (teste, comando, trecho de fonte primária) que resista às refutações; nesse caso ele fica, e a divergência é registrada com o motivo. Verificadores que leram a mesma fonte derivada contam como uma só confirmação.
|
|
55
55
|
|
|
56
56
|
O principal valida achados contestados e reconcilia revisão com testes. Não peça ao revisor apenas que confirme que o executor está certo. Quando não houver segundo agente, faça revisão sequencial sem afirmar independência, e prefira testes/medidas reproduzíveis para reduzir viés.
|
|
57
57
|
|