一键在 Manus 中运行任何 Skill

poseidon-api-src

星标6

分支2

更新时间2026年7月9日 19:53

Especialista em IMPLEMENTAR e corrigir a API pública, DX e tipos-base do Poseidon — Poseidon.pas (fachada), Interfaces (contratos de injeção), Net.Types + Native.Types (contexto e tipos de rede), Status/MIME, Problem (RFC 7807), Validation (RTTI/atributos), Exception. Use ao aplicar patches de poseidon-api-review, evoluir a fachada, adicionar helpers no TNativeRequestContext, novo status/MIME, ou novo atributo de validação. Herda regras de poseidon-src. Mudança aqui é BREAKING por default — cuidado.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

herlondf

herlondf/poseidon

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

Implementação da API pública — invariantes

Escopo: src/Poseidon.pas, src/Poseidon.Net.Interfaces.pas, src/Poseidon.Net.Types.pas, src/Poseidon.Native.Types.pas, src/Poseidon.Status.pas, src/Poseidon.Problem.pas, src/Poseidon.Validation.pas, src/Poseidon.Exception.pas. Regras gerais em poseidon-src.

Regra de compatibilidade — API é contrato

Estas units definem o que usuários consomem. Mudança aqui quebra código externo. Antes de editar:

Assinatura de método público muda → é breaking. Só faça se o achado justificar. Documente.
Novo método é aditivo (OK).
Renomear identificador público = breaking.
Mudar tipo de campo em TNativeRequestContext = breaking se afetar layout ou semântica.

Interfaces

Toda IPoseidon* DEVE ter GUID único. Nunca copie de outra. Gere pelo IDE ou por CreateGUID.
ISP: interface pequena. Ao adicionar método, considere se cabe numa interface irmã em vez de engordar a existente.
IBufferPool / ISSLProvider etc.: injeção via construtor do servidor; nil = default real. Nova interface segue mesmo padrão.

TNativeRequestContext (Native.Types)

Estrutura central passada por var para middlewares e handlers.
Campos são MUTÁVEIS. Cada middleware pode ler/escrever headers, body, status, Handled.
Novo helper (Header/Query/Param) → método/property no TNativeRequestContext ou função em Poseidon.pas. Escolha um lugar e não duplique.
Handled := True = curto-circuita cadeia. Documente semântica em qualquer helper que setar isso.

Status / MIME (Status.pas)

Constantes THttpStatus.* cobrem 1xx-5xx. Se adicionar, mantenha ordem numérica e comentário RFC.
TMimeType extensível. Novo MIME: constante + entrada no lookup se aplicável.

Problem (RFC 7807)

TProblemDetails conforma com o RFC: type, title, status, detail, instance, mais extensões arbitrárias.
Content-Type de resposta = application/problem+json (não application/json).
Ao gerar, escape valores. Não confie em input do handler.

Validation (Validation.pas)

Atributos declarativos via RTTI: [Required], [MinLen(3)], etc.
Novo atributo: descende de TCustomAttribute do projeto; register em runtime pela RTTI (não precisa RegisterClass).
Validação retorna coleção de erros — não relança. Chamador decide o que fazer (traduzir para problem+json normalmente).

Exception

EPoseidonException = base. Filhas por categoria (EPoseidonHttp, EPoseidonProtocol, EPoseidonConfig).
Não use Exception genérica em API pública. O consumidor deve poder filtrar por tipo.

Net.Types

Tipos de rede compartilhados (aliases de socket, TSockAddr).
Aliases plataforma-específicos ficam aqui. Ver poseidon-portability-src.
Não vazar Winapi.Winsock2.TSocket cross-plat sem alias.

Poseidon.pas (fachada)

Construtor com dependências opcionais (Interfaces). Todas com default nil para preservar API atual.
Métodos fluentes retornam Self para encadear (Use(...).Get(...).Post(...)).
Ao adicionar overload, mantenha um sabor "sem opção" que compile código existente.

Bugs típicos

Interface nova com GUID copiado (bug clássico Delphi — dispatch aleatório).
Adicionar campo em TNativeRequestContext mudando layout binário e quebrando middlewares compilados contra versão anterior (só relevante para usuários que distribuem binários; para lib source é OK).
TProblemDetails gerado com application/json em vez de application/problem+json.
Validation lançando exceção em vez de retornar coleção.
Nova constante de status conflita com número existente.

