convez.ai
AgenteAutomaçãoAvançado
m2ai-st-metro

Sky-Lynx

m2ai-st-metro/sky-lynx

Analisa uso do Claude Code e propõe melhorias no CLAUDE.md via IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent de melhoria contínua que analisa dados de uso do Claude Code e recomenda atualizações automáticas no arquivo CLAUDE.md. Executa semanalmente via cron, detecta padrões de fricção e eficiência de workflow, gerando relatórios e PRs com mudanças propostas.

Instalação

$npx convez-ai m2ai-st-metro/sky-lynx

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Otimizar configurações do Claude Code baseado em padrões de uso real
  • Automatizar detecção de gargalos e ineficiências em fluxos de trabalho
  • Gerar relatórios semanais de insights e recomendações de melhoria

Veredito

Agent bem arquitetado para automação de análise e melhoria contínua, aplicando princípios Kaizen. Depende de integração GitHub e cron, ideal para ambientes de desenvolvimento estabelecidos com fluxo CI/CD estruturado.

README

A tradução para o português deste README ainda está na fila.

Sky-Lynx

Continuous improvement agent that analyzes Claude Code usage insights and recommends ~/CLAUDE.md updates.

Overview

Sky-Lynx runs weekly (Sundays 2 AM via cron) to:

  1. Parse Claude Code insights data from ~/.claude/usage-data/facets/
  2. Analyze friction patterns, tool usage, and workflow efficiency
  3. Generate a recommendations report
  4. Create a draft PR with proposed ~/CLAUDE.md changes

Installation

cd /home/apexaipc/projects/sky-lynx
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Configuration

Create a .env file with:

ANTHROPIC_API_KEY=sk-ant-...
GITHUB_TOKEN=ghp_...  # For PR creation

Or use the shared environment file at ~/.env.shared.

Usage

Manual Run

# Dry run (no API calls, no PR creation)
python -m sky_lynx.analyzer --dry-run

# Full run
python -m sky_lynx.analyzer

Automated (Cron)

Install the cron file:

sudo cp cron/sky-lynx /etc/cron.d/
sudo systemctl restart cron

Output

Weekly Report

Reports are saved to:

~/documentation/improvements/YYYY-MM-DD-sky-lynx-report.md

Draft PRs

Draft PRs are created on the branch sky-lynx/YYYY-MM-DD with proposed CLAUDE.md changes.

Architecture

src/sky_lynx/
├── __init__.py
├── analyzer.py          # Main entry point and orchestration
├── insights_parser.py   # Parse facets/*.json files
├── claude_client.py     # Anthropic API wrapper
├── report_writer.py     # Markdown report generation
└── pr_drafter.py        # GitHub PR creation via gh CLI

Agent Persona

Sky-Lynx uses the Kaizen-inspired analyst persona defined in:

~/projects/st-agent-registry/personas/sky-lynx/persona.yaml

Frameworks

  • Kaizen Analysis - Small, incremental improvements; waste elimination (muda)
  • Feedback Loop Detection - Recurring patterns vs one-time issues
  • Cognitive Load Management - Automation candidates; context switching costs
  • Risk-Adjusted Prioritization - Impact vs effort; reversibility assessment

Development

# Run tests
pytest

# Type checking
mypy src/

# Linting
ruff check src/

Related Projects

  • Agent Persona Academy: Persona definition system
  • Ultra Magnus / idea-catcher: Similar batch processing pattern
  • Perceptor: Context sharing across conversations
Ver o original no GitHub

Bom para

Relacionados