用途:release 属于版本发布阶段,当有一个或多个已合并的“Ready To Ship”任务且用户希望发布版本时使用。核心不变量:仅发布已合并的就绪任务;变更日志面向用户;不包含未合并的拉取请求;未经用户明确批准不重写已有标签;发布后将条目移至 Shipped,并重读 TASKS.md 确认每行已离开 Ready To Ship,陈旧跟踪会阻塞下游和无头会话。
用法:可传入 auto 或无参数(依据任务 Version Impact 推导)、patch、minor、major,或显式版本如 v1.2.3。工作流为:读取 AGENTS.md;读取 TASKS.md 找到 Ready To Ship 中已合并项;读取各任务文档获取类型、版本影响和摘要;确定下一版本;生成或更新 docs/changelogs/CHANGELOG.md;若仓库工作流要求发布提交则提交变更日志;适当时创建 git 标签;适当时用托管工具创建发布说明;在 TASKS.md 中将已发布项移至 Shipped 并从 Ready To Ship 移除;重读并验证。
版本计算:破坏性变更或需要用户迁移为 major;新功能为 minor;缺陷修复、文档、杂项、小增强为 patch;多任务同时发布时取最高影响。变更日志模板按 New Features、Fixes、Improvements、Documentation、Breaking Changes 分段。
限制:运行时适配器可能以斜杠命令、菜单操作或自然语言调用该阶段,可移植阶段名为 release;未提供具体命令内容;其他费用、平台等信息暂未提供。