hop-top/aps – Sistema de Perfil do Agente

O que aps – Sistema de Perfil do Agente faz?

Sistema para gerenciar perfis de agentes de IA, permitindo configuração personalizada de comportamento, contexto e capacidades.

Visão Geral

O Agent Profile System (APS) permite que você defina perfis completos para seus agentes de IA. Cada perfil pode conter:

• Instruções de sistema: Comportamento e tom do agente.
• Contexto inicial: Informações e dados carregados no início da sessão.
• Diretórios de trabalho: Pastas onde o agente tem permissão de acesso.
• Ferramentas e capacidades: Habilidades específicas ativadas no perfil.

Como usar

1. Crie um arquivo de perfil (.aps.yaml ou .aps.json) na raiz do seu projeto.
2. Defina as configurações desejadas.
3. Ao iniciar o agente, especifique o perfil com a flag --profile ou variável de ambiente APS_PROFILE.

Exemplo de perfil (YAML)

name: dev-full
system_instructions: |
  Você é um assistente de desenvolvimento experiente.
  Responda de forma clara e objetiva.
  Sempre sugira boas práticas de código.
context:
  - docs/guia.md
  - README.md
work_directories:
  - ./src
  - ./tests
capabilities:
  - code_review
  - test_generation
  - documentation

Plataformas suportadas

• Claude Code
• Cursor
• Codex
• Outros agentes compatíveis com a especificação APS

Variáveis de ambiente

Variável	Descrição
APS_PROFILE	Nome do perfil a ser carregado
APS_DIR	Diretório onde os perfis estão armazenados (padrão: .aps/)

Comandos

• aps list – Lista perfis disponíveis
• aps load <nome> – Carrega um perfil específico
• aps current – Exibe o perfil ativo

Licença

MIT