LeanSpec Publishing 是一项面向智能体的发布技能，用于把 LeanSpec 包发布和发行到 npm，覆盖版本管理、发布前校验与多平台分发的完整流程。
核心原则：版本以根 package.json 为唯一来源；平台二进制包必须先于主包发布；版本同步通过脚本自动完成，不手动编辑 package.json；发布前必须运行 pnpm pre-release 测试；跨平台测试使用 -dev 标签。
生产发布流程：先用 npm version patch（或 minor/major）只更新根版本；再运行 pnpm sync-versions 同步全部包；随后 pnpm pre-release 做校验；然后提交并推送标签；最后用 gh release create 创建 GitHub Release，自动触发发布工作流。
开发版发布：通过 GitHub Actions 运行发布工作流，可用 dry_run 参数做不发布的校验；安装测试用 npm install -g lean-spec@dev，再执行 lean-spec --version。
版本管理：pnpm sync-versions 会把根版本传播到所有包（含 Rust crate），CI 自动校验版本一致性，禁止手动修改包版本。
分发包架构：主包 lean-spec 通过 optionalDependencies 引用各平台二进制包（darwin-arm64、darwin-x64、linux-x64、windows-x64 等），平台包必须先发布，工作流会自动处理顺序。包类型分为主包（lean-spec、@leanspec/mcp、@leanspec/ui）、平台包（@leanspec/cli-{platform}、@leanspec/mcp-{platform}，各 5 个平台）与不发布的内部包。
常见问题：找不到二进制可用 npm view 检查并 pnpm rust:build 重建；版本不一致用 pnpm sync-versions --dry-run 检查、pnpm sync-versions 修复；权限问题用 chmod +x。更多细节见 references 下的 NPM-DISTRIBUTION.md、DEV-PUBLISHING.md 与 PUBLISHING.md。