Skip to content

Commit 2e12b81

Browse files
author
MarceloClaro
committed
Merge remote-tracking branch 'upstream/v4.2' into master - resolvidos 3 conflitos add/add (.gitignore, README.md, ci.yml) com conteúdo preservado de ambos os lados
2 parents 4506534 + c7a2aa0 commit 2e12b81

1,800 files changed

Lines changed: 277757 additions & 14 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎$null‎

Whitespace-only changes.

‎.claude/skills/edicao-cirurgica/SKILL.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
name: edicao-cirurgica
3+
description: "Skill do ecossistema OpenCode - edicao-cirurgica"
4+
---
5+
6+
7+
name: edicao-cirurgica
8+
description: >
9+
Edição cirúrgica: retorna APENAS blocos modificados, nunca o artefato inteiro. Use SEMPRE que o usuário pedir para modificar, corrigir, ajustar, refatorar ou remover trecho de código, JSON, SQL, HTML, CSS, Markdown, workflow n8n ou qualquer artefato existente. Acionar também em edição iterativa multi-rodada: "ajusta o bloco de pedidos", "troca a seção 3", "muda o nó X", "corrige o CSS", "mexe na função", "edita o bloco de", "atualiza só essa parte", "refatora isso". Cobre todas as linguagens e formatos. NAO usar para criação do zero (skill geradora tem prioridade) nem quando mais de 70% do artefato muda.
10+
---
11+
12+
---
13+
name: edicao-cirurgica
14+
description: >
15+
Edição cirúrgica: retorna APENAS blocos modificados, nunca o artefato inteiro. Use SEMPRE que o usuário pedir para modificar, corrigir, ajustar, refatorar ou remover trecho de código, JSON, SQL, HTML, CSS, Markdown, workflow n8n ou qualquer artefato existente. Acionar também em edição iterativa multi-rodada: "ajusta o bloco de pedidos", "troca a seção 3", "muda o nó X", "corrige o CSS", "mexe na função", "edita o bloco de", "atualiza só essa parte", "refatora isso". Cobre todas as linguagens e formatos. NAO usar para criação do zero (skill geradora tem prioridade) nem quando mais de 70% do artefato muda.
16+
---
17+
18+
# Skill: Edição Cirúrgica
19+
20+
> *Detalhes em `references/principio-central.md`*
21+
---
22+
23+
> *Detalhes em `references/escopo-aplicacao.md`*
24+
### Modo 2 - Sugestão conversacional (código externo)
25+
26+
Quando o artefato **não está no container** (repositório local do usuário, workflow n8n, Supabase, Google Apps Script, arquivo que o usuário vai copiar manualmente), usar o formato visual padronizado descrito abaixo.
27+
28+
---
29+
30+
> *Detalhes de "Formato Visual Padrão (Modo 2)" em `references/`*
31+
32+
> *Detalhes em `references/edicao-iterativa.md`*
33+
> *Detalhes em `references/contexto-tipico.md`*
34+
---
35+
36+
> *Detalhes em `references/regras-artefato.md`*
37+
---
38+

‎.claude/skills/edicao-cirurgica/references/contexto-tipico.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
### Contexto típico
2+
3+
O usuário e o Claude estão construindo um artefato em múltiplas rodadas. A cada rodada, o usuário pede ajustes em blocos específicos do que já foi gerado. O artefato pode ser:
4+
5+
- Peça jurídica em construção (fundamentação já pronta, agora ajustar os pedidos)
6+
- Skill sendo refinada (trigger já definido, agora expandir as regras de redação)
7+
- Workflow n8n sendo iterado (nó de trigger pronto, agora corrigir o Code Tool)
8+
- HTML/CSS de documento timbrado (cabeçalho pronto, agora ajustar o footer)
9+
- Script Python ou Apps Script em desenvolvimento
10+
11+
> *Detalhes em `references/regras-edicao.md`*

‎.claude/skills/edicao-cirurgica/references/edicao-iterativa.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
## Edição Iterativa de Documentos
2+
3+
Em fluxos de construção por blocos (petições, pareceres, contratos, skills, workflows), o padrão cirúrgico se aplica com força especial:

‎.claude/skills/edicao-cirurgica/references/escopo-aplicacao.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
## Escopo de Aplicação
2+
3+
Esta skill governa **dois modos de operação**, dependendo de onde o artefato vive:
4+
5+
> *Detalhes em `references/modos-operacao.md`*

‎.claude/skills/edicao-cirurgica/references/modos-operacao.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
### Modo 1 - Edição direta em arquivo (container)
2+
3+
Quando o arquivo está disponível no filesystem (`/home/claude/`, `/mnt/user-data/`), usar a ferramenta nativa `str_replace`:
4+
5+
```
6+
str_replace(
7+
path: "caminho/do/arquivo",
8+
old_str: "trecho exato a substituir",
9+
new_str: "trecho novo"
10+
)
11+
```
12+
13+
Neste modo, **não** formatar a entrega como bloco visual - a ferramenta já é cirúrgica por natureza. Apenas explicar brevemente o que mudou e por quê.

‎.claude/skills/edicao-cirurgica/references/principio-central.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
## Princípio Central
2+
3+
Quando propor alterações em artefato existente, retorne **apenas o delta** - o bloco que mudou. Jamais reescreva o artefato inteiro. Isso preserva contexto, reduz consumo de tokens e evita sobrescrever acidentalmente partes não alteradas.

‎.claude/skills/edicao-cirurgica/references/regras-artefato.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
## Regras Específicas por Tipo de Artefato
2+
3+
> *Detalhes em `references/regras-codigo.md`*
4+
> *Detalhes em `references/regras-n8n.md`*
5+
> *Detalhes em `references/regras-html-css.md`*
6+
> *Detalhes em `references/regras-skills.md`*
7+
> *Detalhes em `references/regras-juridico.md`*

‎.claude/skills/edicao-cirurgica/references/regras-codigo.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
### Código (JS, TS, Python, Apps Script, SQL)
2+
3+
- Retornar a função/método/bloco inteiro que mudou, não apenas a linha
4+
- Se a alteração impacta imports, mostrar o import novo separadamente como bloco adicional
5+
- Nunca reescrever boilerplate (setup Express, setup Next.js, etc.) que não mudou

‎.claude/skills/edicao-cirurgica/references/regras-edicao.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
### Regras para edição iterativa
2+
3+
1. **Nunca regenerar o artefato completo** quando o pedido se refere a um bloco específico
4+
2. **Referenciar o bloco pelo identificador natural**: nome da seção, nome da função, número do slide, nome do nó n8n, seletor CSS, número da cláusula contratual
5+
3. **Preservar o que já foi aprovado**: se o usuário aprovou a fundamentação e agora pede ajuste nos pedidos, a fundamentação não aparece na resposta
6+
4. **Entregar o bloco editado completo**: não entregar "meia função" - o bloco inteiro que mudou, com marcadores de continuidade antes e depois
7+
5. **Quando houver dúvida sobre o escopo**: perguntar "você quer que eu ajuste só [bloco X] ou reescreva a seção inteira?"

0 commit comments

Comments
 (0)