菜单
Instructions for releasing and publishing the VAK project to crates.io and PyPI.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Instructions for building the VAK project including Rust, WASM skills, and Python bindings.
WASM skill providing basic arithmetic operations for VAK agents.
WASM skill providing cryptographic hashing operations for VAK agents.
WASM skill providing JSON validation and manipulation for VAK agents.
WASM skill providing pattern matching operations for VAK agents.
WASM skill providing text analysis operations for VAK agents.
| name | release |
| description | Instructions for releasing and publishing the VAK project to crates.io and PyPI. |
This skill provides instructions for publishing new releases of the VAK project.
Current Status: Production Ready (v1.0.0) - Ready for publishing.
cargo-release (optional: cargo install cargo-release)maturin (pip install maturin)gitcargo audit, cargo deny check)Before releasing, verify:
cargo check, cargo test, cargo clippy)cargo audit --deny warnings)cargo deny check)README.md, TODO.md)Cargo.toml (workspace version)pyproject.toml (if releasing Python bindings)#[deprecated]The project uses workspace-level versioning in Cargo.toml:
[workspace.package]
version = "0.1.0"
All workspace members inherit this version:
vak)# Ensure clean working directory
git status
# Run full test suite
cargo test --workspace
# Run security checks
cargo audit --deny warnings
cargo deny check
# Check formatting
cargo fmt --all -- --check
# Run clippy
cargo clippy --all-targets --all-features -- -D warnings
Update version in Cargo.toml:
[workspace.package]
version = "0.2.0" # Bump from 0.1.0
Create/update CHANGELOG.md:
# Changelog
## [0.2.0] - 2026-02-10
### Added
- Feature X
- Feature Y
### Changed
- Breaking change Z
### Fixed
- Bug fix A
### Security
- Security fix B
git add Cargo.toml CHANGELOG.md
git commit -m "chore: release v0.2.0"
git tag v0.2.0
git push origin main --tags
# Dry run first
cargo publish --dry-run
# Publish
cargo publish
Note: WASM skills are workspace members but may not be published separately.
# Build wheels for multiple platforms
maturin build --release --features python
# Dry run
maturin publish --dry-run
# Publish
maturin publish
v0.2.0.wasm files).whl files)The project includes GitHub Action workflows that can automate releases:
git tag v0.2.0
git push origin v0.2.0
This triggers:
0.1.0-alpha.10.1.0-beta.10.1.0-rc.1| Artifact | Location | Description |
|---|---|---|
| Rust crate | crates.io | Main VAK library |
| Python wheel | PyPI | Python bindings (vak-python) |
| WASM skills | GitHub Release | Pre-compiled WASM modules |
| Documentation | docs.rs | API documentation |
If a release has issues:
# Yank the problematic version from crates.io
cargo yank --vers 0.2.0
# Yank from PyPI (if applicable)
pip index versions vak-python
# Manual yank via PyPI web interface
# Create hotfix
git checkout v0.1.0
git checkout -b hotfix/0.1.1
# Fix issue
git tag v0.1.1
CHANGELOG.md before releasing.