---
name: soloforge-release-note
description: 生成面向发布执行者和受影响用户的可追溯发布说明。
when: 发布说明 / release_note / operate 阶段
---

# 发布说明

## 适用性

本次变更已形成确定发布范围、测试结果和部署方案后使用。若仍有阻断 finding、未执行关键测试或未确认恢复方案，不得写“可发布”。

## 事实输入

- 实际变更、需求、兼容性影响、适用的数据演进/迁移和配置变化。
- 最新 full verify、`sf_review` 状态、测试报告和部署方案。
- 发布窗口、执行者、目标环境和用户沟通要求。
- `template.md` 与 `examples.md`。

## 关键决策

- 哪些变化需要用户操作、客户端升级、数据迁移或停机。
- 发布顺序、观察窗口、停止条件和恢复方式。
- 已知限制和接受风险必须引用明确决策，不得淡化。

## 产出方法

1. 从真实 diff、任务产物和验证记录生成变更摘要。
2. 区分新增、修复、breaking change、迁移、配置和运维影响。
3. 引用测试与审查结论，写明未覆盖范围和残余风险。
4. 给出按顺序可执行的发布、验证、停止和恢复步骤。
5. 面向用户的内容使用结果语言，面向执行者的内容保留精确技术细节。

## 禁止项

- 不得复制提交信息列表当发布说明。
- 不得写“已全部验证”而没有可追溯记录。
- 不得隐瞒 breaking change、迁移窗口、已知限制或接受风险。
- 不得伪造版本号、发布日期、执行者或生产验证结果。

## 交付自检

- 发布范围与实际变更和任务 scope 一致。
- 所有数据、配置、接口和用户行为变化都有影响说明。
- 验证引用指向最新证据，失败或过期证据没有被引用为通过。
- 发布与恢复步骤能由未参与开发的人独立执行。

## 权威验证

调用 `sf_verify action="full" task_id="当前任务ID" artifact="release_note"`。随后由 `sf_task action="deliver"` 再检查全部证据的新鲜度与审查闭环。

## 交付前对抗审查

`sf_verify` 通过只证明结构层；语义质量（发布范围是否与实际变更一致、breaking/迁移/恢复步骤是否可被未参与开发的人独立执行、是否含空话或无法证伪的承诺）须经独立对抗审查。advance/deliver 前用 `sf_review action="start" task_id="当前任务ID" artifact="release_note"` 发起 per_artifact 审查，用**独立 session/subagent**（非产出本产物的同一会话）执行返回的 prompt、submit findings，按 next_step 完成 K 次独立采样与闭环。deliver 会阻断未完成/未闭环的审查；活跃豁免与被驳回 error 会被注入审查 focus 供独立复核。