prompt-refactor

Refactor existing prompt artifacts against explicit requirements through the full prompt-builder loop.

npx skills add https://github.com/microsoft/hve-core --skill prompt-refactor

Prompt Refactor Compatibility Skill

Goal

Preserve legacy prompt-refactor activation while simplifying approved prompt-engineering artifacts through the hve-builder refactor route and its independent quality gates.

Flow

  1. Translate promptFiles to existing targets and resolve the behavior that must remain unchanged.
  2. When requirements are omitted, use the HVE Builder baseline review to derive evidence-backed cleanup objectives.
  3. Activate hve-builder with mode=refactor, the approved write boundary, requirements, and any caller-owned evidence root.
  4. Return the HVE Builder static verdict, behavior-test fidelity and verdict, validation result, and overall outcome.

Inputs

  • promptFiles: existing prompt-engineering artifacts to refactor
  • requirements: optional cleanup objectives, constraints, and preserved behavior
  • evidenceRoot: optional caller-owned HVE Builder evidence path

Success Criteria

  • The approved targets are simpler without unintended behavior change.
  • Static review, behavior testing, and host validation pass.
  • Source changes stay inside the approved write boundary.
  • The returned overall outcome is unchanged from hve-builder.

Constraints

  • Do not dispatch retired named lifecycle workers.
  • Do not create a second orchestration loop or sandbox contract.
  • Route a requested type change, artifact split, or new support artifact back through HVE Builder scope approval.

Stop Rules

  • Stop Pass only when the HVE Builder refactor route passes every required gate.
  • Preserve Revise, Deferred, or Blocked and its rerun condition.
  • Ask when preserved behavior or write scope cannot be inferred safely.

Handoff

Use prompt-analyze for read-only follow-up review and prompt-builder when the requested work intentionally changes behavior or creates artifacts.

Final Response Contract

Return targets, changed files, refactor rationale, static verdict, behavior-test fidelity and verdict, validation result, overall outcome, evidence links, and next action.

More skills from microsoft

oss-growth
microsoft
OSS growth hacker persona
agent-framework-azure-ai-py
microsoft
Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai). Use when creating persistent agents with AzureAIAgentsProvider, using hosted tools (code interpreter, file search, web search), integrating MCP servers, managing conversation threads, or implementing streaming responses. Covers function tools, structured outputs, and multi-tool agents.
development
airunway-aks-setup
microsoft
Set up AI Runway on AKS — from bare cluster to running model. Covers cluster verification, controller install, GPU assessment, provider setup, and first deployment. WHEN: "setup AI Runway", "onboard AKS cluster", "install AI Runway", "airunway setup", "deploy model to AKS", "GPU inference on AKS", "KAITO setup on AKS", "run LLM on AKS", "vLLM on AKS", "set up model serving on AKS", "AI Runway controller".
devops
appinsights-instrumentation
microsoft
Guidance for instrumenting webapps with Azure Application Insights. Provides telemetry patterns, SDK setup, and configuration references. WHEN: how to instrument app, App Insights SDK, telemetry patterns, what is App Insights, Application Insights guidance, instrumentation examples, APM best practices.
devops
applicationinsights-web-ts
microsoft
Instrument browser/web apps with the Application Insights JavaScript SDK (@microsoft/applicationinsights-web). Use for Real User Monitoring (RUM) — page views, clicks, AJAX/fetch dependencies, exceptions, custom events, and browser-side GenAI agent traces correlated to backend OpenTelemetry traces. Covers SDK Loader Script and npm setup, framework extensions (React, React Native, Angular), Click Analytics, telemetry initializers, and OTel GenAI semantic conventions for agent/tool/model spans emitted from the browser.
devops
azure-ai-anomalydetector-java
microsoft
Build anomaly detection applications with Azure AI Anomaly Detector SDK for Java. Use when implementing univariate/multivariate anomaly detection, time-series analysis, or AI-powered monitoring.
development
azure-ai-language-conversations-py
microsoft
Implement Conversational Language Understanding (CLU) using the azure-ai-language-conversations Python SDK. Use when working with ConversationAnalysisClient to analyze conversation intent and entities, building NLP features, or integrating language understanding into applications.
development
azure-ai-ml-py
microsoft
Azure Machine Learning SDK v2 for Python. Use for ML workspaces, jobs, models, datasets, compute, and pipelines. Triggers: "azure-ai-ml", "MLClient", "workspace", "model registry", "training jobs", "datasets".
development