Arquivos no escopo

src/Poseidon.pas, src/Poseidon.Net.Interfaces.pas, src/Poseidon.Net.Types.pas, src/Poseidon.Native.Types.pas, src/Poseidon.Status.pas, src/Poseidon.Problem.pas, src/Poseidon.Validation.pas, src/Poseidon.Exception.pas.

Cross-skill: middleware usa contexto → poseidon-middlewares-src. Handler retorna problem+json → mesmo. Novo helper que muta body → veja poseidon-http1-src (ResponseBuilder).

同仓库更多 Skills

同仓库

poseidon-benchmark

herlondf/poseidon

Medir performance do Poseidon (throughput req/s, latência p50/p99, saturação/knee, uso de CPU/memória, vazamento sob carga) e perfilar hot paths, dirigindo o harness externo do repositório Benchmark (D:\IA\Projetos\Delphi\Benchmark — k6 + wrk + Docker + Nginx LB + Grafana/InfluxDB/Tempo/SigNoz). Use SEMPRE que pedirem para benchmarkar/medir/perfilar o Poseidon, comparar v1↔v2 ou Horse↔Poseidon, verificar se uma mudança regrediu performance, ou decidir se um item de perf "vale a pena" (benchmark-gated). É uma skill-PONTE: faz o preparo do lado Poseidon e delega a execução às 11 skills benchmark-* do repo Benchmark. NÃO duplica o harness.

2026-07-256

poseidon-maturity

herlondf/poseidon

Dar uma avaliação HONESTA e calibrada (nota 1-100 por dimensão + geral) do estado do Poseidon — maturidade, correção, segurança, performance, concorrência, cobertura de testes, prontidão para produção, etc. Use quando pedirem "quão maduro/pronto/bom/seguro/performático está o Poseidon", "me dá uma resposta sincera sobre o estado", "pontue", "está pronto para produção?", ou uma nota geral. NÃO é torcedor: cada nota é fundamentada em evidência real (código lido, achados de revisão, issues abertas, estado de testes/benchmark, sinais de produção), nunca em vibe. Registra/atualiza o documento vivo MATURIDADE-*.md.

2026-07-106

poseidon-api-review

herlondf/poseidon

Revisão focada da API pública, DX e tipos-base do Poseidon — a fachada (Poseidon.pas), contratos de injeção (Poseidon.Net.Interfaces), tipos de rede e do contexto nativo (Poseidon.Net.Types, Poseidon.Native.Types), status/MIME (Poseidon.Status), problem+json RFC 7807 (Poseidon.Problem), exceções (Poseidon.Exception) e validação por RTTI/atributos (Poseidon.Validation). Use ao auditar semântica do TNativeRequestContext, helpers de header/query/param, conformidade do problem+json, e o validador de atributos. Segue a Regra de Ouro de poseidon-review (só reporte o que provar).

2026-07-096

poseidon-compression-review

herlondf/poseidon

Revisão focada de compressão do Poseidon — carregamento lazy do Brotli (Poseidon.Net.Brotli), o middleware de compressão de resposta (middlewares/Poseidon.Middleware.Compression) e a negociação Accept-Encoding/Content-Encoding (gzip, deflate, br), incluindo o permessage-deflate do WebSocket. Use ao auditar seleção de codec, limites de tamanho/OOM na (des)compressão, thread-safety do load lazy da lib nativa, e correção do quadro comprimido. Segue a Regra de Ouro de poseidon-review (só reporte o que provar).

2026-07-096

poseidon-compression-src

herlondf/poseidon

Especialista em IMPLEMENTAR e corrigir compressão e streaming de arquivo do Poseidon — Poseidon.Net.Brotli (load lazy da lib nativa), Poseidon.Net.SendFile (kernel-side send: TransmitFile Windows / sendfile Linux). Use ao aplicar patches de poseidon-compression-review (thread-safety do load lazy, limites de descompressão, negociação Content-Encoding) ou adicionar codec/estratégia de envio. Middleware Compression NÃO entra aqui: use poseidon-middlewares-src. Herda regras de poseidon-src.

