Ads Brain Planning Create Pipeline 1.0.0

规划 Agent 创编 Pipeline

1. 定位

本 Skill 定义新框架下的创编状态机，只服务“从无到有生成投放方案”的场景。

当前阶段只做内容层定义：

• 暂不接入 agent-card.json。
• 暂不影响现有线上路由。
• 不直接调用执行 Tool。
• 不维护 create_campaign 字段细节。
• 目标是成为新的创编内容主线，完整承载投前创编所需的业务规则。

---

2. 创编边界

2.1 适用场景

• 用户要求新建广告计划。
• 用户要求冷启投放方案。
• 用户要求“帮我搭一个计划”“给我出一个投放方案”。
• 用户没有明确指定存量计划、单元或创意对象，但希望生成投放策略。
• 上一轮已有创编草案，本轮用户确认、局部调整或要求解释。

2.2 不适用场景

• 存量计划掉量、超成本、不起量等问题定位。
• 已有计划、单元、创意、素材的优化。
• 对草案说“更激进一点 / 更保守一点 / 更精准一点”等策略改善诉求，此类应转 optimize，由优化 Pipeline 输出 draft patch。
• 标准投、合约、品专等当前非简单投新建能力。

---

3. 创编 Pipeline 业务规则总览

本 Pipeline 直接定义 S0～S6 创编内容主线。所有投前创编所需的状态识别、场景门禁、上下文归一化、数据依据、准入规则、草案生成、结构化创建和输出约束，都在本 Skill 中自洽表达。

3.1 S0～S6 规则索引

3.2 Tool 与 Evidence 使用语义

本 Pipeline 只描述内容层规则，不新增 Tool 接入；但创编过程中需要使用以下 Tool / Evidence 语义。

3.3 Evidence Pack 复用纪律

若上下文中已经注入 【PlanningPrehook Evidence Pack】：

1. status=SUCCESS/EMPTY 且有内容的数据块必须直接复用，不得重复调用同名 Tool。
2. simple-clue-campaign-exists=SKIPPED_NOT_CLUE_CREATE_INTENT 时，不得把泛化新建诉求默认判为客资收集。
3. 只有 Evidence 缺失、失败、超时、跳过，或用户修改预算/目标/对象/时间窗/版位/优化目标等关键口径时，才允许局部刷新。
4. pending、WORKING、timeout、数据准备中 等状态本轮不得反复重试，应使用已成功 Evidence 降级输出。
5. Evidence 失败不阻断自然语言规划；但准入失败、准入为空、schema 校验失败、客资唯一性命中时，不得输出 create_campaign。

3.4 创编方案产出依赖链

创编方案不是一次性拼装出来的，必须按“先识别客户与场景，再确定目标与约束，再生成结构和策略，最后生成可执行配置”的顺序产出。

依赖顺序硬约束：

1. 未完成场景门禁前，不生成 launch_plan_draft。
2. 未完成上下文归一化前，不生成预算、出价、人群、创意结论。
3. 未完成简单投准入前，不生成 create_campaign。
4. 未命中客资场景时，不触发客资唯一性检查。
5. 客资唯一性命中、准入失败、schema 校验失败时，只输出文字方案和 warnings，不输出 create_campaign。
6. create_campaign 必须由 simple-create 生成，创编 Pipeline 不直接拼最终字段。

---

4. 状态机总览

S0 会话状态识别
  ↓
S1 创编场景门禁
  ↓
S2 创编上下文归一化
  ↓
S3 创建必要门禁
  ↓
S4 生成 launch_plan_draft
  ↓
S5 simple-create 生成 create_campaign
  ↓
S6 输出 plan + create_campaign + next_action

---

5. S0 会话状态识别

目标：避免多轮中重复生成方案或重复生成 create_campaign。

输出：

{
  "create_conversation_state": "first_turn | confirm_create | revise_partial | optimize_draft | explain_plan | restart_create",
  "reuse_previous_campaign": true,
  "revision_fields": []
}

---

6. S1 创编场景门禁

目标：判断当前请求是否支持进入创编主线。

6.1 支持

• 简单投新建。
• 未指定复杂投放形态的新建投放规划。

6.2 阻断

输出：

{
  "supported": true,
  "create_scene": "simple_create",
  "blocked_reason": null,
  "route_hint": null
}

---

7. S2 创编上下文归一化

目标：把用户输入、历史会话、经营信息、Evidence 摘要整理成稳定上下文。

输入来源优先级：

本轮用户明确表达 > conversation_history 中最近确认内容 > 已收集经营信息 > Evidence 摘要 > 默认假设

输出：

{
  "advertiser_id_source": "metadata",
  "business_context": {},
  "marketing_goal": "lead_generation | conversion | exposure | unknown",
  "launch_context": "cold_start | new_product | daily_operation | promotion | unknown",
  "strategy_style": "aggressive | conservative | precise | exploratory | unknown",
  "target_audience_hint": "string | null",
  "budget_hint": {
    "amount": null,
    "period": "daily | total | unknown"
  },
  "date_range_hint": {
    "start": null,
    "end": null
  },
  "geo_hint": [],
  "constraints": [],
  "assumptions": [],
  "missing_fields": [],
  "scenario_tags": []
}

