Synthèse automatique
Cette compétence guide la recherche et la planification d'une nouvelle fonctionnalité ou d'un nouveau skill pour un système d'agents, en formalisant un plan structuré avant toute implémentation.
Points forts
- Structure claire en phases (recherche puis rédaction du plan)
- Évite le développement non planifié en imposant une étape de recherche
- Produit un document de plan réutilisable et traçable
- Couvre à la fois les aspects techniques et les dépendances (vault, configuration)
Limites
- Nécessite que le système cible dispose de l'infrastructure décrite (scouts, plans, serveur MCP)
- Ne fournit pas de modèle pour des modifications simples ou ponctuelles
- La phase de recherche dépend de la disponibilité des services existants
Utilisez cette compétence lorsque vous devez ajouter un nouveau skill, un outil MCP, un endpoint API ou un composant Vue, et que vous voulez vous assurer que toutes les implications sont documentées avant de coder.
Ne l'utilisez pas pour des modifications mineures (correction de bugs, refactoring simple) ou lorsque le système cible ne suit pas l'architecture MCP décrite.
Analyse de sécurité
SûrThe skill instructs the agent to research existing skills and service state and write a plan file, without any destructive or exfiltrating actions. No code execution or dangerous commands are explicitly instructed; it's a planning aid.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Plan a new skill for AWS EC2 instance management. The skill should list instances and allow starting/stopping them. Research existing AWS skills and the live AWS API state.Plan a new MCP tool that pings all services in the service_catalog and returns their status. Include research on current service catalog and API endpoints.Plan a new API endpoint GET /api/logs that returns agent execution logs. Research existing API structure and authentication requirements.description: Research and plan a new skill or agent feature before implementing argument-hint: <describe the skill or feature>
Phase 1 — Research (spawn scouts)
skill-scout: Check existing skills
- Are there existing skills for this service? What patterns do they use?
- What's in SKILL_META for similar skills (compat section especially)?
- What does _template.py require?
service-scout: Check live service state
- Is the target service running and reachable?
- What version is it? What API endpoint can be probed for live_validator?
- Does it appear in the service_catalog?
Phase 2 — Write the plan
Write to state/plans/PLAN-$ARGUMENTS.md:
# Plan: $ARGUMENTS
Date: <timestamp>
Status: pending
## Current state
<skill-scout summary>
<service-scout summary>
## What to build
Type: [ ] new skill module | [ ] new MCP tool | [ ] new API endpoint | [ ] new Vue component
### If new skill module:
File: mcp_server/tools/skills/modules/<service>_<action>.py
SKILL_META draft:
- name: <service>_<action>
- description: <one line>
- category: compute | networking | monitoring | storage | orchestration
- parameters: <dict>
- compat:
- service: <name>
- api_version_built_for: <version>
- version_endpoint: <endpoint to probe>
- version_field: <jq path to version in response>
execute() outline:
1. Read config from env/agent_settings.json
2. <core API call>
3. Return _ok/_err/_degraded
### If new MCP tool (register in server.py):
Function name: <verb_noun>
Parameters: <list>
Calls into: mcp_server/tools/<module>.py
### If API/GUI change:
Router: api/routers/<name>.py
Endpoint: <METHOD> /api/<path>
Auth required: yes/no
## Implementation steps
1. [ ] Write the module (sync, no async, _ok/_err/_degraded returns)
2. [ ] `python -m py_compile <file>` — syntax check
3. [ ] Register in server.py if MCP tool
4. [ ] Add UFW rule in hp1-infra if new port exposed
5. [ ] Test: call via API or agent commands panel
6. [ ] `/commit`
## Vault / config changes needed
<list any new env vars or vault keys needed — human sets these>
## Out of scope
<what this plan does NOT cover>
Do NOT write any code yet. Plan only.
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 annexesCe 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.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/research-and-plan-a-new-skill-or-agent-feature-mrzxurm5/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/research-and-plan-a-new-skill-or-agent-feature-mrzxurm5' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/research-and-plan-a-new-skill-or-agent-feature-mrzxurm5/download' --output '.skill-downloads/research-and-plan-a-new-skill-or-agent-feature-mrzxurm5/SKILL.md.part' && mv '.skill-downloads/research-and-plan-a-new-skill-or-agent-feature-mrzxurm5/SKILL.md.part' '.skill-downloads/research-and-plan-a-new-skill-or-agent-feature-mrzxurm5/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/research-and-plan-a-new-skill-or-agent-feature-mrzxurm5/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.
Bonnes pratiques React Hook Form
Developpement
Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.
Migration Emotion vers Mantine
Developpement
Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.
Détecteur de dérive de périmètre
Developpement
Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.