2026-07-096

poseidon-concurrency-src

herlondf/poseidon

Especialista em IMPLEMENTAR e corrigir concorrência, lifetime de conexão e memória do Poseidon — Pool.Buffer, Pool.Arena, Pool.Workers, Connection, Connection.Manager, IdleSweep. Use ao aplicar patches de poseidon-concurrency-review (refcount AddRef/Release, corridas de dados, UAF, double-free, vazamentos de buffer, itens perdidos em Pool.Workers.Shutdown) ou adicionar estruturas atômicas. Herda regras de poseidon-src.

2026-07-096

name

poseidon-api-src

description

Implementação da API pública — invariantes

Regra de compatibilidade — API é contrato

Estas units definem o que usuários consomem. Mudança aqui quebra código externo. Antes de editar:

Assinatura de método público muda → é breaking. Só faça se o achado justificar. Documente.
Novo método é aditivo (OK).
Renomear identificador público = breaking.
Mudar tipo de campo em TNativeRequestContext = breaking se afetar layout ou semântica.

Interfaces

Toda IPoseidon* DEVE ter GUID único. Nunca copie de outra. Gere pelo IDE ou por CreateGUID.
ISP: interface pequena. Ao adicionar método, considere se cabe numa interface irmã em vez de engordar a existente.
IBufferPool / ISSLProvider etc.: injeção via construtor do servidor; nil = default real. Nova interface segue mesmo padrão.

TNativeRequestContext (Native.Types)

Estrutura central passada por var para middlewares e handlers.
Campos são MUTÁVEIS. Cada middleware pode ler/escrever headers, body, status, Handled.
Novo helper (Header/Query/Param) → método/property no TNativeRequestContext ou função em Poseidon.pas. Escolha um lugar e não duplique.
Handled := True = curto-circuita cadeia. Documente semântica em qualquer helper que setar isso.

Status / MIME (Status.pas)

Constantes THttpStatus.* cobrem 1xx-5xx. Se adicionar, mantenha ordem numérica e comentário RFC.
TMimeType extensível. Novo MIME: constante + entrada no lookup se aplicável.

Problem (RFC 7807)

TProblemDetails conforma com o RFC: type, title, status, detail, instance, mais extensões arbitrárias.
Content-Type de resposta = application/problem+json (não application/json).
Ao gerar, escape valores. Não confie em input do handler.

Validation (Validation.pas)

Atributos declarativos via RTTI: [Required], [MinLen(3)], etc.
Novo atributo: descende de TCustomAttribute do projeto; register em runtime pela RTTI (não precisa RegisterClass).
Validação retorna coleção de erros — não relança. Chamador decide o que fazer (traduzir para problem+json normalmente).

Exception

EPoseidonException = base. Filhas por categoria (EPoseidonHttp, EPoseidonProtocol, EPoseidonConfig).
Não use Exception genérica em API pública. O consumidor deve poder filtrar por tipo.

Net.Types

Tipos de rede compartilhados (aliases de socket, TSockAddr).
Aliases plataforma-específicos ficam aqui. Ver poseidon-portability-src.
Não vazar Winapi.Winsock2.TSocket cross-plat sem alias.

Poseidon.pas (fachada)

Construtor com dependências opcionais (Interfaces). Todas com default nil para preservar API atual.
Métodos fluentes retornam Self para encadear (Use(...).Get(...).Post(...)).
Ao adicionar overload, mantenha um sabor "sem opção" que compile código existente.

Bugs típicos

Interface nova com GUID copiado (bug clássico Delphi — dispatch aleatório).
Adicionar campo em TNativeRequestContext mudando layout binário e quebrando middlewares compilados contra versão anterior (só relevante para usuários que distribuem binários; para lib source é OK).
TProblemDetails gerado com application/json em vez de application/problem+json.
Validation lançando exceção em vez de retornar coleção.
Nova constante de status conflita com número existente.

Arquivos no escopo

Cross-skill: middleware usa contexto → poseidon-middlewares-src. Handler retorna problem+json → mesmo. Novo helper que muta body → veja poseidon-http1-src (ResponseBuilder).