Upgrade Emitter Version
Developmentupgrade-emitter-versionUpgrade Emitter Version is an Agent Skill for development published in the Azure/azure-sdk-for-go repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when upgrading Go emitter package and TypeSpec packages in eng/emitter-package.json to their latest versions.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Azure/azure-sdk-for-go/blob/HEAD/.github/skills/upgrade-emitter-version/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/upgrade-emitter-version, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Upgrade Emitter and TypeSpec Versions
Upgrade packages in eng/emitter-package.json to their latest versions.
Prerequisites
- Node.js LTS installed
- npm-check-updates installed globally (
npm install -g npm-check-updates) - tsp-client installed globally (
npm install -g @azure-tools/typespec-client-generator-cli)
Steps
Step 1: Change to the eng directory
Change the working directory to the eng/ folder at the repository root.
Step 2: Rename emitter-package.json to package.json
Rename emitter-package.json to package.json so that ncu can process it.
Step 3: Run ncu to upgrade packages
Run ncu -u to upgrade all packages in package.json to their latest versions.
Step 4: Ensure versions are absolute
Verify that all versions in package.json are absolute (no ~ or ^ prefixes). If any version has a ~ or ^ prefix, remove the prefix so only the version number remains.
Step 5: Rename package.json back to emitter-package.json
Rename package.json back to emitter-package.json.
Step 6: Generate the lock file
Run tsp-client generate-lock-file to update emitter-package-lock.json.
Step 7: Commit the changes
Commit both emitter-package.json and emitter-package-lock.json. Do not commit node_modules or package.json.