docs: update documentation with MCP configuration and agent catalog
- Add MCP servers documentation (n8n, context7, sequential-thinking) - Update README.md with complete project structure and requirements.txt - Transform agents.md into comprehensive agent staff catalog (9 agents) - Update CHANGELOG.md with [Unreleased] MCP entries - Fix ingestion_script.md acceptance criteria checkboxes - Add .opencode/opencode.json to .gitignore for security - Include new agent configs: n8n_specialist_agent, context_auditor_agent - Include new skill playbooks: n8n_automation, context7_documentation Security: API credentials in .opencode/opencode.json are now gitignored
This commit is contained in:
18
.opencode/agents/context_auditor_agent.md
Normal file
18
.opencode/agents/context_auditor_agent.md
Normal file
@@ -0,0 +1,18 @@
|
||||
description: Garante della documentazione aggiornata e prevenzione allucinazioni
|
||||
mode: subagent
|
||||
tools:
|
||||
context7: true
|
||||
read: true
|
||||
sequential-thinking: true
|
||||
|
||||
@context-auditor
|
||||
|
||||
Il tuo scopo è garantire che ogni riga di codice prodotta dallo staff sia basata su documentazione reale e aggiornata.
|
||||
|
||||
Responsabilità
|
||||
|
||||
Eseguire ricerche semantiche tramite context7 su ogni nuova libreria introdotta.
|
||||
|
||||
Validare le proposte del @python-developer confrontandole con le API reali.
|
||||
|
||||
Utilizzare sequential-thinking per analizzare se una soluzione proposta è la più moderna ed efficiente disponibile.
|
||||
18
.opencode/agents/n8n_specialist_agent.md
Normal file
18
.opencode/agents/n8n_specialist_agent.md
Normal file
@@ -0,0 +1,18 @@
|
||||
description: Esperto in automazione e orchestrazione n8n
|
||||
mode: subagent
|
||||
tools:
|
||||
n8n: true
|
||||
bash: true
|
||||
read: true
|
||||
|
||||
@n8n-specialist
|
||||
|
||||
Sei un esperto di automazione n8n. Il tuo compito è interfacciare LogWhisperer AI con l'istanza Docker su 192.168.254.12.
|
||||
|
||||
Focus Operativo
|
||||
|
||||
Configurazione e testing dei Webhook di ricezione log.
|
||||
|
||||
Monitoraggio delle esecuzioni per garantire che il "Metodo Sacchi" venga applicato nei prompt dell'LLM interno a n8n.
|
||||
|
||||
Troubleshooting della connessione tra lo script Bash locale e l'API di n8n.
|
||||
19
.opencode/skills/context7_documentation_retrivial/SKILL.md
Normal file
19
.opencode/skills/context7_documentation_retrivial/SKILL.md
Normal file
@@ -0,0 +1,19 @@
|
||||
Skill: Context7 Documentation Retrieval
|
||||
|
||||
Istruzioni per l'utilizzo di Context7 per eliminare allucinazioni su API e librerie.
|
||||
|
||||
Quando usare questa Skill
|
||||
|
||||
Prima di scrivere codice Python che utilizza librerie esterne (es. requests, pytest, supabase-py).
|
||||
|
||||
Quando si scrivono script Bash che utilizzano tool specifici (es. curl, jq).
|
||||
|
||||
Per verificare le ultime specifiche del Model Context Protocol (MCP).
|
||||
|
||||
Metodologia
|
||||
|
||||
Usa context7.search inserendo la libreria e la versione desiderata.
|
||||
|
||||
Integra i risultati nel contesto prima di generare il codice.
|
||||
|
||||
Se il codice generato fallisce i test, usa context7 per verificare se l'API utilizzata è deprecata.
|
||||
17
.opencode/skills/n8n_automation_mastery/SKILL.md
Normal file
17
.opencode/skills/n8n_automation_mastery/SKILL.md
Normal file
@@ -0,0 +1,17 @@
|
||||
Skill: n8n Automation Mastery
|
||||
|
||||
Questa skill istruisce l'agente su come interagire con l'istanza n8n locale (192.168.254.12).
|
||||
|
||||
Procedure Operative
|
||||
|
||||
Discovery: Prima di ogni operazione su n8n, usa n8n.list_workflows per identificare l'ID del workflow relativo a LogWhisperer.
|
||||
|
||||
Validazione: Se un workflow deve ricevere dati dallo script Bash, usa n8n.get_workflow per verificarne i nodi di ingresso (Webhook).
|
||||
|
||||
Test di Integrazione: Dopo aver implementato una modifica allo script Bash, usa n8n.execute_workflow per simulare la ricezione di un log e verificare che l'alert arrivi a destinazione.
|
||||
|
||||
Vincoli
|
||||
|
||||
Non eliminare workflow esistenti senza autorizzazione del @tech-lead.
|
||||
|
||||
Usa sempre l'ambiente di test di n8n per le prove di esecuzione.
|
||||
Reference in New Issue
Block a user