Routeur DiPeO Backend

VérifiéPrudence

Cette compétence gère les tâches simples du backend DiPeO : serveur FastAPI, outils CLI, requêtes base de données et intégration MCP. Idéale pour les tâches en lecture seule, modifications mineures de configuration ou consultation de documentation ; les changements complexes multi-fichiers sont délégués à l'agent dipeo-backend.

Spar Skills Guide Bot
DeveloppementIntermédiaire
02/06/2026
Claude Code
#backend#fastapi#cli#mcp#database

Recommandé pour

Synthèse automatique

Route les tâches de développement backend DiPeO vers un traitement direct ou une escalade vers un agent, selon leur complexité.

Points forts

  • Décision rapide entre tâches simples et complexes, économisant du temps.
  • Intégration avec les scripts doc-lookup pour obtenir du contexte précis.
  • Chemins d'escalade clairs vers d'autres agents spécialisés (package-maintainer, codegen-pipeline).
  • Documentation claire sur les motifs d'implémentation et le dépannage.

Limites

  • Limitée aux modifications simples (<20 lignes, 1-2 fichiers) – les tâches complexes doivent être escaladées.
  • Nécessite que l'utilisateur décrive précisément sa tâche pour une décision correcte.
  • Ne couvre que l'écosystème backend DiPeO (serveur, CLI, base de données, MCP).
Quand l'utiliser

Utilisez cette compétence lorsque vous travaillez sur le backend DiPeO, que ce soit pour lire du code, modifier des configurations ou exécuter des tâches simples.

Quand l'éviter

Évitez cette compétence si votre tâche concerne le frontend, l'architecture transverse ou nécessite des modifications complexes multi-fichiers échappant à sa portée.

Analyse de sécurité

Prudence
Score qualité85/100

The skill itself is a router that does not contain destructive payloads, but it allows Bash execution and delegates to more powerful agents. The potential for misuse through complex tasks or chained calls warrants caution.

Points d'attention
  • •Includes Bash as an allowed tool, which could be used to execute arbitrary commands if task handling is not properly constrained.
  • •Escalation to dipeo-backend agent or other skills may introduce broader risks if those downstream components have fewer safeguards.
Comment cette analyse est faite

Exemples

CLI help lookup
Show me the current CLI help for the dipeo command.
Database schema explanation
Explain the database schema from /dipeo/infrastructure/execution/state/persistence_manager.py.
Add environment variable to FastAPI server
Add a new environment variable 'LOG_LEVEL' to the FastAPI server configuration and make it configurable via .env file.

name: dipeo-backend description: Router skill for DiPeO backend ecosystem (server/ and cli/): FastAPI server, CLI tools, database, MCP integration. Use when task mentions CLI commands, server endpoints, database queries, or MCP tools. For simple tasks, handle directly; for complex work, escalate to dipeo-backend agent. allowed-tools: Read, Grep, Glob, Bash, Skill

DiPeO Backend Router

Domain: Backend ecosystem including FastAPI server (server/), CLI tools (cli/), message store, and MCP integration. Database schema initialization is in /dipeo/infrastructure/execution/state/persistence_manager.py (package-maintainer domain).

Quick Decision: Skill or Agent?

✅ Handle Directly (This Skill)

  • Simple changes: <20 lines, 1-2 files
  • Read-only tasks: Understanding code, reviewing configs, debugging logs
  • Documentation lookup: CLI help, API signatures, database schema
  • Small config tweaks: Environment variables, command flags

❌ Escalate to Agent

  • Complex features: Multi-file changes, new CLI commands, database migrations
  • Architecture changes: New API endpoints, MCP tool implementation
  • Cross-cutting concerns: Affects CLI + database + execution engine
  • Uncertain scope: Not sure how many files will change

Agent: Task(dipeo-backend, "your detailed task description")

Documentation Sections (Load On-Demand)

Use Skill(doc-lookup) with these anchors when you need detailed context:

Core Responsibilities:

  • docs/agents/backend-development.md#core-responsibilities - CLI, FastAPI server, database, MCP server

Implementation Patterns:

  • docs/agents/backend-development.md#common-patterns - CLI, background execution, database, MCP patterns

Troubleshooting:

  • docs/agents/backend-development.md#troubleshooting - Server, CLI, database, MCP issues

MCP Integration:

  • docs/features/mcp-server-integration.md#quick-start - Setup and usage guide
  • docs/features/chatgpt-mcp-integration.md#quick-start - ChatGPT connection

Example doc-lookup call:

python .claude/skills/doc-lookup/scripts/section_search.py \
  --query "cli-commands" \
  --paths docs/agents/backend-development.md \
  --top 1

Escalation to Other Agents

To dipeo-package-maintainer: Execution handlers, service architecture, domain models, LLM infrastructure To dipeo-codegen-pipeline: GraphQL schema changes, generated type issues, TypeScript specs

Typical Workflow

  1. Assess task complexity: Simple (handle) vs. complex (escalate)
  2. If simple: Load relevant section via Skill(doc-lookup)
  3. Execute: Make changes or provide answer
  4. If complex: Escalate with Task(dipeo-backend, "task details")

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/dipeo-backend-router-mm5t89je/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/dipeo-backend-router-mm5t89je' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/dipeo-backend-router-mm5t89je/download' --output '.skill-downloads/dipeo-backend-router-mm5t89je/SKILL.md.part' && mv '.skill-downloads/dipeo-backend-router-mm5t89je/SKILL.md.part' '.skill-downloads/dipeo-backend-router-mm5t89je/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Le fichier ne fournit pas un en-tête name/description exploitable pour cette procédure native. Le téléchargement reste disponible pour lecture ; utilisez le mode manuel ci-dessous.

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/dipeo-backend-router-mm5t89je/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires