Agent Skills
› matrixorigin/Memoria
› release
release
GitHub指导如何执行 Memoria 项目的版本发布流程,包括版本号更新、生成变更日志、构建多平台二进制文件、推送 Docker 镜像及创建 GitHub Release。
Trigger Scenarios
需要发布新版本
执行版本升级
构建并推送 Docker 镜像
Install
npx skills add matrixorigin/Memoria --skill release -g -y
SKILL.md
Frontmatter
{
"name": "release",
"description": "Cut a Memoria release. Version bump, CHANGELOG, CI workflows, Docker image. Use when publishing a new version."
}
Flow
| Step | Who | How |
|---|---|---|
| Bump version, tag, push | You | make release VERSION=x.y.z |
| Build binaries (4 platforms) | CI | release-rust.yml |
| Build + push Docker image | CI | release-docker.yml |
| Create GitHub Release | CI | softprops/action-gh-release |
Stable Release
git status # Must be clean
make release VERSION=0.2.0
Does: update Cargo.toml version → cargo check → generate CHANGELOG (git-cliff) → commit → tag → push.
CI then: test → build binaries (x86_64/aarch64 linux/macos) → GitHub Release → Docker image (:0.2.0 + :latest).
Pre-Release
make release-rc VERSION=0.2.0-rc1
Same but: no CHANGELOG, GitHub Release marked prerelease, Docker gets :0.2.0-rc1 (not :latest).
Typical: rc1 → rc2 → stable.
Manual Docker Push
make release-docker # :latest
make release-docker VERSION=0.2.0 # :0.2.0 + :latest
CI Workflows
| Workflow | Trigger | What |
|---|---|---|
test.yml |
Push main/develop, PRs | check + clippy + tests |
pr-title.yml |
PR open/edit | Conventional Commits validation |
release-rust.yml |
Tag v* |
Test → build → GitHub Release |
release-docker.yml |
Tag v* |
Test → build → Docker Hub |
Both release workflows run full test suite before publishing.
Version Locations
memoria/Cargo.toml— source of truthmemoria --version— binarymcp.json—_versionfield- Steering rules —
<!-- memoria-version: x.y.z -->
Checklist
- Clean working tree, CI green on main
- README/docs updated for user-facing changes
- Steering rules updated if tool behavior changed
-
make release VERSION=x.y.z - Verify GitHub Release has 4 binaries + checksums
- Verify Docker Hub has new tag
Version History
- 63f0289 Current 2026-07-25 08:42


