siluzan-tso-cli 1.1.29-beta.2 → 1.1.29-beta.21

package/dist/skill/references/core/playbooks.md

@@ -1,42 +1,43 @@
 # 工作流目录 · 分析 / 报告类（P1–P9）
 
-> **范围**：CLI 拉数 → 脚本读盘 → Agent 撰稿 → 交付的报告/分析任务。操作/管理类（开户、广告 CRUD、优化、预警、推送、线索、财务、权限、巡检）见 `references/core/workflows.md`（W1–W12）。
+> **范围**：CLI 拉数 → 脚本读盘 → Agent 撰稿 → 交付的报告/分析任务。操作/管理类见 `references/core/workflows.md`（W1–W12）。
 >
-> **每张卡片结构统一**：`触发 / 必读 / 步骤 / 交付与确认`。开始前按 `references/core/agent-conventions.md` § 文档加载纪律 Read 卡片列出的 references（**不因同对话内刚做过其它工作流而跳过**）。
-
-| 编号 | 业务 | 一句话 |
-| ---- | ---- | ------ |
-| P1 | 单账户投放画像 | 单户拉数 + 诊断画像 |
-| P2 | 多账户余额扫描 | 续航不足/充值预警巡检 |
-| P3 | 多账户投放画像汇总 | accounts-digest 多户对比表 |
-| P4 | Google 账户周期报告 | 默认 8 维周期汇总 |
-| P4-FB | Meta/Facebook 周期报告 | facebook-analysis 5–7 维，默认 HTML |
-| P5 | 多账户多维度批处理 | google-analysis-batch，禁外层 for-loop |
-| P6 | OKKI 周报 | 固定模板多 Sheet xlsx |
-| P7 | Google 询盘分析 | 严格 3 个月 8 Sheet xlsx |
-| P8 | 网站诊断 | website-diagnosis，默认 HTML |
-| P9 | 战略市场分析 | market-analysis，默认 HTML |
+> **通用纪律统一见 `references/core/agent-conventions.md`**（加载纪律、数据处理协议「摘要 → outline → 脚本读 JSON」、时间范围反问、币种分表、交付前自检），各卡片**不再重复**，只写任务特有步骤。每张卡片结构统一：`触发 / 必读 / 步骤 / 交付与确认`。
+
+| 编号  | 业务                   | 一句话                                 |
+| ----- | ---------------------- | -------------------------------------- |
+| P1    | 单账户投放画像         | 单户拉数 + 诊断画像                    |
+| P2    | 多账户余额扫描         | 续航不足/充值预警巡检                  |
+| P3    | 多账户投放画像汇总     | accounts-digest 多户对比表             |
+| P4    | Google 账户周期报告    | 默认 8 维周期汇总                      |
+| P4-FB | Meta/Facebook 周期报告 | facebook-analysis 5–7 维，默认 HTML    |
+| P5    | 多账户多维度批处理     | google-analysis-batch，禁外层 for-loop |
+| P6    | OKKI 周报              | 固定模板多 Sheet xlsx                  |
+| P7    | Google 询盘分析        | 严格 3 个月 8 Sheet xlsx               |
+| P8    | 网站诊断               | website-diagnosis，默认 HTML           |
+| P9    | 战略市场分析           | market-analysis，默认 HTML             |
 
 ---
 
 ## P1 · 单账户投放画像
 
 - **触发**：对单个 Google 账户做投放画像/诊断/健康检查。
-- **必读**：`analytics/account-analytics.md`、`accounts/currency.md`、`core/tips.md`、`core/deliverable-preflight.md`；诊断报告加 `report-templates/google-ads-diagnosis.md` + `report-templates/google-account-diagnosis-report.md`。
+- **必读**：`analytics/account-analytics.md`；诊断报告加 `references/report-templates/google-ads-diagnosis.md` + `references/report-templates/google-account-diagnosis-report.md`。
 - **步骤**：
