用途：为 Skill System Foundry 仓库提供完整发布流程指引，覆盖版本升级、变更日志准备、GitHub Release 创建、自动打包与发布后验证。
版本约定：仓库采用 semver（MAJOR.MINOR.PATCH），版本记录在三个必须一致的清单文件：skill-system-foundry/SKILL.md 的 metadata.version（规范声明）、.claude-plugin/plugin.json 的 version、.claude-plugin/marketplace.json 中该技能条目的 version。audit_skill_system.py 的 version-drift 规则会在三者不一致时使审计失败，需通过 scripts/bump_version.py 同步升级；Git 标签形如 v1.0.2。
升级时机：PATCH 用于脚本修复、文档更正、引用与模板修正；MINOR 用于新增验证检查、脚本、参考文档、模板类型或打包目标；MAJOR 用于破坏性变更，如 configuration.yaml 架构变化、删除验证检查、重命名脚本或更改 CLI 参数。
推荐用法（dispatch 驱动）：通过 .github/workflows/release-prep.yaml 触发，执行 gh workflow run release-prep.yaml -f version=X.Y.Z（不带前导 v）。流程会创建发布分支、同步版本、生成 CHANGELOG、运行 validate_skill.py 与 audit_skill_system.py、干构建分发包、运行测试矩阵并提交 PR，由第二个机器人身份审批后自动合并，合并后打标签并触发 release.yaml 创建 Release 并附上 zip 与 SHA256 校验和。支持 dry_run 输入。
手动回退流程：确认 main 上 python-tests.yaml 最近一次运行成功且 headSha 匹配待打标签提交；本地运行校验与覆盖率测试；用 bump_version.py 升级版本；用 generate_changelog.py 生成变更日志；以 Release vX.Y.Z 格式提交并推送；再推送标签 v1.1.0 触发 release.yaml 打包发布；最后下载 zip 解压验证并确认安装路径。
限制：自动发布需配置两个 GitHub App 身份及仓库变量/密钥，并开启 Allow auto-merge；发布 PR 不得触及 CODEOWNER 拥有的路径。release.yaml 在标签推送时触发且不运行测试，发布门禁仅由 main 上的 python-tests.yaml 提供。不要自行运行 gh release create。其他细节如具体平台收费、价格暂未提供。