guidelines

Collection de règles de migration et de motifs de transformation entre frameworks (ex. : Struts→Spring MVC, JSP→Thymeleaf, EJB→Spring Boot). Déclencheurs : « vérifier…

npx skills add https://github.com/microsoft/github-copilot-modernization --skill guidelines

User Input

You MUST consider the user input before proceeding (if not empty).

Purpose

Guidelines are curated, domain-specific knowledge bases providing:

  • Migration patterns: Technology-to-technology recipes
  • Transformation rules: Concrete mappings and conversion templates
  • Checklists: Step-by-step validation criteria

Skill Structure

skills/
├── guidelines/
│   └── SKILL.md                # This lookup contract
├── struts-to-spring/
│   ├── SKILL.md                # Independent Struts 2 → Spring Boot 3.x skill
│   └── SKILL-*.md              # Supporting rule documents
└── {domain}/
  └── SKILL.md                # Future independent guideline skill

Every directory containing a SKILL.md is a direct child of skills/. Never nest one skill inside another skill.

Lookup Mechanism

When other skills need guideline lookup:

  1. Context Analysis: Extract technology keywords from spec/plan/code.
  2. Guideline Discovery: Search top-level skills/*/SKILL.md metadata for matching source and target technologies.
  3. Application: Load matching SKILL.md, extract applicable rules for current phase.

Integration Points

Workflow StepGuideline Application
SpecificationDomain constraints, scope boundaries
PlanningTechnology decisions, architecture patterns
TasksTransformation tasks, file-by-file changes
ImplementationCode transformation rules, test patterns
CompletenessValidation checklists, coverage criteria

Creating New Guidelines

  1. Create a top-level directory: skills/{domain}/
  2. Create SKILL.md with:
    • Metadata header (name, description, triggers)
    • Rules organized by migration step
    • Concrete transformation examples (before/after)
    • Validation checklist

Documenting Applied Guidelines

When guidelines are applied, document in the relevant artifact:

## Applied Guidelines
- **Guideline**: struts-to-spring
- **Rules Used**: convert-action-to-controller, convert-validation
- **Reference**: skills/struts-to-spring/SKILL.md

Plus de skills de microsoft

oss-growth
microsoft
Persona de growth hacker OSS
agent-framework-azure-ai-py
microsoft
Créez des agents Azure AI Foundry à l’aide du SDK Python Microsoft Agent Framework (agent-framework-azure-ai). À utiliser lors de la création d’agents persistants avec AzureAIAgentsProvider, de l’utilisation d’outils hébergés (interpréteur de code, recherche de fichiers, recherche web), de l’intégration de serveurs MCP, de la gestion de fils de conversation ou de l’implémentation de réponses en streaming. Couvre les outils de fonction, les sorties structurées et les agents multi-outils.
development
airunway-aks-setup
microsoft
Configurez AI Runway sur AKS — du cluster nu au modèle en cours d'exécution. Couvre la vérification du cluster, l'installation du contrôleur, l'évaluation GPU, la configuration du fournisseur et le premier déploiement. QUAND : « configurer AI Runway », « intégrer un cluster AKS », « installer AI Runway », « configuration airunway », « déployer un modèle sur AKS », « inférence GPU sur AKS », « configuration KAITO sur AKS », « exécuter LLM sur AKS », « vLLM sur AKS », « configurer le service de modèles sur AKS », « contrôleur AI Runway ».
devops
appinsights-instrumentation
microsoft
Conseils pour instrumenter les applications web avec Azure Application Insights. Fournit des modèles de télémétrie, la configuration du SDK et des références de configuration. QUAND : comment instrumenter une application, SDK App Insights, modèles de télémétrie, qu'est-ce qu'App Insights, conseils sur Application Insights, exemples d'instrumentation, bonnes pratiques APM.
devops
applicationinsights-web-ts
microsoft
Instrumentez les applications navigateur/web avec le SDK JavaScript Application Insights (@microsoft/applicationinsights-web). Utilisez-le pour la surveillance des utilisateurs réels (RUM) — vues de page, clics, dépendances AJAX/fetch, exceptions, événements personnalisés et traces d’agents GenAI côté navigateur corrélées aux traces OpenTelemetry backend. Couvre le script de chargement du SDK et la configuration npm, les extensions de framework (React, React Native, Angular), Click Analytics, les initialiseurs de télémétrie et les conventions sémantiques OTel GenAI pour les spans d’agents/outils/modèles émises depuis le navigateur.
devops
azure-ai-anomalydetector-java
microsoft
Créez des applications de détection d'anomalies avec le SDK Azure AI Anomaly Detector pour Java. Utilisez-le lors de l'implémentation de la détection d'anomalies univariées/multivariées, de l'analyse de séries temporelles ou de la surveillance basée sur l'IA.
development
azure-ai-language-conversations-py
microsoft
Implémentez la compréhension du langage conversationnel (CLU) à l’aide du SDK Python azure-ai-language-conversations. Utilisez-le lorsque vous travaillez avec ConversationAnalysisClient pour analyser l’intention et les entités d’une conversation, créer des fonctionnalités de NLP ou intégrer la compréhension du langage dans des applications.
development
azure-ai-ml-py
microsoft
SDK v2 d’Azure Machine Learning pour Python. Utiliser pour les espaces de travail ML, les tâches, les modèles, les jeux de données, le calcul et les pipelines. Déclencheurs : « azure-ai-ml », « MLClient », « espace de travail », « registre de modèles », « tâches d’entraînement », « jeux de données ».
development