-  1. 反问统计区间（用户授权「你决定」时按 `agent-conventions.md` 白名单并写明区间）。
+  1. 确认统计区间（规则见 conventions §五）。
   2. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-p1`（取 `currencyCode`）。
   3. `stats -m Google -a <mediaCustomerId> --start <S> --end <D> --json-out ./snap-p1`。
   4. `google-analysis -a <mediaCustomerId> --start <S> --end <D> --sections overview,campaigns,devices,geographic,keywords,daily-metrics --json-out ./snap-p1`（诊断须含 `daily-metrics` 按日趋势）。
-  5. 脚本读盘 → 撰写报告：每模块除表格外须有「分析 + 建议」；每日趋势金额/CPA 2 位小数。
-- **交付/确认**：首行标注 `统计区间：… ~ …（货币：XXX）`；**Read 最终产物**按 `deliverable-preflight.md` 自检币种与章节。
+  5. **outline 门禁**：对**每个** section Read 其 `<section>-<accountId>_*.outline.txt`（一批并行读全）确认字段树后再写脚本——字段名以 outline 为准，**禁止**凭模板/通用命名直接写（详见 conventions §三 outline 门禁）。
+  6. 脚本读盘 → 撰写报告：每模块除表格外须有「分析 + 建议」；每日趋势金额/CPA 2 位小数。
+- **交付/确认**：按 conventions §七 自检后交付。
 
 ---
 
 ## P2 · 多账户余额扫描
 
 - **触发**：多账户余额续航不足、充值预警、僵尸账户巡检。
-- **必读**：`accounts/accounts.md`（§ balance-scan）、`accounts/currency.md`。
+- **必读**：`accounts/accounts.md`（§ balance-scan）。
 - **步骤**：
   1. 全量巡检：`balance-scan -m <媒体> --threshold-days 7 --json-out ./snap-p2`（可选 `--min-balance 100` / `--target-days 60`）。
   2. 已知子集：`balance-scan -m <媒体> -a id1,id2,id3 --json-out ./snap-p2-subset`（跳过翻页）。
@@ -47,26 +48,26 @@
 ## P3 · 多账户投放画像汇总
 
 - **触发**：多账户消耗/点击/转化/CTR/CPC/CPA 汇总对比表、跨账户巡检。
-- **必读**：`accounts/accounts.md`（§ accounts-digest）、`accounts/currency.md`、`core/tips.md`。
+- **必读**：`accounts/accounts.md`（§ accounts-digest）。
 - **步骤**：
-  1. 反问时间范围后执行 `accounts-digest -m <媒体> -a id1,id2,... --start <S> --end <D> --json-out ./snap-p3`（全量则省略 `-a`）。
+  1. 确认时间范围后执行 `accounts-digest -m <媒体> -a id1,id2,... --start <S> --end <D> --json-out ./snap-p3`（全量则省略 `-a`）。
   2. 基于落盘 `data.items` 与 `meta.totals` 生成报告，**不要**再逐账户 `stats`。
-- **交付/确认**：表格覆盖用户请求的**每一个** ID（未返回的占一行标注「未返回」）；跨币种按 `currencyCode` 分表或分币种小计，**禁止**跨币种求和。
+- **交付/确认**：表格覆盖用户请求的**每一个** ID（未返回的占一行标注「未返回」）。
 
 ---
 
 ## P4 · Google 账户周期报告
 
 - **触发**：Google 账户某区间的周期/月度/季度汇总报告；或用户列出 Sheet/章节要 **Excel**（非 OKKI / 询盘）。
-- **必读**：`report-templates/google-period-report.md`、`analytics/account-analytics.md`、`core/tips.md`、`core/deliverable-preflight.md`；**要 Excel** 加 `report-templates/google-period-report-excel.md`（全文）。
+- **必读**：`references/report-templates/google-period-report.md` + `analytics/account-analytics.md`；**要 Excel** 加 `references/report-templates/google-period-report-excel.md`（全文）。
 - **步骤**：
-  1. **账户核验**：`list-accounts -m Google -k <mediaCustomerId> --json-out <dir>`；无记录则停止并告知用户，**禁止**翻页 grep 换 ID。
+  1. **账户核验**：`list-accounts -m Google -k <mediaCustomerId> --json-out <dir>`；无记录则停止并告知用户。
   2. 确认时间范围；区间 > 3 个月时分段（季度/月）。
   3. **拉数**：用户已指定 Sheet/维度 → 只拉对应 `--sections`（见 `google-period-report-excel.md` 映射表）；未指定 → 按 `google-period-report.md` 默认 8 维，并可并行追问可选追加。
-  4. **门禁**：对每个 section Read `<section>-<accountId>_*.outline.txt`（**禁止** `cat|head` 预览业务 JSON）。
+  4. **门禁**：对每个 section Read `<section>-<accountId>_*.outline.txt` 后再写脚本。
   5. 脚本读盘写产物：默认 **HTML**（`report-template*.html` 版式参考）；用户要 **Excel** → Agent 脚本写 xlsx（**禁止**宿主第三方 xlsx Skill；**无** CLI excel 子命令）。
   6. 默认 HTML 报告须含：账户概览、投放趋势、Top 关键词/系列/地区分布、优化建议；用户定制 Excel 以用户 Sheet 清单为准。
-- **交付/确认**：**Read 最终 HTML/xlsx**（或 xlsx 贴 `deliverable-preflight` 自检表 + 脚本 stdout），对照当次模板与 `deliverable-preflight.md`；`accountId` 须与用户给的 `mediaCustomerId` 一致。
+- **交付/确认**：按 conventions §七 自检；`accountId` 须与用户给的 `mediaCustomerId` 一致。
 
 > 用户用「OKKI 周报」固定话术 → 改走 **P6**，不按默认 8 维追问。
 
@@ -75,27 +76,27 @@
 ## P4-FB · Meta/Facebook 账户周期报告
 
 - **触发**：Meta/Facebook 账户周期/月报/周报或诊断报告。
-- **必读**：`report-templates/meta-period-report.md`、`assets/meta-period-report-rules.md`（内容丰富度必读）、`analytics/facebook-analysis-guide.md`、`core/deliverable-preflight.md`；要 Excel 加 `report-templates/meta-period-report-excel.md`。
+- **必读**：`references/report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md`（内容丰富度必读）+ `analytics/facebook-analysis-guide.md`；要 Excel 加 `references/report-templates/meta-period-report-excel.md`。
 - **默认交付**：**HTML**（`facebook-analysis render`）；用户明确要 Excel 时 Agent 脚本写 xlsx（步骤 1–3 不变，不调 `render`）。
 - **步骤**：
   1. `list-accounts -m MetaAd -k <mediaCustomerId> --json-out ./snap-fb` 确认账户与 `currencyCode`。
   2. 确认 `--start` / `--end`（>3 个月可分段）。
   3. **拉数**（默认 5 维，要创意加 `creative`）：`facebook-analysis -a <id> --start <S> --end <D> --json-out ./snap-fb --sections overview,ad-sets,platform,country,audience`。
   4. **分析**：脚本读落盘 JSON 聚合（见 `facebook-analysis-guide.md`）。
-  5. **写 JSON**：按 `meta-period-report-rules.md`，先 outline 后落盘 `meta-period-report.json`（`narrative` 4 条建议各 ≥150 字 + `supplementaryRecommendations` 7 维 + HTML 必填扩展）；无按日/关键词等写「接口未提供」，**禁止编造**。
+  5. **写 JSON**：按 `meta-period-report-rules.md` 落盘 `meta-period-report.json`（`narrative` 4 条建议各 ≥150 字 + `supplementaryRecommendations` 7 维 + HTML 必填扩展）；无按日/关键词等写「接口未提供」，**禁止编造**。
   6. **交付**：`facebook-analysis render --data ./meta-period-report.json --snapshot-dir ./snap-fb --out ./meta-period-report.html`。
-- **交付/确认**：**Read 最终 HTML 或 xlsx** 按 `deliverable-preflight.md` 自检。诊断场景改用 `report-templates/meta-account-diagnosis-report.md`，拉数省略 `--sections` 拉全 7 维。
+- **交付/确认**：按 conventions §七 自检。诊断场景改用 `references/report-templates/meta-account-diagnosis-report.md`，拉数省略 `--sections` 拉全 7 维。
 
 ---
 
 ## P5 · 多账户多维度批处理
 
 - **触发**：账户数 ≥ 2 且需拉取 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop。
-- **必读**：`analytics/google-analysis-batch.md`、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md`。
+- **必读**：`analytics/google-analysis-batch.md` + `analytics/account-analytics.md`；可选 `core/subagent-orchestration.md`。
 - **入口选择**：全量 → 省略 `-a`；2~10 子集 → `google-analysis -a id1,id2,...`；≥10 子集或需 resume → `google-analysis-batch run -a id1,id2,...`。
 - **步骤**：
   1. （可选）Read `subagent-orchestration.md` § P5 决定执行模式。
-  2. 反问时间范围 + 维度（默认 `campaigns,geographic,keywords`）。
+  2. 确认时间范围 + 维度（默认 `campaigns,geographic,keywords`）。
   3. 执行（推荐全量省略 `-a`）：
      ```bash
      siluzan-tso google-analysis-batch run --start <S> --end <D> \
@@ -104,7 +105,7 @@
        --min-spend 1 --keyword-limit 1000 --json-out ./snap-p5
      ```
   4. **中断只能 resume**：`google-analysis-batch resume --json-out ./snap-p5 --run-id <runId>`；只读进度用 `status`。
