Pular para o conteúdo
UseIA
0
Skill

Printing Press

Crédito: mvanhorn no GitHub (mvanhorn/cli-printing-press) · 0 cópias

Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026

4,8 mil estrelas no GitHubVer no GitHub
Salvar

Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).

---
name: printing-press
description: Configure uma nova integração, conector ou binding de CLI para qualquer API. Envolva ou gere uma CLI em Go pronta para publicação a partir de uma especificação OpenAPI, HAR ou Postman, pelo ciclo enxuto pesquisar -> gerar -> compilar -> shipcheck. Use quando o usuário disser construir uma CLI, envolver esta API, configurar uma nova integração, adicionar um conector, integrar com um serviço ou nomear uma API por domínio.
version: 3.0.0
min-binary-version: "4.33.0"
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - WebFetch
  - WebSearch
  - AskUserQuestion
  - Agent
created_by: user
---

# /printing-press

**Resultado:** Uma CLI em Go funcional em `$PRESS_LIBRARY/<api-slug>/`, mais até cinco
manuscritos densos arquivados em `$PRESS_MANUSCRIPTS/<api-slug>/<run-id>/`: resumo da pesquisa,
manifesto de absorção, log de build, prova do shipcheck e prova do teste de fumaça ao vivo quando o teste ao vivo foi executado.

**Próximo consumidor:** O usuário, que executa a CLI ou a publica, e as skills irmãs que
a levam adiante: `printing-press-polish` para uma segunda passada, `printing-press-publish`
para a biblioteca pública e `printing-press-retro` para achados sobre o próprio Press.

**Concluído:** Todo recurso aprovado no portão de absorção foi implementado, o shipcheck chegou
a ship, a matriz de dogfood ao vivo rodou contra alvos reais, a CLI foi promovida e o
livro de recibos fecha na última fase.

**Intenção:** A melhor CLI útil para uma API, sem uma hora de teatro de fases. Otimize
para o tempo até publicar, não para o tempo até documentar: reutilize pesquisas anteriores quando já forem boas
o bastante, execute cedo as verificações baratas e de alto sinal, corrija os bloqueios antes do acabamento.

## Limites

- **Nunca vaze um segredo.** Os **valores** de chaves de API, os **valores** de tokens, senhas e cookies
  de sessão nunca devem chegar ao código-fonte, aos manuscritos, às provas, aos READMEs, aos HARs, aos recibos nem
  a qualquer coisa que seja commitada. Os **nomes** de variáveis de ambiente e os marcadores de posição são seguros. A Fase 5.6 e a publicação
  aplicam [references/secret-protection.md](references/secret-protection.md).
- **Nunca publique sem testar.** O `go build` e a taxa de aprovação do `verify` são sinais estruturais, não
  de correção. Uma CLI que não passou pela matriz ao vivo em
  [phases/18-dogfood-testing.md](phases/18-dogfood-testing.md) não está pronta para publicação, e um
  bug que uma edição de 1 a 3 arquivos resolve é corrigido agora, não registrado para a v0.2.
- **Nunca cite estimativas de tempo humano** para subtarefas ("~15-30 min", "correção rápida"). O
  agente faz o trabalho, não o usuário; descreva o escopo em vez disso. As exceções são as
  genuinamente limitadas pelo tempo: a execução inteira (30 a 60 minutos), instalações de ferramentas e os
  subcomandos do printing-press limitados pela rede.
- **Nunca sequencie de memória.** O livro de recibos decide qual fase vem em seguida; veja
  [references/phase-receipts.md](references/phase-receipts.md).

## Autoridade

A invocação autoriza ler e escrever em `$PRESS_RUNSTATE/`, `$PRESS_LIBRARY/`
e `$PRESS_MANUSCRIPTS/`, executar o binário do printing-press e a toolchain do Go e
pesquisar a API na web aberta. Ela não autoriza publicar na biblioteca pública,
abrir um pull request nem escrever em qualquer outro lugar da máquina do usuário.

## Passos

Entre em [phases/01-preflight.md](phases/01-preflight.md) antes de qualquer pergunta ao usuário
e depois leia [references/run-resolution.md](references/run-resolution.md): ele resolve o
alvo da API, o contexto de briefing e a prioridade das fontes para execuções combinadas.

**Nunca execute uma fase de memória. Ao entrar em uma fase, leia primeiro o arquivo dela em phases/.**

| Passo | Arquivo |
|---:|---|
| 1 | [phases/01-preflight.md](phases/01-preflight.md) |
| 2 | [phases/02-run-initialization.md](phases/02-run-initialization.md) |
| 3 | [phases/03-resolve-and-reuse.md](phases/03-resolve-and-reuse.md) |
| 4 | [phases/04-research-brief.md](phases/04-research-brief.md) |
| 5 | [phases/05-pre-browser-sniff-auth-intelligence.md](phases/05-pre-browser-sniff-auth-intelligence.md) |
| 6 | [phases/06-browser-sniff-gate.md](phases/06-browser-sniff-gate.md) |
| 7 | [phases/07-crowd-sniff-gate.md](phases/07-crowd-sniff-gate.md) |
| 8 | [phases/08-ecosystem-absorb-gate.md](phases/08-ecosystem-absorb-gate.md) |
| 9 | [phases/09-api-reachability-gate.md](phases/09-api-reachability-gate.md) |
| 10 | [phases/10-generate.md](phases/10-generate.md) |
| 11 | [phases/11-build-the-goat.md](phases/11-build-the-goat.md) |
| 12 | [phases/12-shipcheck.md](phases/12-shipcheck.md) |
| 13 | [phases/13-sync-param-drop-gate.md](phases/13-sync-param-drop-gate.md) |
| 14 | [phases/14-agentic-skill-review.md](phases/14-agentic-skill-review.md) |
| 15 | [phases/15-readme-skill-agents-correctness-audit.md](phases/15-readme-skill-agents-correctness-audit.md) |
| 16 | [phases/16-agentic-output-review.md](phases/16-agentic-output-review.md) |
| 17 | [phases/17-local-code-review.md](phases/17-local-code-review.md) |
| 18 | [phases/18-dogfood-testing.md](phases/18-dogfood-testing.md) |
| 19 | [phases/19-polish.md](phases/19-polish.md) |
| 20 | [phases/20-promote-and-archive.md](phases/20-promote-and-archive.md) |
| 21 | [phases/21-next-steps.md](phases/21-next-steps.md) |

Siga o ponteiro `Next:` final de cada arquivo e registre a transferência de recibo que cada fase
nomeia. O procedimento tardio fica no arquivo da fase ou em uma referência com nome de função que ele carrega
([references/phase-receipts.md](references/phase-receipts.md), [references/codex-delegation.md](references/codex-delegation.md),
[references/fetch-docs.md](references/fetch-docs.md)). Não repita o conteúdo desses arquivos aqui.