@andespindola/crow-skills 0.39.0 → 0.39.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/crow_skills/__init__.py
CHANGED
package/package.json
CHANGED
package/release.json
CHANGED
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"crow_skills/__init__.py": {
|
|
29
29
|
"executable": false,
|
|
30
30
|
"kind": "file",
|
|
31
|
-
"sha256": "
|
|
31
|
+
"sha256": "cc31d6c68bd4608a765d04e1159af015aa8cba0aa61d2da53c027fc033be366f"
|
|
32
32
|
},
|
|
33
33
|
"crow_skills/__main__.py": {
|
|
34
34
|
"executable": false,
|
|
@@ -153,7 +153,7 @@
|
|
|
153
153
|
"package.json": {
|
|
154
154
|
"executable": false,
|
|
155
155
|
"kind": "file",
|
|
156
|
-
"sha256": "
|
|
156
|
+
"sha256": "5b9beb57525b19906aa91a49dce1505bb0b230a4b402e5c9bd35686f489965f7"
|
|
157
157
|
},
|
|
158
158
|
"skills/crow-accessibility/SKILL.md": {
|
|
159
159
|
"executable": false,
|
|
@@ -218,7 +218,7 @@
|
|
|
218
218
|
"skills/crow-behaviour/SKILL.md": {
|
|
219
219
|
"executable": false,
|
|
220
220
|
"kind": "file",
|
|
221
|
-
"sha256": "
|
|
221
|
+
"sha256": "7c8ac7b0f41d07a5815b3beb600848894e661c6318526e62ca564026f3e10c31"
|
|
222
222
|
},
|
|
223
223
|
"skills/crow-behaviour/agents/openai.yaml": {
|
|
224
224
|
"executable": false,
|
|
@@ -976,7 +976,7 @@
|
|
|
976
976
|
"sha256": "7dd3660097c3afeadb58357939b51da518a4da7cf2d7e684c2618b22f6c4a87b"
|
|
977
977
|
}
|
|
978
978
|
},
|
|
979
|
-
"revision": "
|
|
979
|
+
"revision": "0f9a4474c68714d028c27163a483cc3381d84e64",
|
|
980
980
|
"schema_version": 1,
|
|
981
|
-
"version": "0.39.
|
|
981
|
+
"version": "0.39.1"
|
|
982
982
|
}
|
|
@@ -62,6 +62,9 @@ Quando `crow-model-level` estiver instalada, o nível de cada unidade delegada
|
|
|
62
62
|
- **O braçal é delegado por padrão, não por escolha sua.** Uma unidade é braçal quando você consegue especificar o resultado e aceitá-lo pela evidência, sem ver o caminho: a edição que você já decidiu, a varredura com critério fechado, a reescrita mecânica, a coleta de evidência, rodar um comando e relatar o que saiu, levantar como uma coisa funciona hoje. Se é preciso decidir no meio do caminho, não é braçal — é desenho, e é seu. Executar você mesmo uma unidade braçal porque "o contexto já está carregado" é a falha característica desta skill: troca o seu contexto, que é o recurso escasso e não se recupera, por trabalho que qualquer executor faria, e o briefing que você economizou custa menos do que o contexto que você gastou.
|
|
63
63
|
- Ao delegar execução, descubra quem é o micro-agent em vez de presumir: `crow_micro.py probe` — com `codex` disponível e autenticado, os micro-agents são do codex; sem ele, são os do próprio CLI. Ao micro-agent vai só o braçal já especificado; mapear, planejar, desenhar e verificar no fim continuam seus. Leia [micro-agents](references/micro-agents.md).
|
|
64
64
|
- **Micro-agent ou bot autônomo: decida pela natureza da demanda, não por hábito.** Resultado que você especifica e aceita pela evidência, dentro do turno, é **micro-agent** — efêmero, você verifica e descarta. Demanda que persiste além do turno, dispara por evento e precisa de estado próprio entre execuções é **bot autônomo** — um processo que sobrevive à sessão, com memória externa própria e gatilho; ele não lembra, relê o que gravou e reconstrói o contexto a cada disparo. Micro-agent é o default; bot só quando a persistência ou o gatilho de evento é a essência da demanda, não um "seria bom ter". Bot e micro-agent usam igualmente o crow-broadcast e a mesma fronteira de autonomia desta skill; o criador continua responsável por ambos, verifica o resultado e age quando qualquer um fica ocioso.
|
|
65
|
+
- **Pendência que você encontra é registro, e quando outro pode resolvê-la, é oferta.** Anotar o que deu certo e esconder o que ficou pela metade produz um vault que parece completo e não é: sem um registro próprio, a pendência vira prosa dentro do desfecho e ninguém consegue perguntar "o que está pendente". Então registre-a **assim que a identificar**, não no fim, com o que a torna acionável: o que falta, o que ela destrava e como se sabe que fechou. Em seguida decida se é **sua** ou **de qualquer um**: pendência que depende de decisão do dono, de credencial ou de acesso que só você tem fica registrada e **não** é anunciada — pedir ajuda que ninguém pode dar é ruído no canal que o dono observa. Pendência que outro agente conseguiria resolver vira **handoff compartilhado** na memória do dono (`scope: "shared"`, com `summary`, `nextSteps` e `sources` apontando caminho e revisão exata), e só então o broadcast anuncia que existe — a mensagem é a campainha, nunca o registro, porque mensagem expira e pendência não. Quem assume reivindica o handoff (`claim`, que carrega lease e cerca de versão, de modo que dois não pegam o mesmo e quem morrer segurando solta sozinho) e fecha com `complete` e o desfecho. **Não crie fila própria para isso:** o mecanismo existe, é testado, e duplicá-lo produz dois registros divergindo.
|
|
66
|
+
- **Ocioso não é desocupado: é quem pode ajudar.** Ao ficar sem trabalho, leia os handoffs compartilhados em aberto antes de encerrar ou de inventar tarefa. Se couber no seu escopo autorizado, **assuma e resolva**. Se não couber — porque o conserto é do dono daquele código, ou exige acesso que você não tem — ainda assim ajude de outra forma: **levante a informação que falta** para quem vai atuar (reprodução mínima, revisão exata, trecho relevante, o que já foi descartado) e devolva isso no handoff. Informação boa entregue a quem pode agir vale mais que um conserto apressado feito por quem não deveria tocar ali, e evita dois agentes brigando pelo mesmo arquivo.
|
|
67
|
+
|
|
65
68
|
- **Antes de pegar trabalho novo, veja o que o dono já pediu e ninguém assumiu.** Demanda digitada no cockpit fica registrada numa fila local sem validade (`crow-skills demand list --pending`), porque mensagem de broadcast expira e pedido sem resposta não é velho, é pendente. Ao iniciar, e sempre que ficar ocioso, leia a fila: se houver demanda compatível com o seu escopo autorizado, **assuma** (`demand take <id>`), execute, e encerre dizendo o desfecho (`demand done <id> "<o que saiu>"` ou `demand fail <id> "<por quê>"`). Se não puder terminar, **devolva** (`demand release <id>`) em vez de morrer segurando — a fila marca como órfã a demanda presa a uma sessão que sumiu, mas devolver na hora é honesto e evita a espera. A fila é entrega, não memória: ao assumir, registre o pedido na memória do dono, que é onde ele passa a existir de verdade.
|
|
66
69
|
|
|
67
70
|
- **O conhecimento do bot é seu para guardar, não dele.** A memória do bot é apartada e perecível: ela morre com a sessão e envelhece quando ele fica ocioso. O que ele sabe veio de você, no briefing — ele é consumidor do conhecimento, nunca o guardião. Então, antes de criar um bot de um papel que já existiu, **leia o que já foi acumulado** (`crow-skills bot knowledge --role-of <papel>`) e inclua no briefing o que valer, em vez de ensinar de novo o que já foi pago. Quando o bot reporta, **registre o que ele devolveu** (`crow-skills bot learned <id> "<o que apurou>"`): o retorno não registrado é conhecimento que ninguém mais tem. Esse registro é local e mecânico; **promover ao durável é seu**, pela memória do dono, porque o bot não toca o vault — só você toca. Destile, não acumule: nota que cresce a cada briefing recria, em outro lugar, o custo de contexto que a delegação existe para cortar. E trate o retorno como alegação a julgar antes de virar registro, não como verdade.
|