用途:该技能用于为 Cull 项目准备一次可复现的发布提交。仅在用户明确要求准备或提升 patch、minor、major 版本,整理变更日志与兼容性审查,或创建发布提交时使用。
主要能力:从 origin/main 获取并创建专用干净工作树,保留无关的脏工作树;确认检查证据仍与 HEAD 及预期下一版本匹配;将整理好的发布说明存入安全引用的路径;先执行 dry-run,再执行正式 prepare;验证生成单个 chore(release): vX.Y.Z 提交、状态为 prepared、文件集符合声明、无标签且无远程变更。
必要输入:明确的 patch|minor|major(不得推断);与 expectedSource 和 expectedVersion 绑定的绿色 cull-release-check 证据;符合 Cull CLI schema 的整理发布说明与兼容性审查 JSON。
使用方式:先运行 npm run release:cull -- prepare ... --dry-run --json,解析恰好一个 JSON 信封,仅当其中列出配置的版本、变更日志、兼容性和状态文件时才继续;随后去掉 --dry-run 运行同一命令。使用参数数组或分别引用的变量,切勿求值拼接命令。
限制:准备阶段不能打标签、推送、触发工作流、发布或更新 Homebrew。失败时显示诊断信息与变更文件,绝不重置、丢弃或覆盖发布自有文件集之外的工作。