SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsrelease preflight skill

release preflight skill

Deployment & operations

View repository

Updated 10-15 21:40

About this skill

Release Preflight Skill

Pre-checks, version consistency, and deployment discipline.

The Golden Rule

NEVER publish without running the preflight checklist.

Quick Start

# Full preflight check
scripts/release-preflight.ps1

# With packaging test
scripts/release-preflight.ps1 -Package
Skip time-consuming tests

scripts/release-preflight.ps1 -SkipTests


## Version Locations (Must Stay Synchronized)

| # | Location | Field | Example |
| - | -------- | ----- | ------- |
| 1 | `platforms/vscode-extension/package.json` | `version` | `"5.1.0"` |
| 2 | `CHANGELOG.md` | Latest heading | `## [5.1.0] - 2026-02-07` |
| 3 | `.github/copilot-instructions.md` | `**Version**:` line | `**Version**: 5.1.0` |
| 4 | `platforms/vscode-extension/.github/copilot-instructions.md` | Same as #3 |
| 5 | `docs/index.html` | Footer version | `v5.1.0` |
| 6 | `ROADMAP-UNIFIED.md` | Quick Status table | Master 5.1.0 row |
| 7 | Git tag | Tag name | `v5.1.0` |

## Preflight Gates

| Gate | Check | Script Flag |
|------|-------|-------------|
| 0 | PAT configured | Always |
| 1 | Version sync (all 7 locations) | Always |
| 2 | Build passes | Always |
| 3 | Lint passes | Always |
| 4 | Tests pass | `-SkipTests` to skip |
| 5 | Package creates | `-Package` to include |
| 6 | Human review | Manual |

## Full Release Workflow

```powershell
# VS Code Extension release
scripts/release-vscode.ps1 -BumpType minor

# M365 Agent release  
scripts/release-m365.ps1 -Validate

Version Bump Only

# 1. Bump
npm version patch --no-git-tag-version

# 2. Get version
$v = (Get-Content package.json | ConvertFrom-Json).version

# 3. Update CHANGELOG, commit, tag, push
git add -A; git commit -m "release: v$v"; git tag "v$v"; git push --tags

Common Mistakes

Mistake Prevention
Published without version bump Run preflight first
CHANGELOG not updated Script checks this
Forgot to push tags Script does this
Version mismatch Grep entire repo for old version
PAT 401 error Refresh PAT before release

Related Scripts

Script Purpose
scripts/release-preflight.ps1 Pre-release validation
scripts/release-vscode.ps1 Full VS Code release
scripts/release-m365.ps1 M365 agent packaging
.github/muscles/build-extension-package.ps1 Full build (sync + compile + PII scan)
.github/muscles/sync-architecture.js Canonical Master → Heir sync

Triggers

  • "release", "publish", "deploy"
  • "preflight", "pre-release check"
  • "version bump", "version sync"

Scripts: scripts/release-preflight.ps1, scripts/release-vscode.ps1