release-engineering · git:20260817.7e2f9dd · 2026-08-17 · sha256 d04af47e84d274b6

release-engineering git:20260817.7e2f9ddA

Immutable. This exact content is served forever at /api/v1/blob/d04af47e84d274b6.

---
name: release-engineering
description: 约束版本、Tag、制品、分发、部署、生产迁移、渐进发布、健康门禁、回滚与发布授权的证据化判断和执行。
---

# 发布工程执行契约

## 目标

约束被本专业命中的版本、制品、分发与运行变更工作,使结论、实施、验证和项目记忆均以当前权威证据为准,并保持在发布工程所有权与当前授权内。

## 执行协议

1. 确认本次发布工程裁决范围、目标对象、影响边界、当前授权与验证边界。
2. 阅读 [专业能力准则](references/principles.md) 的能力索引,并完整读取本次实际命中的能力条目。
3. 阅读 [项目记忆](references/memory.md) 中本次命中的核心主题,依“项目记忆”章的定位规则唯一确认目标 Git 根与 `product-id` 后,再读取 `docs/product-studio/<product-id>/release-engineering.md` 中与本次工作相关的已有事实;项目记忆只作背景,仓库、制品、渠道与运行环境的当前权威优先。
4. 在授权范围内完成最小充分实现、审查或外部动作,不改写其他专业已确认的语义。
5. 运行与风险相称的检查,核对最终差异、外部状态、副作用及未覆盖边界。
6. 若本轮改变了 [项目记忆](references/memory.md) 所列的核心认知,在既有写权限内更新或移除事实册中的旧内容;没有变化时不触碰事实册。

## 输出契约

- 给出发布工程裁决、实现、审查或执行结果及其适用边界。
- 列出实际修改的文件或外部状态、保持不变的关键契约和剩余未知项。
- 记录已运行验证、关键结果、证据能证明的范围与不能证明的范围。
- 项目记忆只保留会持续改变后续发布判断的当前核心认知;计划、推断、任务过程、运行快照和单次结果不写入事实册。

## 完成条件

- 请求范围内的发布工程目标已经实现或形成有证据的裁决。
- 已执行动作取得与风险相称的静态、自动化或真实环境验证。
- 最终差异与外部状态变化仅含授权范围,风险和证据缺口均已明示。
- 已读取相关项目记忆;核心认知发生变化时,事实册已在授权范围内更新。
- 当前版本、摘要、实例、流量、健康值与迁移进度均未写入事实册。

## 停止条件

- 缺少会实质改变处置方向、外部结果或安全边界的必要契约。
- 仓库状态、目标产品、目标对象或授权范围无法唯一确认。
- 所需真实环境、凭据或外部决定不可得,且替代证据不足以支持结论。
- 继续操作将越过用户授权、既定停止条件或其他专业的唯一决策权。

## 权限与边界规则

- 只修改请求授权且属于当前产品范围的文件或外部状态,不回滚或整理无关改动。
- 发布工程拥有发布对象、执行门禁与运行证据裁决;产品价值、系统边界、实现语义、数据库物理方案、安全政策和质量标准不由本技能重定义。
- 不因本技能命中而规定其他技能的选择、顺序、并行关系或交接方式。
- 提交、Tag、推送、远端 Release、晋级、部署、迁移、切流和回滚均须取得覆盖该具体动作的当前授权。
- 不把清单、配置、运行查询或发布记录机械转抄为事实;只保存会改变后续发布判断且难以从单一入口重建的稳定语义。

## 参考资料

- [专业能力准则](references/principles.md):发布工程方法、证据标准与专业禁区的唯一详细来源。
- [项目记忆](references/memory.md):本专业应记住的项目核心认知。

## 项目记忆

- 先根据用户范围、产品入口与元数据、相关项目根、目标代码和调用链唯一确认目标 Git 根与 `product-id`;`product-id` 必须在仓库内唯一、稳定,且是非 `.` 或 `..`、不含 `/` 或 `\` 的安全单级目录名。归属不唯一或名称不安全时不猜测或创建事实册。
- 工作前读取 `references/memory.md` 中本次命中的核心主题,再读取 `docs/product-studio/<product-id>/release-engineering.md` 中的相关事实;事实册不存在时以当前仓库为准,不以缺少记忆阻断工作。
- 项目记忆仅作上下文;与当前仓库、制品、渠道或运行环境事实冲突时,以当前权威为准。
- 只写入已经由当前代码、配置、契约、调用链或验证证据确认,会持续影响后续判断且难从局部代码直接看清,并属于本专业所有权的项目核心认知;不复制源码、配置或可生成清单。
- 本轮改变核心认知时,在现有写权限内更新或移除旧内容,只保留当前仍成立的事实;同一认知只保留一处,不追加历史版本,不得因本节扩大写入范围。
- 不记录秘密、用户数据、任务过程、文件改动清单、迁移进度、运行快照、当前版本、一次性结果或未经验证的推断。