| name | release-prep |
| description | 为 agent-workflows 库做发布准备,检查发布就绪性、收集变更文件、运行 workflow-maintainer 审计、起草发布说明、生成验证证据并输出最终发布清单;当 Codex 被要求准备、校验、汇总、打包或交接 agent-workflows 发布时使用。 |
发布准备
快速开始
发布流程
- 确认仓库状态:
python3 scripts/prepare_release_report.py
- 运行确定性验证:
python3 ../workflow-maintainer/scripts/audit_workflow_library.py
python3 ../workflow-automation/scripts/find_workflow_library.py --json
- 检查变更文件并判断发布影响级别:
major:破坏性的工作流语义变更、文件重命名、工作流移除,或不兼容的技能行为变更。
minor:新增工作流、新增技能、新增检查项,或向后兼容的能力扩展。
patch:错字修复、文档澄清、元数据修正、非破坏性的脚本修复。
- 起草发布说明,包含:
- 摘要
- 面向用户的变更
- 新增或变更的技能
- 已执行的验证
- 破坏性变更(如果有)
- 迁移说明(如果有)
- 已知限制或后续事项
- 最终交接必须明确说明是否执行了提交、打标签、推送和发布动作。除非用户明确批准,否则默认答案应为“否”。
维护规则
- 发布说明要基于实际观察到的变更,保持事实准确。
- 如果仓库没有定义版本规范,不要虚构版本号;应询问用户,或将本次发布标记为“未版本化草案”。
- 将失败的审计、损坏链接、必需文件缺失、README 清单过期、技能元数据无效或辅助脚本未验证视为发布阻塞项。
- 如果工作区不是 Git 仓库,则输出基于文件系统的发布报告,并明确说明无法获取 Git diff 元数据。