AGENT SKILL

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:

  1. contexto (obrigatório) — chave de contexto da implementação. Ex: handler-implement, repository-implement, controller-implement.
  2. 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

  1. Leia o arquivo examples-manifest.json.
  2. Filtre examples[] onde:
    • context contém o contexto informado (match exato ou substring).
    • Se stack foi informado, stack == stack.
  3. Ordene por relevância:
    • Match exato de contexto + stack é o mais relevante.
    • Match parcial de contexto + stack é segundo.
    • Match de contexto sem stack é terceiro.
  4. 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]
    
  5. 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

  1. SEMPRE filtrar por context e, se informado, por stack.
  2. SEMPRE ordenar por relevância (match exato > match parcial).
  3. SEMPRE listar alternativas quando houver mais de 1 match.
  4. Reportar found: false com sugestão de contextos disponíveis quando não encontrar.

NÃO DEVE

  1. NUNCA inferir contexto ou stack — se não foram informados, use apenas o que foi dado.
  2. NUNCA modificar os exemplos — apenas retornar paths.

Entrada

[entrada atual da solicitação]

04 同仓库更多 Skills