-  5. 产物消费：先 outline 后脚本（见 `core/tips.md`）。
+  5. **outline 门禁（消费产物前）**：每个维度 Read 其一份 `results/<accountId>/<section>-<accountId>.outline.txt`（同维度多账户同结构，读其一即可代表该维度；一批并行把所有维度 outline 读全）确认字段树后再写聚合脚本，**禁止**凭模板字段名直接写（详见 conventions §三 outline 门禁 + `analytics/google-analysis-batch.md` §产物消费）。
 - **交付/确认**：**禁止**重新 `run` 续跑；401 → 整批终止，重登录后 `resume`。
 
 ---
@@ -112,26 +113,26 @@
 ## P6 · OKKI 周报
 
 - **触发**：话术含 `使用 okki 周报模板` / `OKKI 周报` / `okki 周报`，且指向 Google 账户 + 日期区间。
-- **必读**：`report-templates/okki-weekly-google-client.md`（**全文**）、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md`。
+- **必读**：`references/report-templates/okki-weekly-google-client.md`（**全文**）+ `analytics/account-analytics.md`；可选 `core/subagent-orchestration.md`。
 - **步骤**：
   1. （可选）Read `subagent-orchestration.md` § P6 决定是否分阶段委派。
   2. 确认 `mediaCustomerId` 与 `--start` / `--end`。
   3. 同一 `--json-out` 目录执行模板命令组合：`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched`。
-  4. 先 outline 后脚本 → 交付话术 + 多 Sheet `.xlsx`（无 CLI 写表命令）。
-- **交付/确认**：**不**按 P4 默认 8 维追加；金额读 `*Yuan`、禁止手填业务数、禁止编造 ID。
+  4. 脚本读盘 → 交付话术 + 多 Sheet `.xlsx`（无 CLI 写表命令）。
+- **交付/确认**：**不**按 P4 默认 8 维追加；金额读 `*Yuan` 字段。
 
 ---
 
 ## P7 · Google 账户询盘分析
 
 - **触发**：话术含 `Google 账户询盘分析` / `分析 XXX Google 账号的询盘效果`，或同时含「询盘 + 账户 + Google」。
-- **必读**：`report-templates/google-inquiry-analysis.md`（**全文**）、`analytics/account-analytics.md`、`core/tips.md`、`analytics/geo-continents.json`；可选 `core/subagent-orchestration.md`。
+- **必读**：`references/report-templates/google-inquiry-analysis.md`（**全文**）+ `analytics/account-analytics.md` + `analytics/geo-continents.json`；可选 `core/subagent-orchestration.md`。
 - **时间窗口强约束**：**严格 3 个月** = 分析月份 + 向前 2 个完整自然月，**禁止**扩展到 7 个月。
 - **步骤**：
   1. （可选）Read `subagent-orchestration.md` § P7。
   2. 询盘资料入场：用户附文件 → 解析落盘 `./snap-inquiry/inquiries.json`；仅给账户 ID → 反问账户 + 分析月份并贴字段清单，**禁止编造询盘数据**。
   3. CLI 拉数（同一目录）：`list-accounts`、`google-analysis --sections campaigns,keywords,search-terms,campaign-geo`，并按月拉 `m1/m2/m3` 的 `campaigns,geographic`。
-  4. 先 outline 后脚本 → 聚合计算 8 Sheet 数据；国家→大洲映射读 `geo-continents.json`，**禁止**硬编码国家名。
+  4. 脚本聚合计算 8 Sheet 数据；国家→大洲映射读 `geo-continents.json`，**禁止**硬编码国家名。
 - **交付/确认**：必产 8 Sheet xlsx（版式见模板），**只能**由 Agent 脚本生成，**禁止**假设 `… excel` 子命令存在。
 
 ---
@@ -139,12 +140,12 @@
 ## P8 · 网站诊断
 
 - **触发**：对某 URL 做网站/落地页诊断、投放前网站评分，或话术含「网站诊断」「落地页质量」（**非** Google 账户 `AdvertisingDiagnosis`）。
-- **必读**：`analytics/website-diagnosis-guide.md`、`assets/website-diagnosis-rules.md`、`report-templates/website-diagnosis-report.md`、`core/tips.md`、`core/deliverable-preflight.md`。
+- **必读**：`analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `references/report-templates/website-diagnosis-report.md`。
 - **默认交付**：**HTML**（`website-diagnosis render`）；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。
 - **步骤**：
   1. 确认完整 URL（`https://` 可省略，CLI 自动补全）。
   2. 采集：`website-diagnosis collect --url <url> --json-out ./snap-web`。
-  3. 按 `website-diagnosis-rules.md`，outline → 脚本落盘 `diagnosis.json`（与 tso_agent `getWebsiteDiagnosisData` 同结构：6 模块、29 子项、`ratingId`、`coreIssuesIds`）。
+  3. 按 `website-diagnosis-rules.md` 脚本落盘 `diagnosis.json`（与 tso_agent `getWebsiteDiagnosisData` 同结构：6 模块、29 子项、`ratingId`、`coreIssuesIds`）。
   4. 出 HTML：`website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json --out ./snap-web/website-diagnosis-report.html`。
 - **交付/确认**：交付 HTML 路径；Lighthouse 缺失时在 HTML 中说明；仅需历史 ARIT 分时用 `website-diagnosis search --ids <websiteDiagnoseId>`。
 
@@ -153,7 +154,7 @@
 ## P9 · 战略市场分析
 
 - **触发**：话术含「市场分析」「行业分析」「战略市场报告」「KA 市场报告」，或对某客户/行业做竞品/GTM 战略分析（**非** `google-analysis`、**非** 网站诊断）。
