Skill per agenti di programmazione

Archyl offre 11 skill per agenti di programmazione che portano l'intera architettura dentro il tuo agente: Claude Code, Codex, Cursor o qualsiasi strumento compatibile. Invece di passare continuamente dal tuo editor alla dashboard di Archyl, il tuo agente può validare le modifiche prima che tu scriva codice, documentare ciò che è stato rilasciato, revisionare le pull request rispetto al tuo modello C4 e prevedere la deriva architetturale, tutto dal terminale.

Le skill sono open source e disponibili su github.com/archyl-com/agent-skills.

Il flusso di lavoro architetturale AI-native

Le 11 skill lavorano insieme per formare un ciclo architetturale continuo:

preflight → code → review → CI (GitHub Actions) → postship → generate context
    ↑                                                              |
    └──────────────────────────────────────────────────────────────┘

Prerequisiti

• Un account Archyl con accesso API
• Una chiave API (ottienila da Profilo > Chiavi API nella dashboard di Archyl)
• Claude Code, Codex, Cursor o un agente di programmazione compatibile

Installazione

Passo 1: aggiungi il marketplace

Esegui il seguente comando in Claude Code:

/plugin marketplace add archyl-com/agent-skills

Poi configura gli aggiornamenti automatici:

1. Esegui /plugin
2. Seleziona Marketplaces
3. Scegli archyl-marketplace
4. Seleziona Enable auto-update

Passo 2: installa il plugin

/plugin install archyl-developer@archyl-marketplace

Il plugin archyl-developer installa tutte le 11 skill e l'hook del Guard. Riavvia il tuo agente di programmazione dopo l'installazione.

Passo 3: configura il server MCP

Aggiungi il server MCP di Archyl al file .mcp.json del tuo progetto:

{
    "mcpServers": {
        "archyl": {
            "type": "http",
            "url": "https://api.archyl.com/mcp",
            "headers": {
                "X-API-Key": "arch_your_api_key_here"
            }
        }
    }
}

Sostituisci arch_your_api_key_here con la tua chiave API effettiva dalla dashboard di Archyl.

Altri agenti di programmazione

I file delle skill sono compatibili con qualsiasi agente che supporti il formato plugin. Puoi anche usarli direttamente dal repository agent-skills con Cursor, Codex o altri strumenti.

Configurazione rapida

Il modo più veloce per iniziare è lo script di configurazione, che genera tutti i file di configurazione di cui il tuo agente ha bisogno.

Lo script di configurazione

Eseguilo dalla radice del tuo progetto:

npx archyl-setup

Vengono creati tre file:

Modello: CLAUDE.md

Il file CLAUDE.md generato include istruzioni come queste:

# Architecture

This project is documented in Archyl (project ID: `proj_xxx`).

## Before coding
Run `/archyl-preflight` to validate your approach against the architecture.

## After shipping
Run `/archyl-postship` to update the C4 model and create ADRs.

## Architecture rules
Always run `/archyl-review` before requesting a code review.

Puoi personalizzare questi modelli in base al flusso di lavoro del tuo team.

Skill di base

archyl-developer

La skill fondamentale. Fornisce al tuo agente una conoscenza strutturata degli oltre 200 strumenti MCP di Archyl nei seguenti ambiti:

Esempi di prompt:

Create a new system called PaymentPlatform with containers for
the API server, a PostgreSQL database, and a React frontend.

Create an ADR titled "Migrate from REST to gRPC for internal services".
Set it as proposed, explain the context around latency requirements,
and link it to the ApiGateway and PaymentService containers.

Show me the technology radar. Add Temporal as an adopted workflow
orchestration technology and tag it on the OrderProcessing container.

archyl-preflight

Da eseguire prima di iniziare a scrivere codice per validare l'approccio pianificato rispetto all'architettura esistente. Preflight confronta il tuo piano con il modello C4, le regole di conformità e gli ADR recenti per individuare subito le violazioni.

Esempi di prompt:

/archyl-preflight I'm planning to add a new Redis cache between the
API server and the database to reduce read latency.

/archyl-preflight We want to split the UserService into separate
authentication and profile services.

La skill segnala problemi come violazioni delle dipendenze, conflitti di denominazione o approcci che contraddicono ADR esistenti, prima che tu scriva una sola riga di codice.

archyl-postship

Da eseguire dopo il rilascio per aggiornare automaticamente la documentazione dell'architettura. Analizza cosa è cambiato nel codebase e:

• Aggiorna il modello C4 (nuovi container, componenti, relazioni)
• Crea ADR per le decisioni significative
• Apre richieste di modifica per la revisione del team quando serve

Esempi di prompt:

/archyl-postship We just shipped the Redis caching layer.
Update the architecture to reflect the new cache container
and its relationships.

/archyl-postship Document the authentication service split
we shipped this sprint.

archyl-harness

Il protocollo delle sessioni di lavoro per programmare sotto governance, ovvero la skill alla base di Archyl Harness. Insegna al tuo agente il ciclo completo: plan_work prima di iniziare, start_work_session per ottenere un contesto mirato e lease consultivi, remember/recall per il knowledge graph del progetto e finish_work_session con un risultato che può aprire una richiesta di modifica architetturale.

