AgentSkillsCN

meta-agent-expert

为代码库的特定领域打造专业化的专家代理。当您需要创建具备知识库、子命令，并能与代码库深度集成的新一代专家代理时，可使用此技能。

SKILL.md
--- frontmatter
name: meta-agent-expert
description: Gera agents experts especializados em areas especificas da codebase. Use quando precisar criar um novo agent expert com knowledge base, sub-comandos e integracao com a codebase.
allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Task

Meta Agent Expert: Gerador de Agents Especialistas

Proposito

Este skill cria agents experts que tem dominio profundo sobre partes especificas da codebase. Cada agent gerado:

  1. •Conhece sua area: Tem um knowledge base com os arquivos que domina
  2. •Tem sub-comandos: Operacoes especializadas que pode executar
  3. •Pode chamar outros agents: Integra com outros experts quando necessario
  4. •Usa /question: Explora a codebase para responder perguntas da sua area

Estrutura Gerada

code
.claude/commands/experts/
  <nome-do-agent>/
    <nome-do-agent>.md       # Comando principal do agent
    question.md              # [OBRIGATORIO] Question especializado para esta area
    sync.md                  # [OBRIGATORIO] Auto-atualizacao do knowledge base
    sub-comando-1.md         # Sub-comandos especializados
    sub-comando-2.md
    KNOWLEDGE.md             # Base de conhecimento do agent

Arquivos Obrigatorios

Todo agent expert DEVE ter:

  1. •<nome>.md: Comando principal
  2. •question.md: Responde perguntas focando apenas nos arquivos do knowledge base
  3. •sync.md: Atualiza o knowledge base quando o codigo muda
  4. •KNOWLEDGE.md: Lista de arquivos que o agent domina

Quando Usar

Use este skill quando:

  • •Precisar criar um novo agent expert para uma area da codebase
  • •Quiser automatizar operacoes especificas de um dominio
  • •Precisar de um "especialista" que conheca profundamente certos arquivos
  • •Quiser delegar tarefas complexas para agents focados

Workflow de Criacao

Passo 1: Coleta de Informacoes

Quando o usuario solicitar criar um agent, colete:

  1. •Nome do agent: kebab-case (ex: kanban-workflow, git-operations)
  2. •Area de dominio: Qual parte da codebase ele domina
  3. •Responsabilidades: O que esse agent deve saber fazer
  4. •Sub-comandos desejados: Operacoes especificas (opcional - pode sugerir)

Passo 2: Discovery do Knowledge Base

Use o comando /question ou Task com subagent_type=Explore para descobrir:

  1. •Arquivos principais: Quais arquivos sao core para essa area
  2. •Padroes de codigo: Como o codigo esta organizado nessa area
  3. •Dependencias: Quais outros modulos essa area usa
  4. •Tipos e interfaces: Types relevantes para o dominio

Exemplo de discovery:

code
Prompt para Task/Explore: "Liste todos os arquivos relacionados a [AREA].
Inclua: models, routes, services, components, hooks, types.
Identifique os arquivos mais importantes e suas responsabilidades."

Passo 3: Geracao dos Arquivos

Gere os arquivos na seguinte ordem:

  1. •KNOWLEDGE.md: Base de conhecimento com paths e descricoes
  2. •<nome>.md: Comando principal do agent
  3. •question.md: [OBRIGATORIO] Question especializado para a area do agent
  4. •sync.md: [OBRIGATORIO] Auto-atualizacao do knowledge base
  5. •Sub-comandos: Arquivos .md para cada operacao especializada

Passo 4: Validacao

Apos gerar, valide:

  • • Frontmatter YAML valido em todos os arquivos
  • • Knowledge base com paths corretos
  • • question.md criado com foco nos arquivos do KNOWLEDGE.md
  • • sync.md criado com paths corretos para detectar mudancas
  • • Sub-comandos referenciados no comando principal
  • • Instrucoes claras de quando chamar cada sub-comando

