iniciar-prototipo
Sobe o servidor HTTP local de um protótipo HTML+JSX e abre no browser. Use quando o usuário pedir para rodar, servir, abrir, subir ou ver o protótipo, ou quando precisar visualizar o protótipo depois de editá-lo. NÃO use para criar protótipo (novo-prototipo) nem para editar conteúdo — esta skill só serve e verifica.
- License 许可
- MIT
- 最近更新
- 2026-11-02
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- iniciar-prototipo
- description
- Sobe o servidor HTTP local de um protótipo HTML+JSX e abre no browser. Use quando o usuário pedir para rodar, servir, abrir, subir ou ver o protótipo, ou quando precisar visualizar o protótipo depois de editá-lo. NÃO use para criar protótipo (novo-prototipo) nem para editar conteúdo — esta skill só serve e verifica.
03 SKILL.md 正文
iniciar-prototipo
Sobe o protótipo HTML+JSX em servidor local, faz smoke test e abre no browser.
Protótipo precisa ser servido por HTTP: abrir o index.html via file:// falha,
porque o Babel busca os .jsx por XHR e o navegador bloqueia por CORS. A tela abre em
branco e o erro só aparece no console.
Argumento opcional: um task-id específico (ex.: 2026-05-20-cliente-mvp).
Passo 1 — Achar o protótipo
Liste a raiz de protótipos do projeto (prototipos_html/ por padrão), excluindo
_template.
- Argumento passado → usa ele
- Uma pasta só → usa ela
- Várias → a de
mtimemais recente, dizendo qual escolheu - Nenhuma → pare e oriente
/novo-prototipo
Valide que existem index.html e components/. Se faltar, pare e reporte — não tente
consertar aqui.
Passo 2 — Resolver a porta
Padrão: 8765.
Se estiver ocupada, verifique o que está ocupando:
lsof -ti :8765
- Ocupada por um servidor deste mesmo protótipo → mate e suba de novo (é restart)
- Ocupada por outra coisa (outro projeto, Docker, outro protótipo) → não mate; suba na próxima porta livre (8766, 8767…) e informe a porta escolhida
Matar cegamente quem está em 8765 derruba o protótipo de outro projeto que o usuário tem aberto. Dois protótipos em paralelo é caso normal, não conflito.
Passo 3 — Subir
cd <raiz>/<task-id>
python3 -m http.server <porta> > /tmp/proto-srv-<task-id>.log 2>&1
Use run_in_background: true — em foreground o servidor morre no fim da chamada.
Passo 4 — Smoke test
Antes de devolver a URL:
curl -sI http://localhost:<porta>/→ HTTP 200curl -s http://localhost:<porta>/components/app.jsx | head -3→ JSX, não 404
Falhou? Mostre /tmp/proto-srv-<task-id>.log e pare. Entregar URL quebrada faz o
usuário debugar um problema que era seu.
Passo 5 — Abrir e verificar
Abra no browser pelo preview MCP (preview_start com a URL) e verifique:
read_console_messages— zero erroread_network_requests— nenhum 404 emcomponents/*.jsx- screenshot
Console limpo é parte da entrega, não extra. Erro comum: ordem de carregamento errada no
index.html produzindo X is not defined — confira i18n → data → icons → ui → telas → app. Outro: ?v= não incrementado depois de editar, servindo a versão antiga.
Sem preview MCP disponível, devolva a URL e diga que a verificação visual não foi feita.
Passo 6 — Entregar
- URL completa
- Task-id servido e por que foi escolhido (se houve escolha)
- Porta, se não for a 8765
- Resultado do smoke test e do console
- Próximos passos:
/melhorar-prototipo,/integrar-ao-prototipo,/auditar-prototipo
Anti-padrões
- Rodar sem background → servidor morre e a URL não responde
- Matar quem estiver em 8765 sem checar o que é
- Devolver URL sem smoke test
- Dizer "está rodando" sem ter aberto e lido o console
04 同仓库更多 Skills
zoom-out
Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
writing-great-skills
Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
teach
Teach the user a new skill or concept, within this workspace.
resumo-trabalho
Resumo do trabalho de um período, agrupado pelas partes do produto, para quem não lê código. Use quando o usuário pedir um resumo ou status do que foi feito nos últimos dias, para mandar ao cliente, ao sócio ou ao gestor. NÃO use para o relatório ponto a ponto de uma entrega (relatorio-de-entrega) nem para o corpo de PR (pr).
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.