菜单
Use when the user says 'cut a release', 'release vX.Y.Z', 'publish a new version', or 'bump the version'. Covers the full release flow: version bump → PR to main → CI → merge → publish → develop sync.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Lossless context management — search and store persistent memory across sessions
Lossless context management — search and store persistent memory across sessions
Use when deciding which lcm MCP tool to call — lcm_search, lcm_grep, lcm_expand, lcm_describe, lcm_store, lcm_doctor, or lcm_stats — or when an lcm tool returns an error.
This skill should be used when the user asks to "run lcm dogfood", "self-test lcm", "validate lcm build", "test lcm hooks", "check lcm mcp tools", or mentions lcm QA, regression testing, or pre-release validation. Runs a comprehensive 39-check self-test across all CLI commands, hooks, MCP tools, and resilience.
You MUST use this before any work to recall project memory, and after implementing to store decisions. Lossless-claude (lcm) provides persistent cross-session memory via CLI commands.
Run the E2E validation checklist against a real lcm installation. Tests daemon, hooks, import, compact, promote, retrieval, and resilience. Pass a flow name for a subset (import, compact, promote, curate, retrieval, hooks, doctor, cleanup), or omit for the full suite.
| name | lcm-release |
| description | Use when the user says 'cut a release', 'release vX.Y.Z', 'publish a new version', or 'bump the version'. Covers the full release flow: version bump → PR to main → CI → merge → publish → develop sync. |
Cut a versioned release of lossless-claude/lcm. This is a public npm package — never delete or overwrite existing git tags.
Note on release flow: This script is the canonical release process for this repo. It replaces any earlier Changesets-based or
version-pr.ymlautomation.WORKFLOW.mdandRELEASING.mdreflect the old flow and have not yet been updated.
Run .claude/skills/lcm-release/scripts/release.sh from the repo root:
bash .claude/skills/lcm-release/scripts/release.sh <version>
# e.g.
bash .claude/skills/lcm-release/scripts/release.sh 0.4.2
Resuming after a failure — pass --from-step N to skip already-completed steps:
bash .claude/skills/lcm-release/scripts/release.sh 0.4.2 --from-step 8 # re-watch publish.yml
bash .claude/skills/lcm-release/scripts/release.sh 0.4.2 --from-step 9 # just run develop sync
Sync develop standalone — when Step 9 needs to run independently:
bash .claude/skills/lcm-release/scripts/sync-develop.sh 0.4.2
The script handles everything end-to-end:
| Step | What it does |
|---|---|
| 0 | Checkout develop, pull, verify clean, sync develop←main (via PR if needed) |
| 1 | Guard: abort if tag or npm version already exists |
| 2 | Create release/vX.Y.Z branch from develop |
| 3 | Bump all 3 version files, verify they all match |
| 4 | Commit and push |
| 5 | Open PR targeting main |
| 6 | Wait for CI (skips gracefully if no CI configured) |
| 7 | Merge with --merge (preserves commit SHA on main) |
| 8 | Wait for publish.yml to complete |
| 9 | Open sync PR to bring the release commit back into develop; merge with --merge (preserves merge commit SHA) |
developgh CLI is authenticatedmain — the only exception to "PRs target develop"--merge (not squash) so the version bump SHA is preserved on mainpackage.json, .claude-plugin/plugin.json, .claude-plugin/marketplace.json
.plugins[0].version, not root| Symptom | Cause | Fix |
|---|---|---|
| Guard fails: tag exists | Version already tagged | Pick a higher version |
| Guard fails: npm version exists | Already published | Pick a higher version |
publish.yml conclusion is skipped | Tag or npm version exists (race) | Pick a higher version; start over |
| develop diverged from main (cannot fast-forward) | Branches were manually changed or cherry-picked | Manually reconcile develop and main until fast-forwardable, then rerun |
publish.yml conclusion is not success | Build/test/publish failed | Check the run URL printed by the script |
.claude/skills/lcm-release/scripts/release.sh ← full end-to-end, supports --from-step N
.claude/skills/lcm-release/scripts/sync-develop.sh ← standalone Step 9 (develop sync)