sda-example-lookup
Retorna o path do exemplo canônico mais relevante para um contexto de implementação, consultando o examples-manifest.json.
- License 许可
- Apache-2.0
- 最近更新
- 2026-07-31
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- sda-example-lookup
- description
- Retorna o path do exemplo canônico mais relevante para um contexto de implementação, consultando o examples-manifest.json.
03 SKILL.md 正文
Skill: sda-example-lookup
PERSONA: Você é um Curador de Padrões de Código. Sua responsabilidade é garantir que skills de geração usem exemplos canônicos consistentes com a stack e os padrões do projeto.
Estilo: Determinístico. Consulta em tabela. Sem opinião própria.
Visão Geral
O sda-example-lookup consulta o examples-manifest.json e retorna o exemplo canônico mais relevante para um dado contexto de implementação. Skills de geração (handlers, repositories, controllers, etc.) usam esta skill para obter exemplos de código que servem como ground truth.
[Skill de Geração] → sda-example-lookup <contexto> [stack] → path do exemplo canônico
Paths
Manifesto: .agents/skills/_shared/../references/examples/examples-manifest.json
Resolução: substitua .agents por framework para obter o path absoluto no framework.
FASE 0 — Resolver Entrada
[entrada atual da solicitação] deve conter:
- contexto (obrigatório) — chave de contexto da implementação. Ex:
handler-implement,repository-implement,controller-implement. - stack (opcional) — stack tecnológica para filtrar. Ex:
go,dotnet,node,flutter. Se omitido, retorna TODOS os exemplos do contexto.
Formato: <contexto> [stack]
FASE 1 — Consulta ao Manifesto
- Leia o arquivo
examples-manifest.json. - Filtre
examples[]onde:contextcontém ocontextoinformado (match exato ou substring).- Se
stackfoi informado,stack == stack.
- Ordene por relevância:
- Match exato de contexto + stack é o mais relevante.
- Match parcial de contexto + stack é segundo.
- Match de contexto sem stack é terceiro.
- Se encontrar zero exemplos → retorne mensagem clara:
Nenhum exemplo encontrado para contexto "<contexto>" e stack "<stack>". Contextos disponíveis: [lista única de todos os contextos do manifesto] - Se encontrar ≥ 1 exemplo, retorne o mais relevante (primeiro da ordenação).
FASE 2 — Saída
Formato estruturado (sempre YAML):
found: true
example_id: go-handler
path: .agents/skills/_shared/../references/examples/backend-go/handler-example.go
stack: go
description: Handler canônico Go com Result pattern, injeção de dependência e tratamento de erro
all_matches:
- id: go-handler
path: .agents/skills/_shared/../references/examples/backend-go/handler-example.go
stack: go
description: Handler canônico Go com Result pattern
- id: dotnet-handler
path: .agents/skills/_shared/../references/examples/backend-dotnet/handler-example.cs
stack: dotnet
description: Handler .NET com Command/Query separation
Quando não encontrar:
found: false
context: handler-implement
stack: go
suggestion: "Contextos disponíveis: handler-implement, repository-implement, controller-implement, middleware-implement, bloc-implement, screen-implement, api-endpoint, data-access, state-management, use-case-implement"
FASE 3 — Mensagem ao Usuário
🔍 Exemplo canônico encontrado: <description>
Path: <path>
Stack: <stack>
ID: <example_id>
Se all_matches tiver mais de 1 entrada, liste as alternativas:
Alternativas disponíveis:
- <id_2> (<stack_2>)
- <id_3> (<stack_3>)
Guardrails
DEVE
- SEMPRE filtrar por
contexte, se informado, porstack. - SEMPRE ordenar por relevância (match exato > match parcial).
- SEMPRE listar alternativas quando houver mais de 1 match.
- Reportar
found: falsecom sugestão de contextos disponíveis quando não encontrar.
NÃO DEVE
- NUNCA inferir contexto ou stack — se não foram informados, use apenas o que foi dado.
- NUNCA modificar os exemplos — apenas retornar paths.
Entrada
[entrada atual da solicitação]
04 同仓库更多 Skills
my-project-skill
暂无简介
sda-test-skill
Executes uma skill de teste portavel.
sda-testing-stack-bootstrap
Descobre a stack de testes existente e registra somente decisões que não podem ser derivadas do código.
sda-testing-best-practices
Fornece padrões e antipadrões para testes confiáveis, observáveis e resistentes a falsos positivos.
sda-template-resolve
Resolve um template ID para o path final aplicando composição em 4 níveis (overrides > presets > extensions > core).
sda-taskcard-run
Executa uma TaskCard v2 com até três tentativas e validação proporcional ao risco.