用途
该技能在用户要求准备发布、创建发布计划或交付某个版本时,生成一份结构化、可执行的发布检查清单。清单覆盖从代码冻结到部署后验证的完整部署生命周期,输出为带复选框和负责人分配的 Markdown 文件,保存到 .chalk/docs/engineering/ 目录。
主要能力
- 读取项目上下文:检查 .chalk/docs/engineering/ 下的文件,了解架构与部署拓扑(单体或微服务、部署目标)、现有监控与告警设置、数据库迁移模式、功能开关基础设施、历史发布清单(继承项目特定条目)以及 CI/CD 流水线配置。
- 确定版本号:若 $ARGUMENTS 提供了版本则直接使用;否则检查 package.json、pyproject.toml、Cargo.toml 等文件中的当前版本,并根据变更按语义化版本建议下一个版本;同时运行 git log --oneline <last-tag>..HEAD 了解本次发布内容。
- 分析发布范围:通过 git log 列出所有提交,识别新功能、缺陷修复、破坏性变更、依赖更新和迁移;标记高风险变更(数据库迁移、API 契约变更、新外部集成、认证变更);检查应纳入或排除的开放 PR。
- 生成清单:根据项目技术栈(跳过无关部分)、发布风险等级(风险越高门槛越多)、部署基础设施(Kubernetes、无服务器、裸金属等)以及发布类型(主版本、次版本、补丁)定制清单。
- 确定文件编号:读取 .chalk/docs/engineering/ 中的文件名,找到最大编号,下一个编号为最大值加一。
- 写入清单:保存到 .chalk/docs/engineering/<n>release_checklist<version>.md,其中 <version> 用下划线代替点号(例如 v1_2_0)。
- 确认:告知用户清单已创建及其路径,并突出需要额外关注的高风险条目。
使用方式
该技能由用户触发,触发条件为要求准备发布、创建发布计划或交付版本。技能会按上述工作流自动执行,无需手动分步调用。输出文件结构包含:标题(版本号)、最后更新日期、发布信息(发布日期、发布经理、风险等级、摘要)、本次发布变更(由 git log 自动生成,按功能、修复、杂项分组)、发布前(代码冻结、依赖审计、迁移审查)、测试(预发布部署、测试执行、手动验证)、部署(功能开关、监控、部署执行)、回滚(触发条件、回滚流程、数据考量)、沟通(内部、外部)、部署后验证,以及按风险等级和星期几的定制指导。
适用场景
适用于需要规范化发布流程的软件项目,尤其是涉及数据库迁移、API 变更、新功能开关或高风险变更的版本发布。清单模板包含低风险(补丁发布、小缺陷修复)、中风险(次版本发布、新功能)和高风险(主版本发布、破坏性变更、大型迁移)三档定制建议,并给出星期几的部署指导(周一至周三首选,周四仅限低风险,周五不建议,周末/节假日仅限紧急热修复)。
限制
资料未提供该技能的具体安装方式、收费模式、支持平台或运行环境要求。清单中的具体阈值(如错误率百分比、延迟毫秒数)和回滚命令需由使用者根据项目实际情况填写。技能依赖项目内 .chalk/docs/engineering/ 目录结构和 git 仓库历史,若这些前提不存在,部分功能可能无法正常工作。