name: release-readiness-check description: 在发版前执行发布门禁检查，并输出“可发布/带条件可发布/不可发布”结论与阻断项。适用于部署前、打 tag 前、发布分支合并前。

Release Readiness Check

概览

对当前版本做一次可执行的发布检查，优先识别阻断项和高风险项，给出明确发布结论。

中文输出风格

• 第一行直接给结论：可发布、带条件可发布、不可发布。
• 阻断项必须放在最前，并按影响面排序。
• 每个阻断项包含：证据、影响、最小处置、负责人（若可确定）。
• 最后必须给出 发布后观察项，避免“通过就结束”。

命令习惯（Windows / PowerShell）

优先使用以下命令：

git diff --name-only
git diff

.\.venv\Scripts\python -m pytest
.\.venv\Scripts\python -m pytest -m integration
.\.venv\Scripts\python -m ruff check .
.\.venv\Scripts\python -m mypy crawlers storage query --ignore-missing-imports

.\.venv\Scripts\python fish_intel_mvp\run_one.py jd
.\.venv\Scripts\python fish_intel_mvp\run_one.py moa

工作流

1. 确认发布范围。

• 分支、commit 范围、目标环境、发布时间窗口。

1. 执行质量门禁。

• Lint、类型检查、关键测试是否通过。

1. 配置与密钥安全检查。

• 环境变量齐全、无本地调试残留、无敏感信息入库或入日志。

1. 数据路径安全检查。

• 写库兼容性、幂等性、迁移与回滚可行性。

1. 运维可观测性检查。

• 关键任务日志、告警、失败重试是否可用。

1. 输出发布结论与行动项。

• 明确阻断项、条件项、发布前必须完成动作。

输出约定

按以下顺序输出：

1. 发布结论
2. 阻断项
3. 高风险警告
4. 发布前必须完成
5. 发布后观察项

仓库重点

优先关注：

• crawlers/、fish_intel_mvp/jobs/ 的行为变更。
• storage/、fish_intel_mvp/common/db.py、schema.sql 的数据安全。
• .env.example、.env.local.example 的配置一致性。
• pyproject.toml、pytest.ini 对质量门禁的要求。

参考资料

• references/release-gates.md
• references/report-template.md