相关职业SOC
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/fabioc-aloha/Alex_Plug_In --skill release-process命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Create and maintain ASCII visual dashboards for project tracking with parallel lane progress bars
Store and manage voice samples for TTS cloning — portable, version-controlled audio references
Clear documentation through visual excellence
基于 SOC 职业分类
正在显示 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> first