mcpField
R
release-workflow

release-workflow

github.com/light-cheng云与 DevOps521 次安装3 天前更新
代码仓库

关于 release-workflow

release-workflow 是用于执行软件发布阶段的技能,要求保留源码身份并记录经核实的结果。它区分本地准备、CI、打标签、安装、发布和证明,并为远程操作设置明确的授权关口。

主要功能

  1. 01按阶段执行发布流程
  2. 02追踪不可变的源码身份
  3. 03远程写入前确认授权
  4. 04设置安装与 CI 验证关口
  5. 05分离候选版本与收据提交

适用场景

  1. 01准备并验证获授权的发布
  2. 02审计现有发布标签
  3. 03报告发布与安装证据

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/light-cheng/skills --skill release-workflow

安装后在 Claude Code 中输入/release-workflow确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
CLOSEOUT.md
DOCUMENT-STATE.md
RELEASE-STAGES.md
VERIFICATION.md

详细介绍

Skills Collection 发布工作流

使用不可变的源身份和已观察到的验证事实,运行所请求的发布阶段。本地候选版本、远程 CI、已安装的源代码、发布结果和最终证明是彼此独立的结果。

范围与授权

确定仓库、目标版本、请求的阶段和当前基线。审计现有标签时使用历史模式;新版本发布时使用当前模式。仅请求全新安装并不授权创建标签或发布。

在请求任何缺失的发布授权之前,先准备并审查本地候选版本。首次进行远程写入前,明确列出确切的候选版本、标签、软件包数量和操作。在该范围内重复使用已明确授予的授权;目标变更时必须重新征求决定。切勿推送、创建标签、发布、全局安装或更改 Host 配置,除非这些操作属于获授权的任务。

构件与文档状态

  • Manifest 冻结准备时的范围、源身份和本地证据。
  • 发布说明和公开快照页面描述此版本的内容,但不冻结“另一个版本当前处于稳定状态”或“此版本尚未发布”之类的声明。
  • 回执在发布后首次于 main 上创建,并记录已观察到的事实。不要预填回执,也不要将其放入候选版本或标签中。

请阅读 DOCUMENT-STATE.md,了解当前稳定版本的权威来源、双语页面、快照和 Release 正文语义、观察输入以及历史兼容性。文件存在且链接文本匹配,并不能证明版本或发布状态正确。

执行所选阶段

PREPARED → CI_VERIFIED → TAGGED → INSTALL_VERIFIED → PUBLISHED → ATTESTED

请阅读 RELEASE-STAGES.md 了解阶段流程,并阅读 VERIFICATION.md 了解如何从实际发布的源代码安装。在每个相关的固定树和阶段上运行通用完整性检查。记录的 CI 必须对应确切的 commit,且已完成并成功。标签保护、带注释的对象及其 peel 身份,以及完整的安装清单仍是必需项。

使用语义感知渲染器准备 Release 正文,然后检查实际发布的正文和导航。只有已观察到的安装和发布证据才能支持成功声明。本地外部事实替代项必须显式使用 --simulate,并始终标记为 SIMULATED_PASS,绝不可标记为生产环境 PASS。

收尾

按照 CLOSEOUT.md 执行:每个阶段完成一次完整一致的修复,验证最终暂存的 Git 树及其干净导出,并要求获授权发布所需的候选版本和 final-main 的 CI 均精确匹配。候选版本和回执必须是不同的 commit。保留失败的尝试和不可变历史记录。

最终 main CI 的观察结果应留在其自身回执之外;不要创建自我引用的 commit 循环。报告候选版本和最终身份、实际检查、安装和发布结果以及尚未解决的关卡。仅有已发布的 Release 或成功推送,并不代表任务已完成。

评论

支持 Markdown