Agent Skills › sthamann/nyx-local-ai › release-nyx

release-nyx

GitHub

用于端到端发布 nyx-local-ai 扩展。执行版本统一升级、运行类型检查与冒烟测试等质量门禁、打包并本地安装、提交打标签推送以触发 CI 构建，最后验证 GitHub Release 产物是否生成完整。

.cursor/skills/release-nyx/SKILL.md sthamann/nyx-local-ai

Trigger Scenarios

用户要求发布或发布新版本用户要求发送或推送更新用户要求提升版本号用户要求切断新构建

Install

npx skills add sthamann/nyx-local-ai --skill release-nyx -g -y

More Options

Use without installing

npx skills use sthamann/nyx-local-ai@release-nyx

指定 Agent (Claude Code)

npx skills add sthamann/nyx-local-ai --skill release-nyx -a claude-code -g -y

安装 repo 全部 skill

npx skills add sthamann/nyx-local-ai --all -g -y

预览 repo 内 skill

npx skills add sthamann/nyx-local-ai --list

SKILL.md

Frontmatter

{
    "name": "release-nyx",
    "description": "Ship a new nyx-local-ai release end to end — bump versions consistently, run the quality gates (typecheck, smoke tests, package), install locally, tag and push so CI publishes the installer artifacts. Use when the user asks to release, ship, publish, bump the version, or cut a new build of the extension."
}

Releasing nyx-local-ai

Follow this checklist in order. Abort on the first failed step.

Release progress:
- [ ] 1. Bump version everywhere
- [ ] 2. Quality gates
- [ ] 3. Package + local install
- [ ] 4. Commit, tag, push
- [ ] 5. Verify CI release

1. Bump version everywhere

Three places must always carry the same version:

# package.json         → "version": "X.Y.Z"
# README.md            → status line **vX.Y.Z** and all nyx-local-ai-X.Y.Z.vsix mentions
# src/mcp/client.ts    → clientInfo: { version: 'X.Y.Z' }

2. Quality gates

npm run typecheck               # must exit 0
node .harness/smoke.mjs         # must print ALL PASS
node .harness/readme-check.mjs  # must print "README CHECK: ALL PASS"
npm run build                   # must print "[nyx] build complete"

The readme-check verifies all three version locations AND that every setting, command, and tool is documented in README.md — fix any FAIL before continuing (update the README, don't weaken the check).

If parser/edit logic changed in this release, confirm .harness/smoke.mjs covers it before proceeding.

3. Package + local install

npm run package              # check the reported size stays ≈4–6 MB
bash install.sh --editor=cursor --vsix=./nyx-local-ai-X.Y.Z.vsix

Remind the user to run Developer: Reload Window to activate the build.

4. Commit, tag, push

Only commit when the user asked for it. Then:

git tag vX.Y.Z && git push origin main vX.Y.Z

The tag triggers .github/workflows/release.yml, which attaches nyx-local-ai.vsix (stable name), the versioned .vsix, and checksums.txt to the GitHub release — exactly what install.sh/install.ps1 download.

5. Verify CI release

gh run list --repo sthamann/nyx-local-ai --limit 3
gh release view vX.Y.Z --repo sthamann/nyx-local-ai --json assets -q '.assets[].name'

Expected assets: nyx-local-ai.vsix, nyx-local-ai-X.Y.Z.vsix, checksums.txt. If the run failed, read the log (gh run view <id> --log-failed) and fix before announcing the release.