fix: require product report parameter clarification

skills/odps-product-efficiency-report/SKILL.md

@@ -11,27 +11,41 @@ description: 生成、执行、校验并解释参数化 ODPS 产品效率实验
 
 依赖 `pyodps` 和 `pandas`。随 Skill 分发的 ODPS 客户端读取 `ODPS_ACCESS_ID`、`ODPS_ACCESS_SECRET`、`ODPS_PROJECT` 和 `ODPS_ENDPOINT`。不得把这些值写入请求 JSON、SQL、输出文件或回复。
 
+## 执行前强制确认
+
+在生成请求 JSON、SQL、执行 ODPS 或上传飞书前，确认用户已经明确给出以下口径：
+
+- 日期或日期范围；“今天”“昨天”等相对日期需解析为具体 `yyyyMMdd` 并回显。
+- 离线或实时数据。
+- 产品类型 `app_type`。
+- `rootSessionId` 倒数第几位分桶。
+- 哪些尾号属于实验组。
+- 全部版本或指定版本。
+
+任一项缺失时，先用一个简短问题集中询问缺失项；不得从旧报表、目录名、历史习惯或默认值猜测。用户已经明确全部口径时无需重复确认。对照组未指定时，只有在实验组已明确后才可使用 `0-f` 的补集，并在执行前回显。
+
 ## 工作流程
 
 1. 阅读 [metrics.md](references/metrics.md) 和 [raw-output-contract.md](references/raw-output-contract.md)。
-2. 在用户指定输出目录把参数写入 `request.json`。
-3. 规范化并校验参数：
+2. 执行“执行前强制确认”；存在缺失项时停止，不生成文件、不查询、不上传。
+3. 在用户指定输出目录把参数写入 `request.json`。
+4. 规范化并校验参数：
 
    `python3 "$SKILL_DIR/scripts/normalize_request.py" request.json > normalized.json`
 
-4. 明确回显日期、模式、数据表、分桶位置和分组、版本策略及企微处理方式。
-5. 生成一个符合原始事实契约的参数化 SQL。不得搜索或依赖外部 `AGENTS.md`、特定日期 SQL 或本地 runner。
-6. 预检全部日期、数据表、产品类型、分桶表达式、版本条件、分组标签和渠道排除条件。SQL 必须为每天生成完整 16 个桶。
-7. 只提交一个 ODPS 实例：
+5. 明确回显日期、模式、数据表、分桶位置和分组、版本策略及企微处理方式。
+6. 生成一个符合原始事实契约的参数化 SQL。不得搜索或依赖外部 `AGENTS.md`、特定日期 SQL 或本地 runner。
+7. 预检全部日期、数据表、产品类型、分桶表达式、版本条件、分组标签和渠道排除条件。SQL 必须为每天生成完整 16 个桶。
+8. 只提交一个 ODPS 实例：
 
    `python3 "$SKILL_DIR/scripts/run_sql.py" query.sql raw_facts.csv`
 
-8. 生成标准完整报表和聚合报表：
+9. 生成标准完整报表和聚合报表：
 
    `python3 "$SKILL_DIR/scripts/format_report.py" normalized.json raw_facts.csv full_report.csv --aggregate-output aggregate_report.csv`
 
-9. 执行 [metrics.md](references/metrics.md) 中的全部校验，并分别解释头部、推荐和全部流量。
-10. 仅当用户明确要求上传飞书时，使用 `$feishu-data-publisher` 发布最终 CSV 或 Excel；未明确要求时只保留本地结果。
+10. 执行 [metrics.md](references/metrics.md) 中的全部校验，并分别解释头部、推荐和全部流量。
+11. 仅当用户明确要求上传飞书时，使用 `$feishu-data-publisher` 发布最终 CSV 或 Excel；未明确要求时只保留本地结果。
 
 ## 参数规则