메뉴
Complete release automation for VS Code Marketplace publishing
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/fabioc-aloha/Alex_Plug_In --skill release-process명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
| name | release-process |
| description | Complete release automation for VS Code Marketplace publishing |
| tier | standard |
| applyTo | **/*release*,**/*publish*,**/*.vsix,**/CHANGELOG* |
| inheritance | master-only |
Inheritance: master-only (contains PAT handling, marketplace credentials)
Comprehensive knowledge for releasing Alex Cognitive Architecture to VS Code Marketplace and managing version lifecycle.
# From repo root
.\scripts\release-vscode.ps1 -BumpType patch # Stable release
.\scripts\release-vscode.ps1 -BumpType minor -PreRelease # Pre-release
.\scripts\release-vscode.ps1 -BumpType patch -DryRun # Test without publishing
cd platforms/vscode-extension
npx vsce publish --pre-release # Pre-release
npx vsce publish # Stable release
⚠️ IMPORTANT: PATs expire frequently and may only work for a single publish session. Always create a fresh PAT before each release to avoid 401 errors.
Via Marketplace (Recommended):
Via Azure DevOps:
vsce-marketplace (or similar)All accessible organizationsMarketplace → ManageOption 1: Environment Variable (Session only)
$env:VSCE_PAT = "your-token-here"
Option 2: .env File (Persistent, gitignored)
# platforms/vscode-extension/.env
VSCE_PAT=your-token-here
Dual
.envWarning: BothAlex_Plug_In/.env(root) ANDplatforms/vscode-extension/.env(heir) may contain aVSCE_PAT. The publish command runs from the heir directory and reads the heir's.env. If you update the root, also update the heir — or vice versa. PAT mismatch between these files has caused 401 errors across consecutive releases (v5.9.11, v5.9.12).
Option 3: System Environment (Persistent)
[Environment]::SetEnvironmentVariable("VSCE_PAT", "your-token", "User")
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | PAT expired or invalid | Create new PAT |
| 401 Unauthorized | Wrong scope | Ensure "Marketplace (Manage)" scope |
| 401 Unauthorized | Wrong .env updated | Ensure platforms/vscode-extension/.env has the token |
| 403 Forbidden | Not publisher owner | Check publisher membership |
| Token not found | .env not loaded | Check file path, run preflight |
When publish fails with 401 and you've already built a valid .vsix, skip the full prepublish cycle:
# Set new PAT and publish pre-built package (skips sync/quality-gate/compile)
$env:VSCE_PAT = "new-token"; npx vsce publish --packagePath alex-cognitive-architecture-X.Y.Z.vsix
This saves ~2 minutes vs a full npx vsce publish which re-runs the entire prepublish pipeline.
MAJOR.MINOR.PATCH
│ │ └── Bug fixes, docs
│ └──────── New features, non-breaking
└────────────── Breaking changes
| Type | Flag | Visibility | Use Case |
|---|---|---|---|
| Pre-release | --pre-release | Opt-in only | Beta testing |
| Stable | (none) | Everyone | Production ready |
VS Code Marketplace Rule: Pre-release versions must use the --pre-release flag, NOT semver suffixes like -beta.1.
When bumping version, these files need synchronization:
platforms/vscode-extension/package.json → version fieldplatforms/vscode-extension/.github/copilot-instructions.md → **Version**: lineCHANGELOG.md → New ## [X.Y.Z] sectionThe release-vscode.ps1 script handles all of these automatically.
┌─────────────────────────────────────────────────────────────────┐
│ .\scripts\release-vscode.ps1 -BumpType patch -PreRelease │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 0. PAT Check │───▶│ 1a. Sync Heir │───▶│ 1b. Preflight │
│ - Load .env │ │ - build-pkg.ps1 │ │ - Version sync │
│ - Validate │ │ - Master→Heir │ │ - Build/Lint │
│ │ │ │ │ - Manifest check│
└─────────────────┘ └─────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 2. Version Bump │───▶│ 3. CHANGELOG │───▶│ 4. Git Commit │
│ - package.json │ │ - Add entry │ │ - Commit │
│ - heir version │ │ - Date stamp │ │ - Tag │
│ │ │ │ │ - Push │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ 5. Publish │
│ - vsce publish │
│ - --pre-release │
└─────────────────┘
Before publishing, verify ALL 8 criteria from ROADMAP.md:
| # | Criterion | Validation Method |
|---|---|---|
| 1 | Builds clean | npm run compile exits 0 with zero errors |
| 2 | No dead code | All imports resolve, no orphaned modules |
| 3 | Counts match reality | Slash commands, tools, skills, trifectas in docs = actual code |
| 4 | F5 smoke test passes | Extension activates, welcome view renders, 3 random commands work |
| 5 | Version aligned | package.json = CHANGELOG = copilot-instructions |
| 6 | Heir sync clean | sync-architecture.cjs runs with 0 errors, no contamination |
| 7 | No non-functional features | If in UI/command palette, it works. If broken, removed. |
| 8 | CHANGELOG documents delta | Every user-visible change has a line item |
Pattern: Use regression checklist as DoD tracker:
VXXX-REGRESSION-CHECKLIST.md)Quality Gate: If ANY criterion fails, DO NOT publish. Fix first.
If not using the script:
.\scripts\release-preflight.ps1 -Packagepackage.jsoncopilot-instructions.md versiongit commit -m "chore: release vX.Y.Z"git tag vX.Y.Zgit push && git push --tagsnpx vsce publish [--pre-release]The release-preflight.ps1 script validates:
| Check | What It Does |
|---|---|
| PAT | Verifies VSCE_PAT is available in env or .env |
| Version Sync | package.json = CHANGELOG = Master instructions = heir instructions |
| BUILD-MANIFEST | Checks heir was synced recently (warns if > 24h old) |
| README Skill Count | Verifies documented skill count matches actual |
| ROADMAP Version | Warns if ROADMAP.md version differs |
| Build | npm run compile succeeds |
| Lint | npm run lint passes |
| Tests | npm test passes (can skip with -SkipTests) |
| Git Status | Shows uncommitted changes |
| Git Tags | Warns if tag already exists |
| Package | Creates VSIX (with -Package flag) |
Alex_Plug_In/
├── scripts/
│ ├── release-preflight.ps1 # Pre-release validation
│ ├── release-vscode.ps1 # Full release automation
│ └── build-extension-package.ps1 # Heir sync
├── platforms/vscode-extension/
│ ├── package.json # Version source of truth
│ ├── .env # PAT storage (gitignored)
│ ├── .github/
│ │ └── copilot-instructions.md # Heir version
│ └── *.vsix # Built packages
└── CHANGELOG.md # Version history
Cause: Used semver suffix like 3.7.4-beta.1
Solution: Use plain version 3.7.4 with --pre-release flag
Cause: PAT expired, invalid, or wrong scope
Solution:
Cause: Trying to publish same version twice
Solution: Bump version first, or delete existing version from marketplace
Cause: Often network or auth issues
Solution:
npx vsce login <publisher-name> firstSOC 직업 분류 기준