要求：

• 所有默认值必须写入 assumptions。
• 用户本轮明确表达优先于历史信息和 Evidence。
• 不输出完整画像报告，只保留与创编决策相关的摘要。
• 生成 scenario_tags，供后续场景化 Guard 使用。

7.1 三维意图解析

三维意图解析不以长篇过程输出，而是沉淀进结构化上下文。

“0 提问策略”定义如下：

• 行业/品类缺失时，优先通过客户画像或已收集经营信息补齐，仍缺失则用通用经验降级。
• 日预算缺失时，可按冷启标准做默认假设，但必须写入 assumptions 并在输出注意事项中说明。
• 地域、人群、时间等缺失时，能从经营信息/Evidence 推断则推断；不能安全默认时才追问。
• 全程不因非关键字段缺失阻断自然语言方案。

7.2 数据研判

数据研判结果应沉淀为 evidence_refs、assumptions、warnings 和 draft 的各策略字段。

必须考虑的依据：

数据失败降级：

• 单个 Evidence 失败不阻断整体自然语言规划。
• 已成功 Evidence 要继续使用。
• 缺失维度只能进入 warnings 或 assumptions，不得编造。
• 准入失败、准入为空、客资唯一性命中、schema 校验失败时，不得输出 create_campaign。

---

8. S3 创建必要门禁

目标：只判断“能不能继续生成创建参数”。

8.1 必跑 Guard

8.2 场景化 Guard

8.3 输出

{
  "eligible": true,
  "blocked_reasons": [],
  "available_create_options": {},
  "lead_generation_guard": {
    "triggered": false,
    "status": "skipped",
    "skip_reason": "not_lead_generation",
    "action": "continue | stop_create | suggest_optimize_existing"
  },
  "required_clarifications": []
}

要求：

• 客资唯一性只在客资场景触发，不得全局必跑。
• 准入失败时不得生成 create_campaign。
• 被 Guard 阻断时仍可输出自然语言说明，但 next_action 不得为 confirm_execution。

8.4 简单投准入规则

准入全集约束如下：

1. 简单投新建场景下，生成 create_campaign 前必须完成简单投准入检查。
2. 准入成功且返回非空 availableKeys / available 时，create_campaign 中的营销诉求 / 投放模式必须命中全集。
3. 不得把客户原始营销诉求擅自替换成全集中的相近目标。例如产品种草与种草直达语义不同，不得自动互相替代。
4. 准入调用失败、canCreateSimpleAd=false、available 为空时，自然语言规划可继续，但不得输出 create_campaign。
5. 客户可见文案不得展示 availableKeys、available、内部枚举码或数字编码。

8.5 客资唯一性规则

客资唯一计划门禁如下：

1. 只有本轮诉求或会话上下文明确指向客资收集 / 留资 / 线索 / 表单 / 私信 / 咨询 / 获客 / 到店咨询时，才触发 lead_generation_guard。
2. 泛化“新建简单投 / 开计划 / 投放方案 / 营销规划”不得默认判定为客资收集。
3. 若明确客资新建且已存在简单投客资计划，不得生成新的 create_campaign。
4. 老客仍必须输出文字规划方向，围绕人群、内容、预算出价、观察指标和现有计划优化给建议。
5. 客户可见文案只说明“当前账户已有简单投客资计划，不能再新建第二条，本次方向可用于现有计划优化”，不得展示 Tool 名、计划 ID、内部字段。
6. 客资收集在当前简单投新建链路只支持全自动；用户坚持半自动或高度自定义客资时，只输出文字规划，不生成 create_campaign。

---

9. S4 生成 launch_plan_draft

目标：生成 planning 与 simple-create 之间的稳定中间态。

launch_plan_draft 示例：

{
  "marketing_goal": "string",
  "target_audience": "string",
  "budget": {
    "amount": null,
    "period": "daily | total | unknown",
    "rationale": "string"
  },
  "date_range": {
    "start": null,
    "end": null,
    "rationale": "string"
  },
  "geo": {
    "names": [],
    "rationale": "string"
  },
  "bidding_strategy": {
    "name": "string",
    "rationale": "string"
  },
  "audience_strategy": {
    "summary": "string",
    "included": [],
    "excluded": []
  },
  "creative_direction": [],
  "delivery_strategy": "string",
  "assumptions": [],
  "warnings": [],
  "evidence_refs": []
}

原则：

• 本阶段负责策略，不负责最终 create_campaign 字段枚举。
• launch_plan_draft 必须可被测试断言。
• 不展示内部枚举码。
• 不编造不存在的 Evidence。

9.1 方案生成规则

核心方案生成逻辑如下：

