pikasTech-unidesk/docs/MDTODO/details/sub2api-upstream-reliability/R3.7_Task_Report.md

R3.7 公告范围规则固化报告

目标

补偿公告不能只写“符合条件的用户”。公告必须让操作者和接收方明确知道补偿对应哪个时间段、哪些用户以及多少金额；本次只固化规则，不重新发布或修改既有公告。

Skill 规则

Sub2API codex-pool.md 已明确：

• 每次 create 的用户可见正文必须写明业务时间范围和接收范围。
• targeting 只控制公告投递，不能替代补偿资格或实际发放范围。
• 补偿公告必须列出故障影响时间窗或补偿资格统计时间窗。
• 必须列出全部实际接收用户的稳定用户 ID 和邮箱；邮箱可以脱敏，但禁止只写泛化描述。
• 必须列出每人金额和本批总额。
• 候选名单与实际发放名单不一致时，必须同时写明两者和排除原因。

CLI 可见性

公告 create 的 dry-run 和 confirm 输出新增两条固定人工检查：

• SCOPE-CHECK：正文必须明确时间范围和接收范围，targeting 不能替代业务范围。
• COMPENSATION-CHECK：列出全部接收用户 ID、可脱敏邮箱、每人金额和总额。

CLI 不通过标题关键词猜测公告类型，也不做容易误判的内容关键词自动通过；最终 confirm 前由操作者核对完整正文。

验证

• 使用包含参数化时间窗、用户 ID、脱敏邮箱、每人金额和总额的公告执行 dry-run。
• 输出 mutation=false、writeAttempted=0，两条范围检查和完整正文均可见。
• 未登录运行面，未调用公告创建 API，未修改或重新发布公告 ID 1。
• Sub2API skill quick_validate 通过。
• git diff --check 通过。

结论

后续补偿公告在发布前会同时经过 skill 规则和 CLI create 预览提醒，范围必须可由时间窗和用户 ID 对账；上次公告仅保留历史事实，不做重发。