菜单
Wax deployment orchestration skill. Use when releasing new versions of Wax across npm, Homebrew, OpenClaw, OpenCode, or Claude Code channels. Covers version bumping, congruency validation, binary building, staged publishing, and rollback procedures.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/christopherkarani/Wax --skill wax-deploy命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Swift framework guidance for Wax on-device memory/RAG. Use when writing Swift code with the public Memory facade, embedding providers, retrieval modes, or hybrid search. For agent operators using the Wax MCP server tools, use the separate wax-mcp skill instead.
Maintain the Wax memory store used by the Hermes wax-memory provider.
Operator playbook for the Wax MCP memory server. Use whenever Wax MCP tools are available (remember, recall, search, handoff, session_start/end, structured memory), when installing or configuring waxmcp, or when an agent should keep durable cross-session memory. Prefer this skill over the Swift framework skill unless the task is writing Wax Swift code.
基于 SOC 职业分类
正在显示 SKILL.md
| name | wax-deploy |
| description | Wax deployment orchestration skill. Use when releasing new versions of Wax across npm, Homebrew, OpenClaw, OpenCode, or Claude Code channels. Covers version bumping, congruency validation, binary building, staged publishing, and rollback procedures. |
Wax deploys to 5 channels from a single source of truth. This skill ensures predictable, resilient, and congruent releases across all channels.
| Channel | Artifact | Location |
|---|---|---|
| npm | waxmcp package | Resources/npm/waxmcp/ |
| Homebrew | wax.rb formula | Resources/npm/waxmcp/homebrew-wax/ |
| OpenClaw | @wax/openclaw-wax-memory plugin | Resources/openclaw/wax-memory-plugin/ |
| OpenCode | .pi extension + agents | .pi/extensions/wax-agents/ |
| Claude Code | MCP server registration | wax-cli mcp install |
# Full pipeline: bump → build → validate → commit message
scripts/release-all.sh 0.1.23
# Then commit, tag, and publish:
git add -A && git commit -m "release: waxmcp v0.1.23"
git tag waxmcp-v0.1.23 && git push origin main --tags
scripts/publish-all.sh --tag next
scripts/validate-congruency.sh
# or JSON output for CI:
scripts/validate-congruency.sh --json
scripts/release-all.sh 0.1.23 --dry-run
scripts/publish-all.sh --tag next --dry-run
scripts/bump-version.sh atomically updates all 7 version surfaces:
Resources/npm/waxmcp/package.jsonSources/WaxMCPServer/main.swiftResources/openclaw/wax-memory-plugin/package.json (version)Resources/openclaw/wax-memory-plugin/package.json (waxmcp dependency)Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb (URL)Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb (SHA256).pi/extensions/wax-agents/package.jsonscripts/bump-version.sh 0.1.23 # exact version
scripts/bump-version.sh patch # or minor/major
scripts/bump-version.sh 0.1.23 --dry-run
scripts/release-all.sh builds darwin-arm64 and darwin-x64 binaries:
scripts/release-all.sh 0.1.23
# Skip build if binaries already exist:
scripts/release-all.sh 0.1.23 --skip-build
scripts/validate-congruency.sh asserts all surfaces match:
scripts/validate-congruency.sh # human-readable
scripts/validate-congruency.sh --json # machine-readable
scripts/validate-congruency.sh --quiet # CI-friendly (exit 0/1 only)
scripts/publish-all.sh supports canary → soak → promote workflow:
# Publish to canary
scripts/publish-all.sh --tag next
# After soak period, promote to latest
scripts/publish-all.sh --promote
# Preview without publishing
scripts/publish-all.sh --tag next --dry-run
All channels must share the same version. The canonical source is Resources/npm/waxmcp/package.json.
| Symptom | Cause | Fix |
|---|---|---|
| openclaw ≠ npm | Plugin not bumped after waxmcp release | scripts/bump-version.sh $(npm version) |
| homebrew ≠ npm | Formula manually edited, not via script | scripts/bump-version.sh recomputes URL + SHA |
| opencode ≠ npm | Extension version never tracked | scripts/bump-version.sh aligns it |
Add to .github/workflows/release-waxmcp.yml before publish:
- name: Validate version congruency
run: scripts/validate-congruency.sh --quiet
git checkout -- Resources/npm/waxmcp/package.json \
Sources/WaxMCPServer/main.swift \
Resources/openclaw/wax-memory-plugin/package.json \
.pi/extensions/wax-agents/package.json \
Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb
# Unpublish within 24 hours
npm unpublish waxmcp@0.1.23
npm unpublish @wax/openclaw-wax-memory@0.1.23
# Republish previous version as latest
npm dist-tag add waxmcp@0.1.22 latest
npm dist-tag add @wax/openclaw-wax-memory@0.1.22 latest
Commit or stash changes before running release-all.sh:
git stash
scripts/release-all.sh 0.1.23
git stash pop
Or use --allow-dirty (not recommended for production releases).
Run the bump script to align all surfaces:
scripts/bump-version.sh $(node -p "require('./Resources/npm/waxmcp/package.json').version")
Version already published. Check:
npm view waxmcp versions --json | tail -5
The SHA in the formula is computed from local git archive. After pushing the tag, verify:
curl -sL https://github.com/christopherkarani/Wax/archive/refs/tags/waxmcp-v0.1.23.tar.gz | shasum -a 256
If different, update the formula manually or re-run bump-version.sh after the tag is pushed.
bump-version.sh updates all surfaces in one invocation--dry-run for safe previewnext tag for canary, latest for productionset -euo pipefail on all scripts; validation gates before publishResources/scripts/ helpers