Add XDFX skill data artifacts

skills-data/xdfx-step1-audience/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: xdfx-step1-audience
+description: xdfx 拆分流程 step1，分析受众目标，选择最优3个受众，并保存受众与受众账号。
+---
+
+# Step1 受众分析与入库
+
+不要手写接口调用，直接运行：
+
+```bash
+python scripts/xdfx_flow.py --mode step1 --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
+```
+
+`xdfx-input.json` 必须包含：
+
+```json
+{
+  "api_base": "https://ch1.b.uat.4.cn",
+  "taskId": "真实任务id",
+  "actionId": "真实xdfx行动id",
+  "mubiao": "完整行动目标",
+  "direction": "U方向",
+  "platform": "fb"
+}
+```
+
+鉴权和证书由脚本兜底处理：缺少 `Authorization` 或接口返回 401 时，自动用 `admin / ch@user` 登录获取 `access_token` 并重试原接口一次；HTTPS 默认不校验证书，需校验证书时追加 `--verify-ssl`。
+
+本步骤由脚本完成：
+
+- 调用受众分析模型接口。
+- 自动解析流式 answer 与候选账号。
+- 流式模型接口首次空响应、模型无响应或超时类返回会自动再调用一次。
+- 抽取结构化受众。
+- 选择最优 3 个受众。
+- 保存受众目标。
+- 保存受众目标账号。
+- 同步前端步骤状态 `step-analysis-audience` 与 `step-analysis-keypoint`。
+- 把 `designId`、账号、错误明细写入 `xdfx-flow-state.json`。
+
+执行后检查 `xdfx-flow-summary.md`。如果 `errors` 非空，向用户报告失败接口、状态码、响应正文摘要。
+
+## 步骤反馈
+
+命令结束会输出 `STEP_FEEDBACK {...}`。必须先根据这行反馈告诉用户 Step1 的完成状态、当前受众入库数量和新增错误数，再决定是否继续下一步。
+
+执行过程中会输出 `OP_FEEDBACK {...}`。每出现一次都要告诉用户当前操作和接口 URL。
+
+如果出现 `ERROR_FEEDBACK {...}`，必须立即告诉用户失败阶段、接口 URL、状态码、请求摘要和响应摘要。
+
+如果出现 `JSON_PARSE_REVIEW {...}`，必须查看 `responseExcerpt`，判断是否能识别受众 JSON；无法确认时重跑 Step1。