Work under the harness: plan, declare a session, respect the
guardrails, and finish with an honest summary.

Skill di revisione e governance

archyl-review

Un bot strutturato per la revisione architetturale. Analizza i diff rispetto al tuo modello C4, alle regole di conformità e agli ADR per fornire commenti di code review consapevoli dell'architettura.

Esempi di prompt:

/archyl-review Review the current branch against the architecture.
Flag any conformance violations or undocumented dependencies.

/archyl-review Check if PR #42 introduces any new cross-system
dependencies that aren't in the C4 model.

archyl-changelog

Genera un changelog dell'architettura: una cronologia delle modifiche che include ADR, release, controlli di conformità, eventi di deriva e aggiornamenti del modello.

Esempi di prompt:

/archyl-changelog Show the architecture timeline for the last month.

/archyl-changelog What changed in the PaymentPlatform system
since the v2.0 release?

archyl-autofix

Quando viene rilevata una deriva tra il codice e la documentazione dell'architettura, autofix propone correzioni concrete, al codice o al modello, per riallinearli.

Esempi di prompt:

/archyl-autofix We have drift on the PaymentService container.
Propose fixes to resolve it.

/archyl-autofix Show all current drift issues and suggest
the fastest path to zero drift.

Skill di intelligence

archyl-dora

Mette in relazione le modifiche all'architettura con le metriche di delivery DORA. Mostra come le decisioni architetturali influiscono su frequenza di deployment, lead time, tasso di fallimento delle modifiche e tempo medio di ripristino.

Esempi di prompt:

/archyl-dora Show DORA metrics for the last quarter.
Did the microservice split improve deployment frequency?

/archyl-dora Correlate recent architecture changes
with our change failure rate trend.

archyl-roi

Calcola l'impatto economico delle decisioni architetturali. Stima il tempo risparmiato, gli incidenti evitati e le variazioni di produttività degli sviluppatori derivanti dai miglioramenti architetturali.

Esempi di prompt:

/archyl-roi What's the estimated ROI of our migration
from monolith to microservices?

/archyl-roi Calculate the cost of our current architectural
drift vs the cost of fixing it.

archyl-predict

Prevede i problemi architetturali prima che si verifichino. Usa le tendenze storiche per anticipare deriva, regressioni DORA e punti critici di complessità.

Esempi di prompt:

/archyl-predict Which components are most likely to drift
in the next 30 days?

/archyl-predict Based on current trends, will our deployment
frequency regress this quarter? Which services are at risk?

Orchestrazione

archyl-orchestrate

Coordina più agenti che lavorano sullo stesso codebase. Gestisce la negoziazione dei contratti API tra servizi e la risoluzione dei conflitti di dipendenze, e garantisce che gli agenti non apportino modifiche architetturali in conflitto.

Esempi di prompt:

/archyl-orchestrate Two agents are modifying services that share
an API contract. Coordinate the changes to avoid conflicts.

/archyl-orchestrate Agent A is adding a new field to the
UserService API. Check if Agent B's PaymentService integration
will break.

Questa skill è particolarmente utile nelle configurazioni multi-agente, in cui agenti diversi gestiscono servizi diversi e devono negoziare contratti condivisi senza pestarsi i piedi.

Pacchetti di regole di conformità

Archyl offre pacchetti di regole di conformità pronti all'uso per i pattern architetturali più comuni: microservizi, event-driven, architettura a livelli e altri. Questi pacchetti funzionano con tutte le skill descritte sopra per applicare automaticamente la tua architettura.

Consulta la guida alle regole di conformità per i dettagli sui pacchetti disponibili e su come creare regole personalizzate.

SDK

Se vuoi integrare Archyl in strumenti personalizzati oltre agli agenti di programmazione, sono disponibili SDK per TypeScript, Python e Go.

Consulta la documentazione del server MCP per i dettagli sugli SDK e il riferimento API.

Come funziona

Ogni skill fornisce al tuo agente di programmazione una conoscenza strutturata di specifici strumenti MCP di Archyl, inclusi parametri, valori attesi e best practice. Quando chiedi al tuo agente di eseguire un'attività architetturale, l'agente:

1. Identifica quali strumenti MCP chiamare in base alla conoscenza della skill
2. Costruisce i parametri corretti (ID dei progetti, tipi di elemento, tipi di relazione)
3. Concatena più chiamate per i flussi di lavoro complessi
4. Restituisce un riepilogo di ciò che è stato creato, modificato o segnalato

L'agente inizia sempre chiamando list_projects per scoprire i progetti disponibili e ottenere il projectId necessario per le operazioni successive.

Riferimento al modello C4

Le skill comprendono tutti e 4 i livelli del modello C4:

Tipi di relazione

Quando collega gli elementi, l'agente usa il tipo di relazione appropriato:

Contribuire

Le skill sono open source. Puoi contribuire:

• Correggendo nomi di strumenti, parametri o descrizioni
• Aggiungendo copertura per le nuove funzionalità di Archyl
• Migliorando gli esempi di flussi di lavoro
• Creando nuovi file di skill per ulteriori casi d'uso

Consulta la guida per contribuire per i dettagli.