Instrucoes de Geracao

Question Especializado (question.md) - OBRIGATORIO

Cada agent DEVE ter um question.md que:

  1. •Foca apenas nos arquivos do KNOWLEDGE.md
  2. •Nao modifica arquivos - apenas le e responde
  3. •Referencia o codigo real nas respostas
  4. •Diferente do /question global que consulta toda a codebase

Beneficio: Quando o usuario quer entender algo especifico da area do agent, o /[agent]/question da respostas mais precisas e focadas.

Sync/Auto-Atualizacao (sync.md) - OBRIGATORIO

Cada agent DEVE ter um sync.md que:

  1. •Detecta mudancas nos arquivos do knowledge base
  2. •Atualiza KNOWLEDGE.md quando arquivos sao criados/removidos/renomeados
  3. •Atualiza sub-comandos se paths mudaram
  4. •Mantem o agent sincronizado com a codebase atual

Beneficio: Quando o codigo evolui, o agent nao fica desatualizado. O usuario pode rodar /[agent]/sync para atualizar o knowledge base.

Comando Principal do Agent

O comando principal deve:

  1. •Ser o ponto de entrada para qualquer pergunta/tarefa da area
  2. •Ter acesso ao KNOWLEDGE.md para saber quais arquivos consultar
  3. •Decidir quando delegar para sub-comandos
  4. •Poder chamar /question para explorar a codebase
  5. •Poder chamar outros agents quando necessario

Sub-comandos

Cada sub-comando deve:

  1. •Ser focado em UMA operacao especifica
  2. •Poder ser chamado diretamente pelo usuario OU pelo agent principal
  3. •Ter seu proprio knowledge base subset (opcional)
  4. •Retornar resultado claro para o agent principal

Knowledge Base

O KNOWLEDGE.md deve conter:

  1. •Arquivos Core: Lista dos arquivos mais importantes
  2. •Estrutura: Como os arquivos se relacionam
  3. •Padroes: Convencoes de codigo da area
  4. •Dependencias: Outros modulos/agents relacionados

Exemplo de Uso

Solicitacao: "Crie um agent expert para o sistema de Kanban workflow"

Discovery:

code
Task(Explore): "Liste todos os arquivos relacionados ao Kanban workflow.
Inclua: componentes de board, cards, colunas, drag-drop, hooks de automacao,
API routes, models, services. Identifique responsabilidades de cada arquivo."

Arquivos Gerados:

code
.claude/commands/experts/kanban-workflow/
  kanban-workflow.md        # Comando principal
  validate-transition.md    # Valida transicoes entre colunas
  card-lifecycle.md         # Gerencia ciclo de vida dos cards
  automation-triggers.md    # Triggers de automacao por coluna
  KNOWLEDGE.md              # Knowledge base

Templates

Consulte o arquivo TEMPLATES.md para templates prontos de:

  • •Comando principal de agent
  • •Sub-comandos especializados
  • •Knowledge base
  • •Integracao entre agents

Integracao com Outros Agents

Quando um agent precisar de funcionalidade de outra area:

markdown
## Quando Chamar Outros Agents

- `/git-operations`: Quando precisar criar worktree ou fazer merge
- `/ai-execution`: Quando precisar executar comandos do Claude SDK
- `/metrics`: Quando precisar coletar ou consultar metricas

Checklist de Validacao

Antes de finalizar o agent:

  • • Nome segue padrao kebab-case
  • • KNOWLEDGE.md tem paths validos
  • • Comando principal referencia KNOWLEDGE.md
  • • question.md criado com allowed-tools: Read, Glob, Grep
  • • sync.md criado com processo de deteccao de mudancas
  • • Sub-comandos estao listados no comando principal
  • • Instrucoes de "quando chamar" estao claras
  • • Integracao com outros agents esta documentada (se aplicavel)