altis-claude-harness 1.3.1 → 1.4.0
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/package.json
CHANGED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Solicita a documentação de uma tela do ERP Altis ao servidor altis-docsai (MCP) e entrega o resultado no padrão definido pelo usuário.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /altis-docsai — Documentação remota de telas do ERP Altis
|
|
6
|
+
|
|
7
|
+
Você vai solicitar a documentação de uma tela ao servidor interno `altis-docsai` (tools MCP `mcp__altis-docsai__*`) e entregar o resultado ao usuário.
|
|
8
|
+
|
|
9
|
+
## Passos
|
|
10
|
+
|
|
11
|
+
1. **Colete os dados** (pergunte o que faltar):
|
|
12
|
+
- **Nome da tela** ou caminho de menu (obrigatório).
|
|
13
|
+
- **Print da tela** (opcional, recomendado): imagem colada na conversa ou caminho de arquivo. Limite: 5 MB.
|
|
14
|
+
Para converter arquivo em base64 no PowerShell:
|
|
15
|
+
`[Convert]::ToBase64String([IO.File]::ReadAllBytes('C:\caminho\print.png'))`
|
|
16
|
+
- **Tipo** (opcional): chame `listar_tipos_documentacao` se precisar mostrar as opções ao usuário.
|
|
17
|
+
|
|
18
|
+
2. **Defina o padrão de saída**: pergunte ao usuário o padrão desejado (estrutura de seções, nível de detalhe, público-alvo, idioma). Monte um template claro em markdown descrevendo as seções esperadas — esse texto será obedecido estritamente pelo servidor. Se o usuário não tiver preferência, proponha: Identificação da tela, Caminho de menu, Visão geral, Campos e colunas, Passo a passo de uso, Validações e mensagens, Atalhos, Regras de negócio.
|
|
19
|
+
|
|
20
|
+
3. **Solicite**: chame `solicitar_documentacao` com `nome_tela`, `padrao_documentacao`, `print_base64` (se houver) e `tipo_doc` (se souber). Informe ao usuário o `job_id`, a posição na fila e a estimativa em minutos.
|
|
21
|
+
|
|
22
|
+
4. **Acompanhe**: chame `consultar_documentacao(job_id)` aguardando ~30 segundos entre consultas (`Start-Sleep -Seconds 30` no PowerShell / `sleep 30` no bash). Pare quando o status for `CONCLUIDO` ou `ERRO`.
|
|
23
|
+
|
|
24
|
+
5. **Entregue**:
|
|
25
|
+
- `CONCLUIDO`: entregue a documentação **exatamente como veio do servidor** — não reformate nem resuma. Se houver `avisos`, mostre-os ao final. Ofereça salvar em arquivo `.md`.
|
|
26
|
+
- `ERRO`: mostre a mensagem ao usuário. Se for limite da conta do servidor, oriente a re-solicitar mais tarde.
|
|
27
|
+
|
|
28
|
+
## Regras
|
|
29
|
+
|
|
30
|
+
- Nunca reformate ou resuma a documentação recebida — o padrão já foi aplicado no servidor.
|
|
31
|
+
- Print acima de 5 MB: peça ao usuário para reduzir/recortar, ou envie sem print.
|
|
32
|
+
- Servidor fora do ar (erro de conexão nas tools): avise o usuário e encerre — não tente analisar o código localmente.
|
|
@@ -6,6 +6,13 @@
|
|
|
6
6
|
"headers": {
|
|
7
7
|
"X-Api-Key": "b78529918056dfc344f0bcb9ebefc5d84c90785ff16f015d"
|
|
8
8
|
}
|
|
9
|
+
},
|
|
10
|
+
"altis-docsai": {
|
|
11
|
+
"type": "http",
|
|
12
|
+
"url": "http://192.168.44.126:8765/mcp",
|
|
13
|
+
"headers": {
|
|
14
|
+
"X-Api-Key": "2ZCXMhBzJoleWdtHAIEwyfvU5r0QVPO4T6xR9SK1"
|
|
15
|
+
}
|
|
9
16
|
}
|
|
10
17
|
}
|
|
11
18
|
}
|