release-prep

Prepare a release for this repository when the user says "release". Use to review changes since the last release, choose and confirm the semver bump, run tests, update version files, tag, push, and draft the GitHub release for code-index-mcp.

$ 安裝

git clone https://github.com/johnhuang316/code-index-mcp /tmp/code-index-mcp && cp -r /tmp/code-index-mcp/.codex/skills/release-prep ~/.claude/skills/code-index-mcp

// tip: Run this command in your terminal to install the skill


name: release-prep description: Prepare a release for this repository when the user says "release". Use to review changes since the last release, choose and confirm the semver bump, run tests, update version files, tag, push, and draft the GitHub release for code-index-mcp.

Release Prep

Overview

Follow the code-index-mcp release checklist and use the helper script for quick repo status. Keep this file focused on the high-level workflow; the checklist contains the exact commands.

Workflow

  1. Run scripts/run_release_checks.py and review the output.
  2. Review changes since the last tag, decide the semver bump, and confirm the target version + branch with the user.
  3. Confirm test scope (full vs. -k) and run: uv run pytest.
  4. Update version files: pyproject.toml, src/code_index_mcp/__init__.py, uv.lock.
  5. Ensure the diff only touches the three version files.
  6. Commit with Conventional Commits (e.g., chore(release): vX.Y.Z).
  7. Draft release notes focused only on functional changes (exclude technical-only modifications) and confirm the notes with the user before creating the GitHub release.
  8. Tag, push branch + tag, and create the GitHub release.
  9. Follow up on CI/deploy jobs.

Resources

scripts/

  • scripts/run_release_checks.py for repo status, latest tag, and version file presence before editing versions.

references/

  • references/release_checklist.md for the exact steps, commands, and files.