1. 先相似、再差异：
   • 相似性规划：延续客户历史有效经验，如高效投放位置、出价方式、预算节奏、素材方向。
   • 差异性改善：针对历史短板做改进，如创意疲劳、漏斗通过率低、人群过宽或过窄、预算利用不足。
2. 目标达成与阶段规划：
   • 给出核心目标、预算/出价、人群、内容、投放节奏和观察指标。
   • 阶段规划首轮可简写，详细版留到用户追问时展开。
3. 基建延续纪律：
   • AdIndex 只作为历史风格和约束信号，不得覆盖用户本轮明确诉求。
   • isNewAdvertiser=true 只表示无在线基建可延续，不控制最终输出形态。
4. 准入全集约束：
   • draft 中可描述客户原始营销诉求。
   • 但进入 create_campaign 的落地配置必须满足准入全集。
5. Evidence 引用纪律：
   • 只引用已成功或明确为空的 Evidence。
   • 对失败、超时、pending 的数据，只能说明“当前缺少该维度”，不能编造数值。

9.2 draft 字段与创编要素映射

---

10. S5 simple-create 生成 create_campaign

目标：把 launch_plan_draft 交给 ads-brain-simple-create 转换为 create_campaign。

流程：

launch_plan_draft
  ↓
ads-brain-simple-create
  ↓
getGeoCode / 字段映射 / 默认值落地
  ↓
validateCreateCampaignSchema
  ↓
create_campaign 或 validation_errors

要求：

• simple-create 输入应是 launch_plan_draft 或等价结构化草案。
• simple-create 不重新做完整策略规划。
• schema 校验失败时返回 validation_errors，不得进入执行确认。

---

11. S6 输出

输出结构：

{
  "capability": "create",
  "create_conversation_state": "string",
  "gate_validation": {},
  "plan": "string",
  "launch_plan_draft": {},
  "create_campaign": {},
  "warnings": [],
  "next_action": "confirm_execution | ask_clarification | unsupported | no_action"
}

输出原则：

• 首轮输出精简版方案。
• 假设条件必须展示。
• 不展示内部字段、内部枚举、工具参数。
• create_campaign 校验通过后，next_action 才能是 confirm_execution。
• 如果只是解释或被阻断，next_action 应为 no_action / ask_clarification / unsupported。

11.1 渐进式输出

首轮默认只输出精简版方案，不一次性铺开所有依据。

精简版建议包含：

1. 系统已掌握：只保留影响规划的关键信息，不逐计划逐版位展开。
2. 投放规划 Brief：一句话概括本次投放目标和策略。
3. 规划聚焦：说明本次主要解决什么问题。
4. 人群策略：核心人群和拓展方向。
5. 内容策略：素材方向、标题钩子、卖点表达。
6. 投放策略：预算、出价、节奏、地域等关键取值。
7. 预估结果：给区间和假设，不编造确定性数字。
8. 分阶段实施：首轮简版，详细版追问再展开。
9. 需注意：默认假设、数据缺失、准入限制、客资唯一性等。
10. 下一步：根据 next_action 指引确认、追问或终止。

11.2 create_campaign 输出规则

1. 只有真实委托 ads-brain-simple-create 并拿到完整 create_campaign，且 validateCreateCampaignSchema(valid=true) 时，才能输出结构化创建结果。
2. 准入失败、准入为空、Tool 调用失败、schema 校验失败、客资唯一性命中时，不能输出 JSON 代码块。
3. 新 Pipeline 推荐统一输出 plan + launch_plan_draft + create_campaign + next_action，由后续接入层决定展示形式。
4. create_campaign 不得因精简版文字长度限制而截断。

11.3 客户可见文案硬约束

客户可见文案必须中文化，禁止泄漏：

• 内部枚举码：MT4、MT9、MT13、MT20、MT9_AUTO、MT13_AUTO 等。
• 字段名和数字编码：biddingStrategy=7、targetType=2、placement=7 等。
• apiKey / Tool 名：query_industry_metrics、checkSimpleCreateEligibility 等。
• 基建摘要中的括号数字：例如“客资收集（9）”“最大转化（7）”。
• 内部过渡语：例如“准入校验通过”“现有基建如下”“下面输出方案”。

必须统一翻译为业务中文名，例如「客资收集」「种草直达」「应用下载」「全自动」「半自动」「稳定成本」「最大转化」「信息流」「搜索」「视频内流」。

---

12. 与优化 Pipeline 的回流关系

当用户对创编草案提出“更激进 / 更保守 / 更精准 / 预算怎么分更好”等改善诉求时：

1. 创编 Pipeline 不直接重写完整方案。
2. 转入 Optimize Pipeline，optimization_context_type=draft_plan。
3. Optimize Pipeline 输出 draft_patch 或 optimization_plan。
4. 如用户确认 patch，再回流 S4/S5 重新生成 launch_plan_draft / create_campaign。

---

13. 非目标

本 Skill 不做：

• 不处理存量投放诊断。
• 不处理完整投中优化。
• 不直接执行创建。
• 不维护最终 create schema 细节。
• 不处理客户画像查询主流程。