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
9002/06/2026
Claude Code
#backend#fastapi#cli#mcp#database

Recommandé pour

Notre avis

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.

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")
Skills similaires