-- **必读**：`analytics/market-analysis-guide.md`、`assets/market-analysis-rules.md`（原始业务维度清单）、`report-templates/market-analysis-report.md`、`core/tips.md`。
+- **必读**：`analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（原始业务维度清单）+ `references/report-templates/market-analysis-report.md`。
 - **默认交付**：**HTML**（`market-analysis render`）。
 - **步骤**：
   1. 确认客户信息（客户名称/网站/行业/核心产品至少一项）；`targetMarket` 默认「全球」、`timeRange` 默认「近12个月」（未给须写明）。

package/dist/skill/references/core/subagent-orchestration.md

@@ -9,12 +9,12 @@
 
 ## 主 Agent 与主会话的职责（不可下放）
 
-| 保留在主 Agent | 禁止默认交给子会话 |
-| -------------- | ------------------ |
-| 时间范围反问（见 `agent-conventions.md`） | 写入/修改/删除及 `--commit` 确认 |
-| 向用户说明计划并获确认 | 401 后统一停批、引导 `login` 再 `resume` |
-| 合并子会话摘要并交付用户 | 编造 `mediaCustomerId`、金额、业务数据 |
-| 选择 Playbook（P1–P7）与必读 references | 用子会话替代「每任务 Read references」 |
+| 保留在主 Agent                            | 禁止默认交给子会话                       |
+| ----------------------------------------- | ---------------------------------------- |
+| 时间范围反问（见 `agent-conventions.md`） | 写入/修改/删除及 `--commit` 确认         |
+| 向用户说明计划并获确认                    | 401 后统一停批、引导 `login` 再 `resume` |
+| 合并子会话摘要并交付用户                  | 编造 `mediaCustomerId`、金额、业务数据   |
+| 选择 Playbook（P1–P7）与必读 references   | 用子会话替代「每任务 Read references」   |
 
 子会话**不继承**父对话历史；handoff 必须**自包含**（见下文）。
 
@@ -33,17 +33,17 @@
 
 ## 决策矩阵
 
-| 信号 | 倾向 | 推荐子会话类型 | 勿委派 |
-| ---- | ---- | -------------- | ------ |
-| 单次 `list-accounts -k`、P1 三步拉数、`-h` 查参 | **主会话** | — | 为查一个账户开子会话 |
-| `balance-scan` / `accounts-digest` 单命令 | **主会话** | — | 外层 for-loop 逐账户 |
-| 预计 CLI **>2 分钟** 或 stderr/stdout 很长 | **委派** | 内置 **Bash** 或 Task + `snippets/handoff-*.md` 拉数段 | 在主会话逐行读日志 |
-| **P6 OKKI**：拉数 → 写 xlsx（两阶段） | **委派** | 阶段 1：Bash/Task 拉数；阶段 2：Task 只读 snap 写脚本 | 子会话做写操作确认 |
-| **P7 询盘**：`m1`/`m2`/`m3` 三月拉数 | **并行委派** | 3× Task（`handoff-p7-inquiry.md` 子目录变体） | 3× 主会话顺序跑 |
-| **P5** `google-analysis-batch run` 全量 | **主会话或单次 Bash** | **一次** batch；CLI 内置并发 | per-account 子会话调 API |
-| **P5** batch **完成后** 按账户聚合 | **可选并行** | N× Task，只读 `results/<accountId>/` | 子会话 `run` 新 batch |
-| 读 `google-ads/rules/*` 全文做方案 | **委派** | **Explore** + `readonly` | 主会话 Read 全文进上下文 |
-| 用户仅闲聊 / 解释字段口径 | **主会话** | — | — |
+| 信号                                            | 倾向                  | 推荐子会话类型                                         | 勿委派                   |
+| ----------------------------------------------- | --------------------- | ------------------------------------------------------ | ------------------------ |
+| 单次 `list-accounts -k`、P1 三步拉数、`-h` 查参 | **主会话**            | —                                                      | 为查一个账户开子会话     |
+| `balance-scan` / `accounts-digest` 单命令       | **主会话**            | —                                                      | 外层 for-loop 逐账户     |
+| 预计 CLI **>2 分钟** 或 stderr/stdout 很长      | **委派**              | 内置 **Bash** 或 Task + `snippets/handoff-*.md` 拉数段 | 在主会话逐行读日志       |
+| **P6 OKKI**：拉数 → 写 xlsx（两阶段）           | **委派**              | 阶段 1：Bash/Task 拉数；阶段 2：Task 只读 snap 写脚本  | 子会话做写操作确认       |
+| **P7 询盘**：`m1`/`m2`/`m3` 三月拉数            | **并行委派**          | 3× Task（`handoff-p7-inquiry.md` 子目录变体）          | 3× 主会话顺序跑          |
+| **P5** `google-analysis-batch run` 全量         | **主会话或单次 Bash** | **一次** batch；CLI 内置并发                           | per-account 子会话调 API |
+| **P5** batch **完成后** 按账户聚合              | **可选并行**          | N× Task，只读 `results/<accountId>/`                   | 子会话 `run` 新 batch    |
+| 读 `google-ads/rules/*` 全文做方案              | **委派**              | **Explore** + `readonly`                               | 主会话 Read 全文进上下文 |
+| 用户仅闲聊 / 解释字段口径                       | **主会话**            | —                                                      | —                        |
 
 ---
 
@@ -51,15 +51,15 @@
 
 ### 必填字段（写入 Task prompt 或 Bash 说明）
 
-| 字段 | 说明 |
-| ---- | ---- |
-| `playbookId` | `P5` / `P6` / `P7` 等 |
-| `snapDir` | `--json-out` 根目录（绝对或相对 cwd） |
-| `mediaCustomerId` | 来自当次 `list-accounts`，禁止猜 |
-| `dateRange` | `start` / `end`（YYYY-MM-DD）；P7 另附 `m1`/`m2`/`m3` |
-| `commands[]` | 可复制 bash 块（来自 playbook 或 report-template） |
-| `forbidden[]` | 至少包含：禁止 Read/cat 打开落盘业务 `*.json`（须 node/python 脚本读盘）；禁止把 JSON 贴进回复；禁止编造 ID/金额；禁止 batch 重新 `run`（仅 `resume`） |
-| `returnSchema` | 子会话**只**回传下列内容 |
+| 字段              | 说明                                                                                                                                                   |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `playbookId`      | `P5` / `P6` / `P7` 等                                                                                                                                  |
+| `snapDir`         | `--json-out` 根目录（绝对或相对 cwd）                                                                                                                  |
+| `mediaCustomerId` | 来自当次 `list-accounts`，禁止猜                                                                                                                       |
+| `dateRange`       | `start` / `end`（YYYY-MM-DD）；P7 另附 `m1`/`m2`/`m3`                                                                                                  |
+| `commands[]`      | 可复制 bash 块（来自 playbook 或 report-template）                                                                                                     |
+| `forbidden[]`     | 至少包含：禁止 Read/cat 打开落盘业务 `*.json`（须 node/python 脚本读盘）；禁止把 JSON 贴进回复；禁止编造 ID/金额；禁止 batch 重新 `run`（仅 `resume`） |
+| `returnSchema`    | 子会话**只**回传下列内容                                                                                                                               |
 
 ### returnSchema（子会话结束时的回复格式）
 
@@ -76,11 +76,11 @@ summary: <1-3 句中文，无业务数字除非来自 manifest>
 
 ### Handoff 模板文件（复制进 Task prompt）
 
-| Playbook | 文件 |
-| -------- | ---- |
-| P6 OKKI | `{skillRoot}/snippets/handoff-p6-okki.md` |
-| P5 batch 后 | `{skillRoot}/snippets/handoff-p5-batch.md` |
-| P7 询盘 | `{skillRoot}/snippets/handoff-p7-inquiry.md` |
+| Playbook    | 文件                                         |
+| ----------- | -------------------------------------------- |
+| P6 OKKI     | `{skillRoot}/snippets/handoff-p6-okki.md`    |
+| P5 batch 后 | `{skillRoot}/snippets/handoff-p5-batch.md`   |
+| P7 询盘     | `{skillRoot}/snippets/handoff-p7-inquiry.md` |
 
 > **路径说明**：`snippets/` 与 `SKILL.md`、`references/` 同级（skill 安装根目录）。主 Agent 派发 Task 前先 Read 对应 handoff 文件，替换占位符后写入子会话 prompt。
 
@@ -88,11 +88,11 @@ summary: <1-3 句中文，无业务数字除非来自 manifest>
 
 ## 内置 subagent vs 自定义 Task prompt
 
-| 宿主能力 | 何时优先 |
-| -------- | -------- |
-| **Bash**（Cursor 内置） | 纯 `siluzan-tso` 命令序列、长输出隔离 |
+| 宿主能力                 | 何时优先                               |
+| ------------------------ | -------------------------------------- |
+| **Bash**（Cursor 内置）  | 纯 `siluzan-tso` 命令序列、长输出隔离  |
 | **Explore** + `readonly` | 只读搜 reference / `rules/`，不改 snap |
-| **Task + 自写 prompt** | 需嵌入上表 `forbidden` 且 Bash 不够用 |
+| **Task + 自写 prompt**   | 需嵌入上表 `forbidden` 且 Bash 不够用  |
 
 不要求固定子 Agent 名称；在 prompt 中写清角色即可（例：「TSO 拉数子任务，仅执行下列命令」）。
 
@@ -132,11 +132,11 @@ summary: <1-3 句中文，无业务数字除非来自 manifest>
 
 ## 客户端兼容说明
 
-| 客户端 | 行为 |
-| ------ | ---- |
-| **Cursor** | 主 Agent 通过 Task 或内置 Bash/Explore 委派；不依赖 skill 包内 `agents/` |
-| **无 subagent** | 忽略本节，全部在主会话完成，仍遵守 `--json-out` 与 outline 纪律 |
-| **Claude Code 等** | 若有子 Agent API，同样遵循 handoff + returnSchema |
+| 客户端             | 行为                                                                     |
+| ------------------ | ------------------------------------------------------------------------ |
+| **Cursor**         | 主 Agent 通过 Task 或内置 Bash/Explore 委派；不依赖 skill 包内 `agents/` |
+| **无 subagent**    | 忽略本节，全部在主会话完成，仍遵守 `--json-out` 与 outline 纪律          |
+| **Claude Code 等** | 若有子 Agent API，同样遵循 handoff + returnSchema                        |
 
 ---
 

package/dist/skill/references/core/tips.md

@@ -1,76 +1,37 @@
-# CLI 使用技巧：`--json-out` 落盘 + Node.js 精准查询
+# CLI 脚本食谱：`--json-out` 落盘 + Node.js 精准查询
 
-> **文档重读（与落盘无关，但同样硬）**：**每个新的用户任务**或**同对话内换话题**时，须按 `references/core/agent-conventions.md` § 文档加载纪律 **重新 Read** 当次任务对应的 `references/*.md` / `report-templates/*.md`，再执行 CLI。
-
-> **AI 助手（本 Skill）**：凡需结构化数据，一律 **`--json-out <路径>`** 落盘，再用 **Node/Python 脚本**（`require` / `readFileSync`）读 JSON 做筛选与聚合。**禁止**用宿主 **Read** 工具打开落盘业务 `*.json`（会占满上下文且易截断）。命令成功时 **stdout 仅一行摘要 JSON**（体积小）；**`outlineFile`**（`*.outline.txt`，通常小于 2KB）是唯一允许用 Read 查看的「数据结构」文件——最后一行是 TS 类型字面量。业务数据**只**通过脚本访问，脚本 stdout 打印你需要的行/汇总即可。
->
-> **文件命名规则（重要）**：当一条命令具备明确的"查询 id"（mediaCustomerId / entityId / ruleId / auditId 等）时，目录模式落盘的 `*.json`、`*.outline.txt` 与对应 manifest **都会带上 `-<查询id>` 后缀**：
->
-> - 业务文件：`<section>-<查询id>.json`、`<section>-<查询id>.outline.txt`（如 `overview-9526903813.json`、`balance-Google.json`）
-> - 清单文件：`manifest-<accountId>.json`（google-analysis）/ `report-manifest-<accountId>.json`（report 分析类）/ `cli-manifest-<查询id>.json`（通用业务命令）
->   当 section 已经以同一 slug 结尾（如 `list-accounts-google` + idSuffix `google`）时不会重复追加。**读文件请以 stdout 摘要里的 `writtenFiles[]` / `manifestFile` 为准**，不要把"`<section>.json`"当成不变的硬编码。
->
-
-**Google `google-analysis` 与 Meta/TikTok/Bing `report …` 账户分析拉数（本 Skill 推荐口径）**：统一 **`--json-out <目录>`** 落盘（分析子命令以目录为主；通用业务命令另支持 **`--json-out ./foo.json` 单文件**）；**用脚本读目录内 JSON + 数据处理库算指标，再由代码写出交付文件**（HTML / Excel / PDF / PPT / Markdown 等任选），勿用 `Read` 代替程序读数、勿在聊天里直接贴完整交付稿；脚本里勿写业务数据常量。详见 `references/analytics/account-analytics.md`「Google 分析快照工作流」及清单文件说明。
-
----
-
-## 币种（**Agent 必读**）
-
-涉及余额、消耗、预算、报告、Excel 前：**先 Read `references/accounts/currency.md`**，从 `list-accounts` / `balance` / `stats` / `google-analysis` 的 **`currencyCode`** 确定 CNY 或 USD，再选 **￥** 或 **$**。**禁止**默认 Google=美金、禁止跨币种求和。`list-accounts` **默认无 `--detail` 时 JSON 不含余额/消耗字段**，真实值须加 `--detail` 或另跑 `balance`/`stats`。
+> 通用纪律（加载纪律、数据处理协议「摘要 → outline → 脚本读 JSON」、币种、交付自检）**只在** `references/core/agent-conventions.md` 维护，本文件是配套**脚本示例集**。
+> 核心约定一句话：凡需结构化数据，一律 **`--json-out <路径>`** 落盘，**用 `node -e` / 脚本**读 JSON 筛选聚合；**禁止**用宿主 Read 工具打开落盘业务 `*.json`；唯一允许 Read 的数据结构文件是 `*.outline.txt`。
 
 ---
 
-## 处理顺序（**Agent 必读**）：摘要 → outline（schema）→ **脚本**读 JSON
-
-每条 `--json-out` 命令成功后，**必须**按以下顺序处理，不要跳步、不要把 outline 当数据：
-
-1. **解析 stdout 一行摘要 JSON**（禁止 Read 打开 `writtenFiles[0]` 的 `.json`）：拿到 `outlineFile`、`writtenFiles[0]`、`manifestFile`、`agentHint`。**不要硬编码 `<section>.json` 文件名**。
-   - **反例（常见踩坑）**：摘要里**没有** `total`、`items`、`page` 等业务字段；`JSON.parse(stdout)` 后取 `result.total` 会得到 `undefined`。**禁止**用 stdout 写翻页循环；`total` / `items` 只存在于 `writtenFiles[0]` 落盘文件（如 `list-accounts-google.json`）。
-2. **了解字段结构**（二选一，推荐 A）：
-   - **A**：宿主 **Read** 仅 `outlineFile`（`*.outline.txt`，体积小）；或
-   - **B**：`node -e "const fs=require('fs'); const o=fs.readFileSync(process.argv[1],'utf8').trimEnd().split('\\n').filter(l=>!l.startsWith('//')); console.log(o.pop())" <outlineFile>`
-   - 第 1 行（注释）：`// outline of \`<xxx>.json\` — schema-only, NOT the data.` —— **明确告诉你它是"数据结构描述文件"**，不要把它当业务数据使用。
-   - 第 2 行（注释）：中文用法说明。
-   - 第 3 行（注释）：类型推断口径（数组取前 8 项去重并集；环或重复对象记为 any）。
-   - 其后**可能**还有若干行 `//` 字段提示（例如 `google-analysis` 的 **`campaigns-*.outline.txt`** 会插入金额字段已统一为元的说明）。
-   - **类型字面量**：**最后一个不以 `//` 开头的行**（单行 TS，如 `{ a: number; items: { ... }[] }`）—— 写筛选/聚合脚本时取这一行即可。
-   - 提取写法：`outlineRaw.trimEnd().split('\n').filter(l => !l.startsWith('//')).pop()`（**不要**用 `lines[lines.length - 1]`：当最后一行是空行时会错）。
-3. **必须用 Bash 执行脚本**读 `writtenFiles[0]`（及 manifest 中的路径）做筛选、聚合、计算——脚本内 `require` / `readFileSync`，**禁止**宿主 Read / cat / type 打开该 `.json`。**禁止**：
-   - 用 **Read** 读 `campaigns-*.json`、`list-accounts-*.json` 等落盘业务 JSON；
-   - 把 outline 当 JSON `require`（它是 `.txt`）；
-   - 跳过 outline 猜字段名；
-   - 把 outline 或整段 JSON 贴进对话当结论。
-4. **交付物**用代码写出（HTML / Excel / PDF / PPT / Markdown 等）；向用户展示的数字须来自**脚本 stdout**，不要在对话里手填数。
+## 文件命名规则
 
-**Google 周期 Excel（P4）附加门禁**（详见 `report-templates/google-period-report-excel.md`）：
+当一条命令具备明确的"查询 id"（mediaCustomerId / entityId / ruleId / auditId 等）时，目录模式落盘的 `*.json`、`*.outline.txt` 与对应 manifest **都会带上 `-<查询id>` 后缀**（全小写）：
 
-- 账户：`list-accounts -m Google -k <用户 ID>`，无记录则停止；**禁止**翻页 grep 换户。
-- 写 xlsx 脚本前：Read **每一个** 当次 section 的 `*.outline.txt`；**禁止** `cat|json.tool|head` 探业务 JSON。
-- **禁止**加载宿主第三方 xlsx Skill；字段名禁止猜（如 `keywordText`→应为 `keyword`，`query`→应为 `searchTermText`）。
+- 业务文件：`<section>-<查询id>.json`、`<section>-<查询id>.outline.txt`（如 `overview-9526903813.json`、`balance-google.json`）
+- 清单文件：`manifest-<accountId>.json`（google-analysis）/ `report-manifest-<accountId>.json`（report 分析类）/ `cli-manifest-<查询id>.json`（通用业务命令）
+- section 已以同一 slug 结尾时不重复追加（如 `list-accounts-google`）。**读文件以 stdout 摘要里的 `writtenFiles[]` / `manifestFile` 为准**，不要把 `<section>.json` 当成不变的硬编码。
 
-> 这个顺序对所有三类快照统一生效：通用业务命令（`cli-manifest[-<id>].json`）、`google-analysis`（`manifest-<accountId>.json`）、`report …` 分析（`report-manifest[-<accountId>].json`）。三种 summary 都带 `outlineFile`、`agentHint` 字段。
+此命名对三类快照统一生效：通用业务命令（`cli-manifest[-<id>].json`）、`google-analysis`（`manifest-<accountId>.json`）、`report …` 分析（`report-manifest[-<accountId>].json`）；三种 stdout summary 都带 `outlineFile`、`agentHint` 字段。
 
-### Google `campaigns-*.json` 金额字段
+### outline 文件格式
 
-- 日预算用 **`budgetAmountYuan`**（元，CLI 出口已 ÷100）；系列层目标 CPA 用 `campaignTargetCpaYuan` / `maximizeConversionsTargetCpaYuan`（元，已 ÷1,000,000）。
-- 同行 `spend` / `averageCpc` / `costPerConversion` 也是元，直接展示。
-- 网关原始字段 `budgetAmount`（分）、`*Micros`（微元）**已不再落盘**，无需做任何单位换算。
-- **`campaigns-*.outline.txt`** 在标准 3 行头注释之后会多 **2 行** 中文 `//` 提示；提取类型行请用 **`outlineRaw.trimEnd().split('\n').filter(l => !l.startsWith('//')).pop()`**（与上文步骤 2 一致），勿把提示行当 TS 类型。
-
-详见 `references/analytics/account-analytics.md`「金额单位」「CampaignSectionData」。
+- 前 3 行为 `//` 注释（schema-only 声明、用法、类型推断口径），其后**可能**还有若干行 `//` 字段提示。
+- **类型字面量**是最后一个不以 `//` 开头的行；提取写法：`outlineRaw.trimEnd().split('\n').filter(l => !l.startsWith('//')).pop()`。
+- 例外提示：`google-analysis` 的 `campaigns-*.outline.txt` 在标准头注释后多 2 行中文 `//` 提示（金额字段已统一为元：`budgetAmountYuan`、`campaignTargetCpaYuan` 等，无需换算；详见 `references/analytics/account-analytics.md`「金额单位」）。
 
 ---
 
 ## 已有 JSON 时（不必先重跑 CLI）
 
-用户已保存输出或只问「怎么从一大坨 JSON 里筛字段」时：直接用 **本地文件** 喂给 `node -e` 即可，不必为示例再执行 `list-accounts` 等业务命令（字段路径以实际响应为准；列表类命令多为 `items[]` 外层分页结构）。
+用户已保存输出或只问「怎么从一大坨 JSON 里筛字段」时：直接用**本地文件**喂给 `node -e` 即可，不必为示例再执行 `list-accounts` 等业务命令（字段路径以实际响应为准；列表类命令多为 `items[]` 外层分页结构）。
 
 ---
 
 ## 基础模式：`--json-out` + 读文件 + `node -e`
 
-约定示例目录 **`./snap-cli`**（可换任意空目录）。**文件名**以当次命令生成的 **`cli-manifest[-<查询id>].json` → `artifacts[].file`** 为准；常见读命令经规范化后形如 `list-accounts-google.json`（section 已含媒体，不再二次追加）、`balance-google.json`（idSuffix=媒体）、`account-share-detail-9526903813-9526903813.json`（idSuffix=mediaCustomerId）等（**全小写**）。同目录另有 **`<stem>.outline.txt`**（与 `stdout` 摘要里的 `outlineFile` 一致）：TS 式类型单行，按需 `fs.readFileSync` 读取即可。
+约定示例目录 **`./snap-cli`**（可换任意空目录）。文件名以当次 `cli-manifest[-<查询id>].json` → `artifacts[].file` 为准。
 
 ### 过滤特定字段（Google 账户列表）
 
@@ -152,7 +113,7 @@ list
 
 ### 3b. 多账户投放画像（`accounts-digest`）
 
-多账户汇总消耗/点击/转化时**优先** `accounts-digest`，不要对每个账户循环 `stats`（见 `SKILL.md` Playbook P3、`references/accounts/accounts.md` § accounts-digest）。
+多账户汇总消耗/点击/转化时**优先** `accounts-digest`（见工作流 P3、`references/accounts/accounts.md` § accounts-digest），不要对每个账户循环 `stats`：
 
 ```bash
 siluzan-tso accounts-digest -m Google -a id1,id2,id3 \
@@ -172,8 +133,6 @@ rows.slice(0, 10).forEach((r) =>
 "
 ```
 
-文件名以 stdout 摘要的 `writtenFiles[0]` / `manifestFile` 为准；读字段前先 `fs.readFileSync` 同 stem 的 `*.outline.txt`（见上文「处理顺序」）。
-
 ### 4. 从广告系列列表提取 ID
 
 ```bash
@@ -333,10 +292,8 @@ console.log('可用字段：', first && Object.keys(first));
 
 ---
 
-## AI Agent 使用规范
+## 脚本编写小贴士
 
-- **优先用 `--json-out` 与清单文件**：同一运行目录、同一"查询 id"的多次拉数会合并到 `cli-manifest-<id>.json` 的 `artifacts[]`；不同账户/实体写入各自的 manifest，互不覆盖。读具体数据**只**在脚本里 `require(writtenFiles[0])`，**禁止 Read 工具**打开该 json。
-- **中间结果一律落盘**：跨步骤数据不要靠对话记忆，写到工作目录并在后续 **`node`/`python` 脚本**中读盘。
-- **Windows 上避免直接管道 JSON**：PowerShell 管道可能改变编码；优先 `--json-out` + `node -e` 读文件。
 - **用 `process.stdout.write` 而不是 `console.log` 提取单个值**：前者不带换行符，方便直接赋给 shell 变量。
 - **节点代码复杂时拆分写法**：不要写超过 10 行的 `node -e` 单行，改用 `node -e "$(cat <<'EOF'\n...\nEOF\n)"` 或多行 `.mjs` 脚本文件。
+- 同一运行目录、同一"查询 id"的多次拉数会合并到 `cli-manifest-<id>.json` 的 `artifacts[]`；不同账户/实体写入各自的 manifest，互不覆盖。

package/dist/skill/references/core/workflows.md

@@ -2,43 +2,42 @@
 
 > **范围**：调接口 / 写操作类业务（账户读取、开户、广告 CRUD、智投、拓词、优化、报告推送、财务、权限、预警、线索、巡检）。分析/报告类（拉数 → 撰稿 → 交付）见 `references/core/playbooks.md`（P1–P9）。
 >
-> **每张卡片结构统一**：`触发 / 必读 / 步骤 / 交付与确认`。**命令参数、字段口径以「必读」指向的域 reference 为唯一真相源，本文件只给线性步骤，不重复参数表。** 写/改/删操作执行前必须与用户确认，多数破坏性操作还需 `--commit`（见 `references/core/agent-conventions.md`）。
-
-| 编号 | 业务 | 必读 |
-| ---- | ---- | ---- |
-| W1 | 账户查询（列表/余额/消耗/账单） | `accounts/accounts.md` |
-| W2 | 开户申请（六大媒体） | `accounts/open-account-by-media.md` |
-| W3 | Google 广告创建与精细管理 | `google-ads/google-ads-campaign-plan.md` + `google-ads/google-ads.md` |
-| W4 | AI 智投草稿 → 发布 | `google-ads/google-ads.md`（ad batch） |
-| W5 | 拓词 / RAG | `analytics/keyword-planner-workflows.md` + `analytics/rag.md` |
-| W6 | AI 广告优化记录查看与执行 | `operations/optimize.md` |
-| W7 | TSO 优化报告生成 → 推送 | `analytics/reporting.md` |
-| W8 | 财务：充值 / 转账 / 开票 | `accounts/finance.md` |
-| W9 | 账户权限管理 | `accounts/accounts.md`（account 子命令） |
-| W10 | 智能预警规则管理 | `operations/forewarning.md` |
-| W11 | 广告线索提取 | `operations/clue.md` |
-| W12 | 日 / 周巡检 | `accounts/accounts.md` + 各域 |
+> **通用纪律统一见 `references/core/agent-conventions.md`**（写操作确认 + `--commit`、ID 口径、数据处理协议），各卡片不再重复。**命令参数、字段口径以「必读」指向的域 reference 为唯一真相源，本文件只给线性步骤，不重复参数表。** 每张卡片结构统一：`触发 / 必读 / 步骤 / 交付与确认`。
+
+| 编号 | 业务                            | 必读                                                                  |
+| ---- | ------------------------------- | --------------------------------------------------------------------- |
+| W1   | 账户查询（列表/余额/消耗/账单） | `accounts/accounts.md`                                                |
+| W2   | 开户申请（六大媒体）            | `accounts/open-account-by-media.md`                                   |
+| W3   | Google 广告创建与精细管理       | `google-ads/google-ads-campaign-plan.md` + `google-ads/google-ads.md` |
+| W4   | AI 智投草稿 → 发布              | `google-ads/google-ads.md`（ad batch）                                |
+| W5   | 拓词 / RAG                      | `analytics/keyword-planner-workflows.md` + `analytics/rag.md`         |
+| W6   | AI 广告优化记录查看与执行       | `operations/optimize.md`                                              |
+| W7   | TSO 优化报告生成 → 推送         | `analytics/reporting.md`                                              |
+| W8   | 财务：充值 / 转账 / 开票        | `accounts/finance.md`                                                 |
+| W9   | 账户权限管理                    | `accounts/accounts.md`（account 子命令）                              |
+| W10  | 智能预警规则管理                | `operations/forewarning.md`                                           |
+| W11  | 广告线索提取                    | `operations/clue.md`                                                  |
+| W12  | 日 / 周巡检                     | `accounts/accounts.md` + 各域                                         |
 
 ---
 
 ## W1 · 账户查询（列表 / 余额 / 消耗 / 账单）
 
 - **触发**：账户列表/有多少、单户余额、单户消耗、激活充值账单。
-- **必读**：`accounts/accounts.md`；涉及金额加 `accounts/currency.md`。
+- **必读**：`accounts/accounts.md`。
 - **步骤**：
   1. 列表/数量：`list-accounts -m <媒体> --page-size 999 --json-out ./snap`，脚本读 `list-accounts-*.json` 的 `total` / `items[]`（**禁止**默认 20 条再翻页）。
-  2. 单户余额：`balance -m <媒体> -a <mediaCustomerId>`（传数字 ID，非 `entityId`）。
+  2. 单户余额：`balance -m <媒体> -a <mediaCustomerId>`。
   3. 单户消耗：`stats -m <媒体> -a <mediaCustomerId> --start <S> --end <D>`（多账户对比走 **P3**）。
   4. 激活账单：先取 `entityId` → `account-active-bills -m <媒体> --id <entityId> --json-out ./snap`。
-- **交付/确认**：`entityId` ≠ `mediaCustomerId`，两者均来自 `list-accounts`；币种只认 `currencyCode`。多账户余额预警走 **P2**、消耗汇总走 **P3**。
+- **交付/确认**：多账户余额预警走 **P2**、消耗汇总走 **P3**。
 
 ---
 
 ## W2 · 开户申请（Google / TikTok / Yandex / BingV2 / Kwai / MetaAd）
 
 - **触发**：申请开户、新开广告账户、查开户进度。
-- **必读**：`accounts/open-account-by-media.md`（各媒体必填项与参数）；Google 字段加 `accounts/open-account-google-ui.md`。
-- **首次响应硬规范**：用户**第一次**进入开户话题时，**必须先**罗列目标媒体（未指明则六平台）**全部必填项**，再收集资料；**禁止**未列清单就执行 `open-account`。所有媒体均**无需**手动查 magKey，CLI 按公司名自动创建/关联广告主组。
+- **必读**：`accounts/open-account-by-media.md`（各媒体必填项与参数，**含 §「首次响应硬规范」：首次进入开户话题必须先列全必填清单**）；Google 字段加 `accounts/open-account-google-ui.md`。所有媒体均**无需**手动查 magKey，CLI 按公司名自动创建/关联广告主组。
 - **步骤**：
   1. 列出必填项 → 收集资料（TikTok/Bing/Kwai 需营业执照图片本地路径；CLI 无 OCR）。
   2. 前置查询（按需）：TikTok `open-account tiktok-areas/-industries/-timezones`；Bing `open-account bing-industries`；Google `open-account google-timezones`。
@@ -46,10 +45,10 @@
   4. 轮询审核：`account-history -m <媒体>`。
 - **交付/确认**：审核状态处理——
 
-  | 状态 | 下一步 |
-  | ---- | ------ |
-  | `Pending` | 等待，可反复轮询 |
-  | `Approved` | `list-accounts` 确认账户出现 → 按 **W8** 引导充值激活 |
+  | 状态       | 下一步                                                 |
+  | ---------- | ------------------------------------------------------ |
+  | `Pending`  | 等待，可反复轮询                                       |
+  | `Approved` | `list-accounts` 确认账户出现 → 按 **W8** 引导充值激活  |
   | `Rejected` | 看落盘 `reason` 字段，改资料重提；原因不明引导联系客服 |
 
 ---
@@ -57,12 +56,20 @@
 ## W3 · Google 广告创建与精细管理
 
 - **触发**：新建搜索系列、出投放方案、系列/组/广告/关键词 CRUD、PMax、拒审处理、日常调价/启停。
-- **必读**：方案与门禁 `google-ads/google-ads-campaign-plan.md` + `assets/campaign-create-template.md`；命令参数 `google-ads/google-ads.md`；PMax 加 `assets/pmax-create-template.md` + `google-ads/pmax-api.md`。
+- **必读**：方案与门禁 `google-ads/google-ads-campaign-plan.md` + **`assets/campaign-create-template.json`**（先 Read）+ `assets/campaign-create-template.md`；命令参数 `google-ads/google-ads.md`；PMax 加 **`assets/pmax-create-template.json`** + `assets/pmax-create-template.md` + `google-ads/pmax-api.md`。
 - **创建路径选择**：
   - 已有 AI 智投草稿 → 走 **W4**。
-  - 需先出投放方案（口述/官网/拓词）→ `google-ads-campaign-plan.md`：JSON → `campaign-validate`（门禁，失败只改 JSON）→ 用户确认 → `campaign-create`。
-  - 已有完整结构化 JSON → 直接 `campaign-validate` → `campaign-create`。
-- **步骤（一体化创建）**：
+  - **PMax 出方案/创建** → **`assets/pmax-create-template.json`**（先 Read）+ `pmax-create-template.md` + `pmax-api.md`：`pmax-validate` → 用户确认 → `pmax-create`（**勿**用 Search `campaign-create`）。
+  - 搜索系列出方案 → `google-ads-campaign-plan.md`：JSON → `campaign-validate` → 用户确认 → `campaign-create`。
+  - 已有完整结构化 JSON → 对应 validate → create。
+- **步骤（PMax 方案 → 创建）**：
+  1. 账户：`list-accounts -m Google -k <id>`；落地页与品牌从官网/RAG 归纳。
+  2. 地域/语言：`ad geo search` 取 location id；语言 id 写入 JSON。
+  3. 复制 `pmax-create-template.json` 填文案/预算/图片；**必须**含 `campaignExtensions`（至少 callouts + structuredSnippets）；**Lead Gen/B2B 默认** `campaignExtensions.leadForm`（方案 Markdown 须单列表单节）。
+  4. 门禁：`ad pmax-validate --config-file ./pmax.json --json-out ./snap-pmax`。
+  5. 输出 JSON + Markdown 方案 → 用户确认 → `ad pmax-create --commit "…"`。
+  6. 复核：`ad campaigns` / `ad pmax-get`；缺表单时 `ad extension lead-form` 补挂。
+- **步骤（Search 一体化创建）**：
   1. 地域 ID：`ad geo search -a <id> -q "United States"` 写入 `campaign.targetedLocations[].id`。
   2. 门禁：`ad campaign-validate --config-file ./campaign.json`（必跑）。
   3. 用户确认后创建：`ad campaign-create --config-file ./campaign.json`，记录返回 taskId。