siluzan-tso-cli 1.1.35-beta.2 → 1.1.35-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/README.md +1 -1
  2. package/dist/index.js +1679 -1633
  3. package/dist/skill/AGENTS.md +11 -10
  4. package/dist/skill/SKILL.md +1 -1
  5. package/dist/skill/_meta.json +2 -2
  6. package/dist/skill/assets/campaign-create-template.md +15 -15
  7. package/dist/skill/assets/market-analysis-rules.md +14 -14
  8. package/dist/skill/assets/pmax-create-template.md +6 -6
  9. package/dist/skill/assets/pmax-lead-form-template.md +3 -3
  10. package/dist/skill/references/README.md +21 -21
  11. package/dist/skill/references/accounts/accounts.md +42 -42
  12. package/dist/skill/references/analytics/account-analytics.md +46 -39
  13. package/dist/skill/references/analytics/keyword-planner-workflows.md +14 -13
  14. package/dist/skill/references/analytics/rag.md +7 -7
  15. package/dist/skill/references/analytics/reporting.md +1 -1
  16. package/dist/skill/references/core/agent-conventions.md +20 -20
  17. package/dist/skill/references/core/intent-routing.md +116 -117
  18. package/dist/skill/references/core/subagent-orchestration.md +1 -1
  19. package/dist/skill/references/core/workflows.md +12 -12
  20. package/dist/skill/references/google-ads/google-ads-campaign-plan.md +29 -31
  21. package/dist/skill/references/google-ads/google-ads.md +7 -7
  22. package/dist/skill/references/google-ads/rules/google-ads-keyword-taxonomy.md +14 -14
  23. package/dist/skill/references/operations/hosted-automation-optimize-index.md +2 -2
  24. package/dist/skill/references/operations/hosted-automation-scenarios.md +2 -2
  25. package/dist/skill/references/operations/hosted-automation-self-control.md +6 -6
  26. package/dist/skill/references/operations/hosted-automation-user-catalog.md +17 -17
  27. package/dist/skill/references/report-templates/README.md +68 -0
  28. package/dist/skill/references/report-templates/REPORT-WORKFLOW.md +2 -2
  29. package/dist/skill/references/report-templates/bing-period-report.md +53 -53
  30. package/dist/skill/references/report-templates/google-ads-diagnosis.md +28 -2
  31. package/dist/skill/references/report-templates/google-inquiry-analysis.md +8 -8
  32. package/dist/skill/references/report-templates/google-period-report-excel.md +2 -2
  33. package/dist/skill/references/report-templates/okki-weekly-google-client.md +55 -55
  34. package/dist/skill/references/report-templates/tiktok-period-report.md +22 -21
  35. package/dist/skill/report-templates/GoogleAdsDiagnosisReport.html +390 -892
  36. package/dist/skill/report-templates/REPORT-WORKFLOW.md +2 -2
  37. package/dist/skill/report-templates/bing-period-report.md +53 -53
  38. package/dist/skill/report-templates/google-ads-diagnosis.md +28 -2
  39. package/dist/skill/report-templates/google-inquiry-analysis.md +8 -8
  40. package/dist/skill/report-templates/google-period-report-excel.md +2 -2
  41. package/dist/skill/report-templates/meta-period-report.html +1 -4
  42. package/dist/skill/report-templates/okki-weekly-google-client.md +55 -55
  43. package/dist/skill/report-templates/report-template-academic.html +0 -2
  44. package/dist/skill/report-templates/report-template.html +0 -2
  45. package/dist/skill/report-templates/tiktok-period-report.md +22 -21
  46. package/dist/skill/report-templates/website-diagnosis-report.html +1 -5
  47. package/dist/skill/scripts/install.ps1 +1 -1
  48. package/dist/skill/scripts/install.sh +1 -1
  49. package/eval/cases/accounts-entityid-vs-mediaccustomerid.scenario.json +2 -14
  50. package/eval/cases/accounts-mcc-bind-inquiry.scenario.json +1 -3
  51. package/eval/cases/accounts-single-balance-not-bulk.scenario.json +3 -14
  52. package/eval/cases/budget-display-not-raw-micros.scenario.json +1 -8
  53. package/eval/cases/clue-meta-leads-json.scenario.json +2 -14
  54. package/eval/cases/clue-tiktok-leads-json.scenario.json +2 -11
  55. package/eval/cases/destructive-account-delink-needs-confirm.scenario.json +3 -9
  56. package/eval/cases/destructive-forewarning-delete-needs-confirm.scenario.json +3 -9
  57. package/eval/cases/destructive-invoice-apply-needs-confirm.scenario.json +3 -9
  58. package/eval/cases/facebook-analysis-google-section-aliases.scenario.json +2 -11
  59. package/eval/cases/facebook-analysis-not-google-keywords.scenario.json +3 -10
  60. package/eval/cases/facebook-analysis-period-default.scenario.json +2 -14
  61. package/eval/cases/finance-invoice-info-list.scenario.json +3 -11
  62. package/eval/cases/forewarning-list-google.scenario.json +3 -14
  63. package/eval/cases/google-ads-no-structural-without-confirm.scenario.json +2 -6
  64. package/eval/cases/google-analysis-keywords-route.scenario.json +2 -14
  65. package/eval/cases/human-p1-multiturn.scenario.json +1 -5
  66. package/eval/cases/ir-p1-vs-p8-account-vs-url.scenario.json +5 -17
  67. package/eval/cases/ir-p4-period-not-diagnosis.scenario.json +3 -16
  68. package/eval/cases/ir-p8-network-diagnosis-with-url.scenario.json +3 -25
  69. package/eval/cases/ir-p8-website-monitor-report-with-url.scenario.json +3 -28
  70. package/eval/cases/ir-p8-website-test-report-no-url.scenario.json +3 -14
  71. package/eval/cases/ir-p9-industry-not-p8.scenario.json +3 -19
  72. package/eval/cases/ir-vague-report-clarify.scenario.json +3 -14
  73. package/eval/cases/ir-w3-vs-p8-from-website.scenario.json +2 -8
  74. package/eval/cases/ir-w5-keyword-planner-url-core-terms.scenario.json +2 -22
  75. package/eval/cases/meta-single-balance-not-bulk.scenario.json +3 -17
  76. package/eval/cases/no-legacy-json-flag.scenario.json +2 -6
  77. package/eval/cases/open-account-google-noninteractive.scenario.json +1 -3
  78. package/eval/cases/open-account-tiktok-license-file.scenario.json +1 -3
  79. package/eval/cases/optimize-list-by-account.scenario.json +3 -11
  80. package/eval/cases/p1-single-account-profile.scenario.json +1 -11
  81. package/eval/cases/p2-balance-scan-bulk.scenario.json +2 -9
  82. package/eval/cases/p3-accounts-digest.scenario.json +1 -5
  83. package/eval/cases/p4-fb-meta-period-report.scenario.json +2 -12
  84. package/eval/cases/p4-period-report-window.scenario.json +1 -8
  85. package/eval/cases/pmax-asset-group-create-with-bg.scenario.json +2 -13
  86. package/eval/cases/pmax-brand-edit-routing.scenario.json +3 -16
  87. package/eval/cases/pmax-edit-not-campaign-edit.scenario.json +2 -12
  88. package/eval/cases/pmax-enable-brand-guidelines.scenario.json +2 -12
  89. package/eval/cases/pmax-no-assets-update-brand-fields.scenario.json +3 -14
  90. package/eval/cases/rag-before-keyword-expand.scenario.json +1 -11
  91. package/eval/cases/rag-list-then-query.scenario.json +2 -14
  92. package/eval/cases/report-list-google.scenario.json +2 -11
  93. package/eval/cases/report-push-list-google.scenario.json +2 -11
  94. package/eval/cases/setup-login-or-env.scenario.json +1 -3
  95. package/eval/cases/setup-siluzan-data-permission-env.scenario.json +1 -3
  96. package/eval/cases/tiktok-bc-bind-inquiry.scenario.json +2 -6
  97. package/eval/cases/time-range-user-delegates-default.scenario.json +1 -8
  98. package/eval/cases/tips-json-out-filtering.scenario.json +1 -3
  99. package/eval/cases/tips-large-json-pagination.scenario.json +1 -3
  100. package/eval/cases/uj-ad-campaign-validate-before-create-stub.scenario.json +2 -11
  101. package/eval/cases/uj-ad-outdoor-campgear-search-plan.scenario.json +1 -3
  102. package/eval/cases/uj-ad-website-search-plan-table-format.scenario.json +1 -3
  103. package/eval/cases/uj-analytics-30d-pdf-campaign-device-geo.scenario.json +6 -18
  104. package/eval/cases/uj-analytics-compare-google-tiktok-last-month-roi.scenario.json +1 -8
  105. package/eval/cases/uj-analytics-ecommerce-industry-report.scenario.json +2 -14
  106. package/eval/cases/uj-analytics-google-weekly-trends-campaigns-keywords.scenario.json +2 -11
  107. package/eval/cases/uj-analytics-report-push-weekly-email.scenario.json +1 -3
  108. package/eval/cases/uj-finance-invoice-records-this-month.scenario.json +2 -11
  109. package/eval/cases/uj-life-newbie-siluzan-google-end-to-end.scenario.json +1 -4
  110. package/eval/cases/uj-ops-google-accounts-list-normal.scenario.json +2 -17
  111. package/eval/cases/uj-ops-google-yesterday-spend-conversions.scenario.json +2 -14
  112. package/eval/cases/uj-ops-pause-worst-adgroup-confirm.scenario.json +2 -6
  113. package/eval/cases/uj-ops-tiktok-leads-last-week.scenario.json +3 -17
  114. package/eval/cases/uj-patrol-cpc-spike-adgroups-over-15.scenario.json +1 -5
  115. package/eval/cases/uj-patrol-forewarning-create-daily-cap-3000.scenario.json +1 -3
  116. package/eval/cases/uj-patrol-forewarning-trigger-records.scenario.json +3 -17
  117. package/eval/cases/uj-patrol-google-balances-low.scenario.json +2 -11
  118. package/eval/cases/uj-roi-optimize-records-then-execute-cautiously.scenario.json +3 -14
  119. package/eval/cases/uj-roi-search-terms-add-negative-keywords.scenario.json +2 -14
  120. package/package.json +1 -1
@@ -49,20 +49,20 @@
49
49
 
50
50
  洗词、分组、否词表、匹配策略等多依赖对 **`--json-out` 落盘 JSON** 的解析或 Agent 归纳;逐步命令见「场景编排」。
51
51
 
52
- | # | 场景 | 编排 |
53
- | --- | ------------------------------------------------------------------------------- | ------------------------------- |
54
- | — | **仅 Google Planner 数据**(不联网搜索、不用 `--url`) | 上文「分支 B」 |
55
- | 0 | **先 RAG 再拓词**:客户产品/行业背景 → 种子词与 `--url` | §0 |
56
- | 1 | 竞品网址 + 种子拓词:至少一个 `-k` + `--url`,落盘后去重/排序/截 Top N | §1 |
57
- | 2 | 多种子长尾:`-k "种子1,种子2,..."` | §2 |
58
- | 3 | 按规则洗词:月搜索量阈值、排除词根、排除类意图等 | §2(JSON) |
59
- | 4 | 账户关键词表现 + 市场侧指标:`google-analysis` keywords → 抽词 → 分批 `keyword` | §3 |
60
- | 5 | 搜索词 + 拓词:浪费流量 / 否词线索 | §4 |
61
- | 6 | 高商业意图粗筛:CPC、竞争度、搜索量 | §5 |
52
+ | # | 场景 | 编排 |
53
+ | --- | ------------------------------------------------------------------------------- | ------------------------------------------ |
54
+ | — | **仅 Google Planner 数据**(不联网搜索、不用 `--url`) | 上文「分支 B」 |
55
+ | 0 | **先 RAG 再拓词**:客户产品/行业背景 → 种子词与 `--url` | §0 |
56
+ | 1 | 竞品网址 + 种子拓词:至少一个 `-k` + `--url`,落盘后去重/排序/截 Top N | §1 |
57
+ | 2 | 多种子长尾:`-k "种子1,种子2,..."` | §2 |
58
+ | 3 | 按规则洗词:月搜索量阈值、排除词根、排除类意图等 | §2(JSON) |
59
+ | 4 | 账户关键词表现 + 市场侧指标:`google-analysis` keywords → 抽词 → 分批 `keyword` | §3 |
60
+ | 5 | 搜索词 + 拓词:浪费流量 / 否词线索 | §4 |
61
+ | 6 | 高商业意图粗筛:CPC、竞争度、搜索量 | §5 |
62
62
  | 7 | 否词或否词根落地:`ad keyword-negative-create` 等 | §4 + `references/google-ads/google-ads.md` |
63
- | 8 | Campaign → AdGroup → JSON:`ad campaign-validate` → `ad campaign-create` | §6 |
64
- | 9 | 拓词结果导出:`keyword … --json-out`,供脚本消费 | §7 |
65
- | 10 | **URL/文章 + 多核心词 + 搜索量/竞争度筛选**(B2B 典型) | §8 |
63
+ | 8 | Campaign → AdGroup → JSON:`ad campaign-validate` → `ad campaign-create` | §6 |
64
+ | 9 | 拓词结果导出:`keyword … --json-out`,供脚本消费 | §7 |
65
+ | 10 | **URL/文章 + 多核心词 + 搜索量/竞争度筛选**(B2B 典型) | §8 |
66
66
 
67
67
  ---
68
68
 
@@ -79,6 +79,7 @@
79
79
  ```bash
80
80
  siluzan-tso keyword -k "fish gelatin,porcine gelatin,..." --url "https://example.com/" --geo 2840 --google-only --json-out ./snap-kw-batch1
81
81
  ```
82
+
82
83
  - 目标市场未指定时默认 `--geo 2840`(美国)并在交付说明中写明;要其它市场先 `keyword geo-list`。
83
84
  3. 脚本读各批 `items[]`:
84
85
  - 按 `montlySearch` 过滤(如 1500–6000 视为「约 3000」区间);
@@ -40,14 +40,14 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
40
40
 
41
41
  ## TSO 业务场景路由
42
42
 
43
- | 用户意图 | 建议检索词(示例) | 后续 TSO 命令 |
44
- | ------------------------------ | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
43
+ | 用户意图 | 建议检索词(示例) | 后续 TSO 命令 |
44
+ | ------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
45
45
  | Google 搜索广告方案 / 批量草稿 | 产品卖点、应用行业、目标国家、竞品差异 | `references/google-ads/google-ads-campaign-plan.md` + `keyword` / `campaign-create`;草稿发布见 `references/google-ads/google-ads.md` § ad batch |
46
- | 关键字拓词补语境 | 产品型号、英文类目、行业术语、应用场景 | `keyword suggest -k "..."`;编排见 `references/analytics/keyword-planner-workflows.md` |
47
- | 账户诊断 / 周期报告「背景」段 | 公司简介、主营产品、目标市场、认证资质 | `google-analysis` + `report-templates/` 对应模板 |
48
- | 询盘分析报告 | 产品线、出口市场、客户画像、大洲业务侧重 | `report-templates/google-inquiry-analysis.md` |
49
- | 开户行业/资质核对 | 营业执照经营范围、行业描述、品牌全称 | `references/accounts/open-account-by-media.md` 对应媒体开户流 |
50
- | 优化建议解释 | 产品毛利结构、旺季、转化路径(表单/电话) | `optimize` 记录 + 人工解读;数据仍来自 `google-analysis` |
46
+ | 关键字拓词补语境 | 产品型号、英文类目、行业术语、应用场景 | `keyword suggest -k "..."`;编排见 `references/analytics/keyword-planner-workflows.md` |
47
+ | 账户诊断 / 周期报告「背景」段 | 公司简介、主营产品、目标市场、认证资质 | `google-analysis` + `report-templates/` 对应模板 |
48
+ | 询盘分析报告 | 产品线、出口市场、客户画像、大洲业务侧重 | `report-templates/google-inquiry-analysis.md` |
49
+ | 开户行业/资质核对 | 营业执照经营范围、行业描述、品牌全称 | `references/accounts/open-account-by-media.md` 对应媒体开户流 |
50
+ | 优化建议解释 | 产品毛利结构、旺季、转化路径(表单/电话) | `optimize` 记录 + 人工解读;数据仍来自 `google-analysis` |
51
51
 
52
52
  检索结果**只作事实参考**:广告标题/描述须符合 `references/google-ads/rules/google-ads-compliance.md`;数值指标仍以 CLI 拉数为准。
53
53
 
@@ -3,7 +3,7 @@
3
3
  > 所属 skill:`siluzan-tso`。
4
4
  >
5
5
  > 本文档仅覆盖 **TSO steward 优化报告**:列表、生成、删除、邮件推送与查看链接。
6
- > **账户分析拉数**(`google-analysis`、`facebook-analysis`、`report tiktok-*`、`report bing-*`、`report meta-overview`)与**周期/诊断报告纲要**见 `references/analytics/account-analytics.md`(Facebook 撰写见 `facebook-analysis-guide.md`)。
6
+ > **账户分析拉数**(`google-analysis`、`facebook-analysis`、`tiktok-analysis`、`bing-analysis`、`report meta-overview`)与**周期/诊断报告纲要**见 `references/analytics/account-analytics.md`(Facebook 撰写见 `facebook-analysis-guide.md`)。
7
7
  > **异步批量创建记录**(`ad batch`)见 `references/google-ads/google-ads.md` § ad batch。
8
8
  > **AI 广告优化**(`optimize`)见 `references/operations/optimize.md`。
9
9
  > **广告线索**(`clue`)见 `references/operations/clue.md`。
@@ -14,23 +14,23 @@
14
14
  | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
15
15
  | **新的用户任务 / 同对话内换话题**(新需求、新账户、新媒体、新报告类型;例:刚查余额 → 改问建系列) | 按 `SKILL.md` 路由表 **重新 Read** 该任务的「必读文档」与工作流卡片后再执行 CLI;**禁止**沿用上一任务的参数记忆——对话会被压缩,「读过」≠ 当前上下文仍含正确字段名与 flags |
16
16
  | **工作流编号不同**(P1→P3、P4→P5) | 即使刚做过 P1,仍须 Read 新卡片及其必读文档 |
17
- | **报告 / 分析类话术模糊**(只说「报告/诊断/分析/检测/监测」、对象不清) | **必须先 Read** `references/core/intent-routing.md`,定唯一 P*/W* 后再 Read 工作流卡片;**禁止**默认 P4 或 P1 |
17
+ | **报告 / 分析类话术模糊**(只说「报告/诊断/分析/检测/监测」、对象不清) | **必须先 Read** `references/core/intent-routing.md`,定唯一 P*/W* 后再 Read 工作流卡片;**禁止**默认 P4 或 P1 |
18
18
  | **专用 report-templates**(OKKI / 询盘分析 / 周期报告纲要) | Read `references/report-templates/<名>.md` **全文**(与 `report-templates/<名>.md` 同源);勿只凭 SKILL 摘要 |
19
19
  | **上下文被压缩 / 记不清字段或命令** | 重读 `SKILL.md` 路由表 + 当次任务 references |
20
20
  | **CLI 返回 400 / 字段对不上** | 回到对应 reference 核对参数名与口径,勿猜 |
21
- | **JSON 契约模板**(建搜索系列、PMax 等) | **必须先 Read** `assets/*-template.json`(结构真相源),再 Read 同目录 `.md`(字段说明与踩坑);**禁止**只读 `.md` 凭印象拼 JSON |
21
+ | **JSON 契约模板**(建搜索系列、PMax 等) | **必须先 Read** `assets/*-template.json`(结构真相源),再 Read 同目录 `.md`(字段说明与踩坑);**禁止**只读 `.md` 凭印象拼 JSON |
22
22
 
23
23
  所有 ID、金额、命令 flags 以**当次 Read 的文档 + 当次 CLI 输出**为准;数值只来自本次 stdout 或脚本读盘结果,不引用对话记忆里的示例值。
24
24
 
25
25
  ### Skill 内 Read 路径约定
26
26
 
27
- | 类型 | 正确路径(相对 Skill 根目录) | 说明 |
28
- | ---- | ----------------------------- | ---- |
29
- | 命令 reference | `references/<域>/<文件>.md` | 如 `references/analytics/account-analytics.md` |
30
- | 报告纲要 | `references/report-templates/<文件>.md` | 如 `references/report-templates/google-period-report.md` |
31
- | JSON 契约模板(结构) | `assets/*-template.json`、`assets/*.schema.json` 等 | **先 Read**;如 `assets/campaign-create-template.json` |
32
- | 契约说明 / 规则 | `assets/<文件>.md` | 与上表 JSON **成对** Read;如 `assets/campaign-create-template.md` |
33
- | HTML 终稿模板 | `report-templates/*.html` | 由 CLI `render` 使用,Agent 通常只 Read 对应 `.md` 纲要 |
27
+ | 类型 | 正确路径(相对 Skill 根目录) | 说明 |
28
+ | --------------------- | --------------------------------------------------- | ------------------------------------------------------------------ |
29
+ | 命令 reference | `references/<域>/<文件>.md` | 如 `references/analytics/account-analytics.md` |
30
+ | 报告纲要 | `references/report-templates/<文件>.md` | 如 `references/report-templates/google-period-report.md` |
31
+ | JSON 契约模板(结构) | `assets/*-template.json`、`assets/*.schema.json` 等 | **先 Read**;如 `assets/campaign-create-template.json` |
32
+ | 契约说明 / 规则 | `assets/<文件>.md` | 与上表 JSON **成对** Read;如 `assets/campaign-create-template.md` |
33
+ | HTML 终稿模板 | `report-templates/*.html` | 由 CLI `render` 使用,Agent 通常只 Read 对应 `.md` 纲要 |
34
34
 
35
35
  所有文档里的「必读文档」路径**一律相对 Skill 根目录、且已写全前缀**:域文档为 `references/<域>/<文件>.md`,报告纲要为 `references/report-templates/<文件>.md`,JSON 契约为 `assets/<文件>.json`,HTML 终稿模板为 `report-templates/*.html`。**按字面路径直接 Read 即可,无需自行增删前缀**;若仍 File not found,回到 `references/README.md` 核对真实路径。
36
36
 
@@ -49,11 +49,11 @@
49
49
 
50
50
  ### 执行模式速查
51
51
 
52
- | 模式 | 说明 |
53
- | ----------------- | ------------------------------------------------------------------------------------------------ |
54
- | **数据交付类** | `google-analysis` / `stats` / `ad campaigns` 等带 `--json-out`:必须按 §三 协议脚本读盘转换 |
55
- | **客户/产品背景** | 拓词、方案、报告背景段:先 `rag list` + `rag query`,再衔接 `keyword` / `ad` / `google-analysis` |
56
- | **仅调接口** | 优化记录、线索表单、预警、财务命令:无需输出转换 |
52
+ | 模式 | 说明 |
53
+ | ----------------- | ----------------------------------------------------------------------------------------------------- |
54
+ | **数据交付类** | `google-analysis` / `stats` / `ad campaigns` 等带 `--json-out`:必须按 §三 协议脚本读盘转换 |
55
+ | **客户/产品背景** | 拓词、方案、报告背景段:先 `rag list` + `rag query`,再衔接 `keyword` / `ad` / `google-analysis` |
56
+ | **仅调接口** | 优化记录、线索表单、预警、财务命令:无需输出转换 |
57
57
  | **P9 市场报告** | `market-analysis collect` → Agent 调研写 JSON → `market-analysis render`;**禁止**跳过 collect/render |
58
58
 
59
59
  ### Subagent(可选)
@@ -74,12 +74,12 @@
74
74
  3. **编写并执行脚本**(`node -e` / `.mjs` / `python`)`readFileSync` 读 `writtenFiles[0]` 做筛选、聚合、计算,字段路径**逐一对照第 2 步确认的 outline**;**永远不得**用宿主 Read / `cat` / `type` / `Get-Content` 打开落盘业务 `*.json`(常为 MB 级,会撑爆上下文)。
75
75
  4. **交付物用代码写出**(HTML / Excel / PDF / Markdown 等);向用户展示的数字须来自**脚本 stdout**,不在对话里手填、改数、心算汇总。**交付前**若某章/表为空或全 0,先怀疑"字段路径猜错(漏读该维度 outline)",回第 2 步核对,**不要**直接当作"接口无数据"交付。
76
76
 
77
- | 允许 Read 的文件 | 必须用代码读取的文件 |
78
- | -------------------------------------------------------------------------------- | ------------------------------------------ |
79
- | `references/**/*.md`、`assets/**/*.md`(Skill 文档) | 所有 `--json-out` 落盘业务 `*.json`(常为 MB 级) |
80
- | `assets/*-template.json`、`assets/*.schema.json`、`references/analytics/geo-continents.json` 等**小体积契约/映射** | manifest 中的路径索引(脚本 `JSON.parse`) |
81
- | 当次 `*.outline.txt` | 用户提供的同构大 JSON |
82
- | stdout 一行摘要、你刚写出的最终产物文件 | — |
77
+ | 允许 Read 的文件 | 必须用代码读取的文件 |
78
+ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
79
+ | `references/**/*.md`、`assets/**/*.md`(Skill 文档) | 所有 `--json-out` 落盘业务 `*.json`(常为 MB 级) |
80
+ | `assets/*-template.json`、`assets/*.schema.json`、`references/analytics/geo-continents.json` 等**小体积契约/映射** | manifest 中的路径索引(脚本 `JSON.parse`) |
81
+ | 当次 `*.outline.txt` | 用户提供的同构大 JSON |
82
+ | stdout 一行摘要、你刚写出的最终产物文件 | — |
83
83
 
84
84
  **字面量纪律**:字段路径以 `outlineFile` + 当次 manifest 为准,禁止跳过 \*.outline.txt 猜字段名。常见踩坑(均因没逐维读 outline):
85
85
 
@@ -1,6 +1,6 @@
1
1
  # 报告 / 分析类意图路由(统一消歧)
2
2
 
3
- > **何时必读**:用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 评估 / 体检 / 月报 / 周报」等**任一**词,且尚未明确对应 `SKILL.md` 路由表某一行时,**必须先 Read 本文件**,再 Read 对应工作流卡片(`playbooks.md` P*)与必读 reference。
3
+ > **何时必读**:用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 评估 / 体检 / 月报 / 周报」等**任一**词,且尚未明确对应 `SKILL.md` 路由表某一行时,**必须先 Read 本文件**,再 Read 对应工作流卡片(`playbooks.md` P\*)与必读 reference。
4
4
  >
5
5
  > 本文件是 **P1–P9 及易混 W3/W7** 的**唯一消歧真相源**;`SKILL.md` 路由表、`agent-preamble.md` 只保留摘要,**细节以本文件为准**。
6
6
 
@@ -18,13 +18,13 @@
18
18
 
19
19
  ### 0.2 诊断类信号(近义词 / 同义词,命中任一即可)
20
20
 
21
- | 类别 | 常见说法(含错字 / 口语) |
22
- | ---- | ------------------------- |
23
- | 核心 | **诊断**、**检测**、**监测**、**监控**、**评估**、**评测**、**体检**、**审查**、**核查** |
24
- | 报告向 | **报告**、**分析报告**、**诊断报告**、**检测报告**、**监测报告**、**评估报告**、**质量报告** |
21
+ | 类别 | 常见说法(含错字 / 口语) |
22
+ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
23
+ | 核心 | **诊断**、**检测**、**监测**、**监控**、**评估**、**评测**、**体检**、**审查**、**核查** |
24
+ | 报告向 | **报告**、**分析报告**、**诊断报告**、**检测报告**、**监测报告**、**评估报告**、**质量报告** |
25
25
  | 网站/网络混用 | **网站诊断**、**网络诊断**、**网站检测**、**网络检测**、**网站监测**、**网络监测**、**网站分析**、**网络分析**、**网站体检**、**网络体检**、**网站评分**、**网络质量** |
26
- | 落地页 | **落地页诊断**、**落地页检测**、**落地页报告**、**页面质量**、**页面检测** |
27
- | 投放前 | **能不能投**、**适不适合投广告**、**网站好不好**、**官网行不行**、Lighthouse、PageSpeed、**速度检测**(**且带网址**) |
26
+ | 落地页 | **落地页诊断**、**落地页检测**、**落地页报告**、**页面质量**、**页面检测** |
27
+ | 投放前 | **能不能投**、**适不适合投广告**、**网站好不好**、**官网行不行**、Lighthouse、PageSpeed、**速度检测**(**且带网址**) |
28
28
 
29
29
  ### 0.3 命中后的 Agent 行为
30
30
 
@@ -34,13 +34,13 @@
34
34
 
35
35
  ### 0.4 示例(全部 → P8,不再消歧)
36
36
 
37
- | 用户说法 | 工作流 |
38
- | -------- | ------ |
39
- | 「帮我做一下 **www.xxx.com** 的**网络诊断**」 | **P8** |
40
- | 「**https://a.com** **网站检测报告**」 | **P8** |
41
- | 「这个**官网**做个**检测**」 | **P8**(先追问 URL 若未给出完整链接) |
42
- | 「**域名** xxx.cn **监测报告**」 | **P8** |
43
- | 「**落地页** **分析一下**能不能投」 | **P8** |
37
+ | 用户说法 | 工作流 |
38
+ | --------------------------------------------- | ------------------------------------- |
39
+ | 「帮我做一下 **www.xxx.com** 的**网络诊断**」 | **P8** |
40
+ | 「**https://a.com** **网站检测报告**」 | **P8** |
41
+ | 「这个**官网**做个**检测**」 | **P8**(先追问 URL 若未给出完整链接) |
42
+ | 「**域名** xxx.cn **监测报告**」 | **P8** |
43
+ | 「**落地页** **分析一下**能不能投」 | **P8** |
44
44
 
45
45
  ---
46
46
 
@@ -50,10 +50,10 @@
50
50
 
51
51
  ### B.1 信号词(命中任一即可)
52
52
 
53
- | 类别 | 常见说法(含口语 / 错字) |
54
- | ---- | ------------------------- |
55
- | 核心 | **行业分析**、**行业分析报告**、**行业报告**、**市场分析**、**市场分析报告**、**市场调查 / 调研报告** |
56
- | 战略向 | **战略市场报告**、**KA 市场报告**、**市场格局**、**行业趋势**、**竞品分析**、**GTM**、**进入策略 / 出海分析** |
53
+ | 类别 | 常见说法(含口语 / 错字) |
54
+ | ---------- | -------------------------------------------------------------------------------------------------------------------- |
55
+ | 核心 | **行业分析**、**行业分析报告**、**行业报告**、**市场分析**、**市场分析报告**、**市场调查 / 调研报告** |
56
+ | 战略向 | **战略市场报告**、**KA 市场报告**、**市场格局**、**行业趋势**、**竞品分析**、**GTM**、**进入策略 / 出海分析** |
57
57
  | 仅给行业名 | 「写 / 生成一份 **XX 行业**(电商 / 制造 / 医疗 / 机械…)报告」「**XX 行业**怎么样 / 前景如何」(**无 URL 主诉求**) |
58
58
 
59
59
  ### B.2 命中后的 Agent 行为(强制)
@@ -71,12 +71,12 @@
71
71
 
72
72
  ### B.4 示例(全部 → P9,必走 `market-analysis` CLI)
73
73
 
74
- | 用户说法 | 工作流 |
75
- | -------- | ------ |
76
- | 「写一份**制造业**的**行业分析报告**」 | **P9** |
74
+ | 用户说法 | 工作流 |
75
+ | ---------------------------------------------- | ------ |
76
+ | 「写一份**制造业**的**行业分析报告**」 | **P9** |
77
77
  | 「帮我生成一份**电商行业**的**行业分析报告**」 | **P9** |
78
- | 「做个**医疗器械**的**市场分析**」 | **P9** |
79
- | 「**XX 公司**的**竞品分析 / KA 市场报告**」 | **P9** |
78
+ | 「做个**医疗器械**的**市场分析**」 | **P9** |
79
+ | 「**XX 公司**的**竞品分析 / KA 市场报告**」 | **P9** |
80
80
 
81
81
  ---
82
82
 
@@ -86,12 +86,12 @@
86
86
 
87
87
  ### C.1 信号词(命中任一即可;**与 §零 诊断类词不冲突**——本段不要求「诊断/检测/报告」)
88
88
 
89
- | 类别 | 常见说法(含口语 / 英文) |
90
- | ---- | ------------------------- |
91
- | 核心 | **拓词**、**关键词规划**、**关键词推荐**、**Keyword Planner**、**Google Ads 关键词**、**谷歌广告关键词**、**搜索词推荐** |
92
- | 指标向 | **月搜索量**、**搜索量**、**search volume**、**竞争度**、**competition**、**CPC**、**出价区间** |
93
- | 词面向 | **长尾关键词**、**long-tail keywords**、**核心词**、**种子词**、**针对每个核心词**、**扩词**、**词包** |
94
- | 语境向 | **阅读(此)网址/文章/页面** + 出 **Google** 关键词;粘贴 **产品英文词表** + 要 **带搜索量** 的推荐 |
89
+ | 类别 | 常见说法(含口语 / 英文) |
90
+ | ------ | ------------------------------------------------------------------------------------------------------------------------ |
91
+ | 核心 | **拓词**、**关键词规划**、**关键词推荐**、**Keyword Planner**、**Google Ads 关键词**、**谷歌广告关键词**、**搜索词推荐** |
92
+ | 指标向 | **月搜索量**、**搜索量**、**search volume**、**竞争度**、**competition**、**CPC**、**出价区间** |
93
+ | 词面向 | **长尾关键词**、**long-tail keywords**、**核心词**、**种子词**、**针对每个核心词**、**扩词**、**词包** |
94
+ | 语境向 | **阅读(此)网址/文章/页面** + 出 **Google** 关键词;粘贴 **产品英文词表** + 要 **带搜索量** 的推荐 |
95
95
 
96
96
  ### C.2 命中后的 Agent 行为(强制)
97
97
 
@@ -102,12 +102,12 @@
102
102
 
103
103
  ### C.3 与 W3 / P8 / P9 区分
104
104
 
105
- | 用户侧重点 | 正确工作流 | 典型错误 |
106
- | ---------- | ---------- | -------- |
107
- | 要 **词表 + 搜索量/竞争度**(无 campaign JSON / validate) | **W5** | 纯 WebSearch 编数;或误走 W3 |
108
- | **阅读 URL/文章** + 针对 **核心词列表** 出 **Google 拓词表** | **W5** | 误走 P8(无诊断类词);误走 P9 |
109
- | 根据官网 **生成完整 Google 搜索广告方案** / `campaign-validate` | **W3** | 误走 W5 只出词表就停 |
110
- | **网址 + 诊断/检测/监测/报告**(§零) | **P8** | 误因带 URL 走 W5 |
105
+ | 用户侧重点 | 正确工作流 | 典型错误 |
106
+ | --------------------------------------------------------------- | ---------- | ------------------------------ |
107
+ | 要 **词表 + 搜索量/竞争度**(无 campaign JSON / validate) | **W5** | 纯 WebSearch 编数;或误走 W3 |
108
+ | **阅读 URL/文章** + 针对 **核心词列表** 出 **Google 拓词表** | **W5** | 误走 P8(无诊断类词);误走 P9 |
109
+ | 根据官网 **生成完整 Google 搜索广告方案** / `campaign-validate` | **W3** | 误走 W5 只出词表就停 |
110
+ | **网址 + 诊断/检测/监测/报告**(§零) | **P8** | 误因带 URL 走 W5 |
111
111
 
112
112
  ### C.4 禁止事项
113
113
 
@@ -117,11 +117,11 @@
117
117
 
118
118
  ### C.5 示例(全部 → W5,必走 `keyword` CLI)
119
119
 
120
- | 用户说法 | 工作流 |
121
- | -------- | ------ |
120
+ | 用户说法 | 工作流 |
121
+ | ----------------------------------------------------------------------------------------------------------------------- | ------ |
122
122
  | 「读 **https://example.com** 文章,针对 **fish gelatin** 等核心词推荐 Google **月搜索量 3000、竞争中低** 的长尾英文词」 | **W5** |
123
- | 「帮我做 **Keyword Planner** 拓词,要 **搜索量和竞争度**」 | **W5** |
124
- | 「这些 **B2B 产品词** 每个扩 **30 个长尾词**,输出英文+中文+搜索量+竞争度」 | **W5** |
123
+ | 「帮我做 **Keyword Planner** 拓词,要 **搜索量和竞争度**」 | **W5** |
124
+ | 「这些 **B2B 产品词** 每个扩 **30 个长尾词**,输出英文+中文+搜索量+竞争度」 | **W5** |
125
125
 
126
126
  ---
127
127
 
@@ -129,16 +129,16 @@
129
129
 
130
130
  ### 1. 提取信号(按优先级,命中即停)
131
131
 
132
- | 优先级 | 信号类型 | 规则 |
133
- | ------ | -------- | ---- |
134
- | **§零** | 网址 + 诊断类词 | 见上文 — **强制 P8** |
135
- | **§零·B** | 行业 / 市场分析报告词(无网址主诉求) | 见 §零·B — **强制 P9,100% 走 `market-analysis` CLI** |
136
- | **§零·C** | Google Ads 拓词 / 关键词规划 + 市场指标 | 见 §零·C — **强制 W5,100% 走 `keyword` CLI** |
137
- | **S0 魔法短语** | 固定话术 | 见 §三「魔法短语表」—— 命中则**直接**定工作流,不再追问 |
138
- | **S1 强否定** | 互斥词 | 见 §四「互斥矩阵」—— 排除错误工作流 |
139
- | **S2 强肯定** | 实体 / 对象 | 见 §二「对象 → 工作流」—— 账户 ID、URL、行业名、媒体、OKKI/询盘等 |
140
- | **S3 弱关键词** | 同义词 | 见 §二「用户说法 → 工作流」—— **单独出现「报告」不算** |
141
- | **S4 缺参** | 信息不足 | 走 §五「一次追问模板」,**最多 1 个二选一**,禁止连问多个问题 |
132
+ | 优先级 | 信号类型 | 规则 |
133
+ | --------------- | --------------------------------------- | ----------------------------------------------------------------- |
134
+ | **§零** | 网址 + 诊断类词 | 见上文 — **强制 P8** |
135
+ | **§零·B** | 行业 / 市场分析报告词(无网址主诉求) | 见 §零·B — **强制 P9,100% 走 `market-analysis` CLI** |
136
+ | **§零·C** | Google Ads 拓词 / 关键词规划 + 市场指标 | 见 §零·C — **强制 W5,100% 走 `keyword` CLI** |
137
+ | **S0 魔法短语** | 固定话术 | 见 §三「魔法短语表」—— 命中则**直接**定工作流,不再追问 |
138
+ | **S1 强否定** | 互斥词 | 见 §四「互斥矩阵」—— 排除错误工作流 |
139
+ | **S2 强肯定** | 实体 / 对象 | 见 §二「对象 → 工作流」—— 账户 ID、URL、行业名、媒体、OKKI/询盘等 |
140
+ | **S3 弱关键词** | 同义词 | 见 §二「用户说法 → 工作流」—— **单独出现「报告」不算** |
141
+ | **S4 缺参** | 信息不足 | 走 §五「一次追问模板」,**最多 1 个二选一**,禁止连问多个问题 |
142
142
 
143
143
  ### 2. 锁定唯一工作流
144
144
 
@@ -158,71 +158,71 @@
158
158
 
159
159
  > **读法**:**先执行 §零**;未命中再按本表。对象冲突时按 §四互斥矩阵 + §五追问。
160
160
 
161
- | 工作流 | 用户在问什么(对象) | 常见说法(含错字 / 口语) | 最小必填 | 默认交付 |
162
- | ------ | -------------------- | ------------------------- | -------- | -------- |
163
- | **P8** | **单个网站 / 落地页 / URL** 的质量 | 见 **§零**(含网站/网络混说);另:官网体检、投放前网站检查 | **URL** | HTML(`website-diagnosis render`) |
164
- | **P9** | **行业 / 市场 / 战略**(**无网址主诉求**) | 市场分析、**行业分析**、**行业分析报告**、市场调查报告、战略市场报告、KA 市场报告、竞品/GTM、「写一份 **XX 行业** 报告」(电商/制造/医疗…) | 客户名 / 行业 / 核心产品 **至少一项**(**不是** URL+诊断) | HTML(`market-analysis render`) |
165
- | **P1** | **单个 Google 广告账户** 的投放健康 / 诊断 | Google **广告**诊断、**账户**诊断报告、投放诊断、**账户**健康检查、**账户**体检(**且含 Google 账户 ID**) | 账户 ID + 统计区间 | HTML(`google-ads-diagnosis render`) |
166
- | **P4** | **单个媒体广告账户** 某区间的 **周期汇总** | 周期报告、月度报告、季度报告、月报、投放月报、Google 账户报告(**未强调「诊断/健康/网站/网址」**) | 媒体 + 账户 ID + 区间 | HTML(默认);用户要 Excel 见 P4 excel 纲要 |
167
- | **P4-FB** | **Meta/Facebook 账户** 周期或诊断 | Facebook 报告、Meta 月报、FB **账户**诊断报告 | Meta 账户 ID + 区间 | HTML(`facebook-analysis render`) |
168
- | **P6** | **OKKI 周报**(固定客户模板) | 见 §三魔法短语 | 账户 ID + 区间 | 多 Sheet xlsx |
169
- | **P7** | **Google 账户 + 询盘** 效果 | 见 §三魔法短语 | 账户 + 分析月 + 询盘资料 | 8 Sheet xlsx |
170
- | **P3** | **多个广告账户** 消耗对比 | 多账户对比、多户汇总报告、账户消耗排名 | 媒体 + 账户列表或全量 + 区间 | 表格 / 话术 |
171
- | **P2** | **多账户余额** 续航预警 | 余额扫描、快没钱了、充值预警 | 媒体(可选账户子集) | 列表 |
172
- | **P5** | **多账户 × 多维度** 批拉 | 批量分析、多户 google-analysis | ≥2 户 + ≥2 维度 + 区间 | 聚合报告 |
173
- | **W3** | 根据 **官网 / URL 生成 Google 搜索广告方案** | 根据网站**出广告**、搜索广告方案/计划/文案/关键词**表**、**生成**投放方案表格 | 官网 URL + **明确要广告方案** | JSON + 表格投影 |
174
- | **W5** | **Google Ads 关键词规划** / 拓词(含市场指标) | 见 **§零·C**:拓词、Keyword Planner、长尾词、**月搜索量**、**竞争度**、核心词扩词、读 URL/文章后出词表 | 种子词 / 核心词(URL 可选) | 词表(指标来自 `keyword` CLI) |
175
- | **W7** | **丝路赞平台内** 已生成的优化报告 / 推送 | Siluzan 优化报告列表、报告推送、邮件推送配置 | 按 `reporting.md` | 平台侧列表 |
161
+ | 工作流 | 用户在问什么(对象) | 常见说法(含错字 / 口语) | 最小必填 | 默认交付 |
162
+ | --------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------- |
163
+ | **P8** | **单个网站 / 落地页 / URL** 的质量 | 见 **§零**(含网站/网络混说);另:官网体检、投放前网站检查 | **URL** | HTML(`website-diagnosis render`) |
164
+ | **P9** | **行业 / 市场 / 战略**(**无网址主诉求**) | 市场分析、**行业分析**、**行业分析报告**、市场调查报告、战略市场报告、KA 市场报告、竞品/GTM、「写一份 **XX 行业** 报告」(电商/制造/医疗…) | 客户名 / 行业 / 核心产品 **至少一项**(**不是** URL+诊断) | HTML(`market-analysis render`) |
165
+ | **P1** | **单个 Google 广告账户** 的投放健康 / 诊断 | Google **广告**诊断、**账户**诊断报告、投放诊断、**账户**健康检查、**账户**体检(**且含 Google 账户 ID**) | 账户 ID + 统计区间 | HTML(`google-ads-diagnosis render`) |
166
+ | **P4** | **单个媒体广告账户** 某区间的 **周期汇总** | 周期报告、月度报告、季度报告、月报、投放月报、Google 账户报告(**未强调「诊断/健康/网站/网址」**) | 媒体 + 账户 ID + 区间 | HTML(默认);用户要 Excel 见 P4 excel 纲要 |
167
+ | **P4-FB** | **Meta/Facebook 账户** 周期或诊断 | Facebook 报告、Meta 月报、FB **账户**诊断报告 | Meta 账户 ID + 区间 | HTML(`facebook-analysis render`) |
168
+ | **P6** | **OKKI 周报**(固定客户模板) | 见 §三魔法短语 | 账户 ID + 区间 | 多 Sheet xlsx |
169
+ | **P7** | **Google 账户 + 询盘** 效果 | 见 §三魔法短语 | 账户 + 分析月 + 询盘资料 | 8 Sheet xlsx |
170
+ | **P3** | **多个广告账户** 消耗对比 | 多账户对比、多户汇总报告、账户消耗排名 | 媒体 + 账户列表或全量 + 区间 | 表格 / 话术 |
171
+ | **P2** | **多账户余额** 续航预警 | 余额扫描、快没钱了、充值预警 | 媒体(可选账户子集) | 列表 |
172
+ | **P5** | **多账户 × 多维度** 批拉 | 批量分析、多户 google-analysis | ≥2 户 + ≥2 维度 + 区间 | 聚合报告 |
173
+ | **W3** | 根据 **官网 / URL 生成 Google 搜索广告方案** | 根据网站**出广告**、搜索广告方案/计划/文案/关键词**表**、**生成**投放方案表格 | 官网 URL + **明确要广告方案** | JSON + 表格投影 |
174
+ | **W5** | **Google Ads 关键词规划** / 拓词(含市场指标) | 见 **§零·C**:拓词、Keyword Planner、长尾词、**月搜索量**、**竞争度**、核心词扩词、读 URL/文章后出词表 | 种子词 / 核心词(URL 可选) | 词表(指标来自 `keyword` CLI) |
175
+ | **W7** | **丝路赞平台内** 已生成的优化报告 / 推送 | Siluzan 优化报告列表、报告推送、邮件推送配置 | 按 `reporting.md` | 平台侧列表 |
176
176
 
177
177
  ### P8 vs P9 vs W3 vs W5(最高频误路由)
178
178
 
179
- | 用户侧重点 | 正确工作流 | 典型错误 |
180
- | ---------- | ---------- | -------- |
181
- | **有网址** + 诊断/检测/监测/报告(含说「**网络**」) | **P8(§零)** | 误走 P9「行业/网络分析」、P1 账户诊断 |
182
- | 「这个**网站**好不好 / 能不能投」(无广告方案诉求) | **P8** | 误走 P9、W3 |
183
- | 「**电商/制造**行业怎么样 / 市场格局」(**无 URL**) | **P9** | 误走 P8 |
184
- | 「根据**官网**做 **Google 搜索广告** / 关键词表」 | **W3** | 误走 P8 只诊断不出方案 |
185
- | 「读**网址/文章** + **核心词** + 要 **月搜索量/竞争度** 长尾词表」 | **W5(§零·C)** | 纯 WebSearch 编数;误走 P8/P9/W3 |
186
- | 只要 **Keyword Planner / 拓词** 指标,不要 campaign JSON | **W5** | 误走 W3 走 validate/create |
179
+ | 用户侧重点 | 正确工作流 | 典型错误 |
180
+ | ------------------------------------------------------------------ | --------------- | ------------------------------------- |
181
+ | **有网址** + 诊断/检测/监测/报告(含说「**网络**」) | **P8(§零)** | 误走 P9「行业/网络分析」、P1 账户诊断 |
182
+ | 「这个**网站**好不好 / 能不能投」(无广告方案诉求) | **P8** | 误走 P9、W3 |
183
+ | 「**电商/制造**行业怎么样 / 市场格局」(**无 URL**) | **P9** | 误走 P8 |
184
+ | 「根据**官网**做 **Google 搜索广告** / 关键词表」 | **W3** | 误走 P8 只诊断不出方案 |
185
+ | 「读**网址/文章** + **核心词** + 要 **月搜索量/竞争度** 长尾词表」 | **W5(§零·C)** | 纯 WebSearch 编数;误走 P8/P9/W3 |
186
+ | 只要 **Keyword Planner / 拓词** 指标,不要 campaign JSON | **W5** | 误走 W3 走 validate/create |
187
187
 
188
188
  ### P1 vs P4 vs P8(「报告」三字歧义)
189
189
 
190
- | 用户侧重点 | 正确工作流 |
191
- | ---------- | ---------- |
192
- | 给了 **Google 账户 ID**,要健康/诊断/优化建议 | **P1**(`google-ads-diagnosis`) |
193
- | 给了 **账户 ID**,要某月/某季 **投放数据汇总** | **P4** |
194
- | 给了 **URL / 网址 / 域名** + 诊断类词(§零) | **P8** |
195
- | 只给 **行业名**(无 URL),要行业分析 | **P9** |
190
+ | 用户侧重点 | 正确工作流 |
191
+ | ---------------------------------------------- | -------------------------------- |
192
+ | 给了 **Google 账户 ID**,要健康/诊断/优化建议 | **P1**(`google-ads-diagnosis`) |
193
+ | 给了 **账户 ID**,要某月/某季 **投放数据汇总** | **P4** |
194
+ | 给了 **URL / 网址 / 域名** + 诊断类词(§零) | **P8** |
195
+ | 只给 **行业名**(无 URL),要行业分析 | **P9** |
196
196
 
197
197
  ---
198
198
 
199
199
  ## 三、魔法短语表(S0:命中直接定工作流)
200
200
 
201
- | 用户话术(含子串即可) | 工作流 | 备注 |
202
- | ---------------------- | ------ | ---- |
203
- | **网址 / URL / 域名 / 官网 / 落地页** + **诊断 / 检测 / 监测 / 评估 / 体检 / 报告**(含「网络诊断」「网络检测」) | **P8** | 与 **§零** 同义;**优先 §零** |
204
- | `OKKI 周报` / `okki 周报` / `使用 okki 周报模板` | **P6** | **不按 P4 默认 8 维** |
205
- | `Google 账户询盘分析` / `分析 … Google 账号的询盘效果` / 同时含「询盘 + Google + 账户」 | **P7** | 严格 3 个月窗口 |
206
- | `根据 … 生成 Google **搜索**广告` / `搜索广告方案` / `关键词表` + 官网 URL | **W3** | ≠ P8 ≠ P9;若同时要 **搜索量/竞争度** → **W5** |
207
- | **月搜索量** / **竞争度** / **Keyword Planner** / **长尾关键词** / **针对核心词推荐** | **W5(§零·C)** | 必 `keyword --google-only` |
208
- | `丝路赞` / `Siluzan` + `优化报告列表` / `报告推送` | **W7** | ≠ 自拉数 P1/P4 |
201
+ | 用户话术(含子串即可) | 工作流 | 备注 |
202
+ | ----------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------------------------- |
203
+ | **网址 / URL / 域名 / 官网 / 落地页** + **诊断 / 检测 / 监测 / 评估 / 体检 / 报告**(含「网络诊断」「网络检测」) | **P8** | 与 **§零** 同义;**优先 §零** |
204
+ | `OKKI 周报` / `okki 周报` / `使用 okki 周报模板` | **P6** | **不按 P4 默认 8 维** |
205
+ | `Google 账户询盘分析` / `分析 … Google 账号的询盘效果` / 同时含「询盘 + Google + 账户」 | **P7** | 严格 3 个月窗口 |
206
+ | `根据 … 生成 Google **搜索**广告` / `搜索广告方案` / `关键词表` + 官网 URL | **W3** | ≠ P8 ≠ P9;若同时要 **搜索量/竞争度** → **W5** |
207
+ | **月搜索量** / **竞争度** / **Keyword Planner** / **长尾关键词** / **针对核心词推荐** | **W5(§零·C)** | 必 `keyword --google-only` |
208
+ | `丝路赞` / `Siluzan` + `优化报告列表` / `报告推送` | **W7** | ≠ 自拉数 P1/P4 |
209
209
 
210
210
  ---
211
211
 
212
212
  ## 四、互斥矩阵(S1:见到 A 则禁止选 B)
213
213
 
214
- | 若用户明确… | 禁止误选 |
215
- | ----------- | -------- |
216
- | **§零 命中**(网址 + 诊断类词) | P9、P1、P4、P2、P3、W5;**禁止**因「网络」二字改走 P9 |
217
- | **URL / 官网 / 落地页 / 域名** + 诊断类词(且未要求「生成搜索广告方案」) | P9、P4、P1、W5 |
218
- | **XX 行业 / 市场分析 / 战略**(**且无 URL + 诊断类词**) | P8、P1、P4、W3 |
219
- | **Google 账户 ID / 消耗 / 系列 / 关键词**(**且无 URL + 诊断类词**) | P8、P9 |
220
- | **生成搜索广告 / 投放方案**(完整 campaign 结构) | P8、P9、P5、W5 |
221
- | **§零·C 命中**(拓词 / 月搜索量 / 竞争度 / Keyword Planner) | P8、P9、P1、P4;**禁止**纯 WebSearch 代替 `keyword` |
222
- | **OKKI** | P4 默认周期 |
223
- | **询盘** + Google 账户 | P4、P1 简版诊断 |
224
- | 仅 **WebSearch 写行业长文** | 代替 P9 `collect`+`render` |
225
- | 仅 **Markdown 摘要** | 代替 P8/P9/P1 的 HTML `render` |
214
+ | 若用户明确… | 禁止误选 |
215
+ | ------------------------------------------------------------------------- | ----------------------------------------------------- |
216
+ | **§零 命中**(网址 + 诊断类词) | P9、P1、P4、P2、P3、W5;**禁止**因「网络」二字改走 P9 |
217
+ | **URL / 官网 / 落地页 / 域名** + 诊断类词(且未要求「生成搜索广告方案」) | P9、P4、P1、W5 |
218
+ | **XX 行业 / 市场分析 / 战略**(**且无 URL + 诊断类词**) | P8、P1、P4、W3 |
219
+ | **Google 账户 ID / 消耗 / 系列 / 关键词**(**且无 URL + 诊断类词**) | P8、P9 |
220
+ | **生成搜索广告 / 投放方案**(完整 campaign 结构) | P8、P9、P5、W5 |
221
+ | **§零·C 命中**(拓词 / 月搜索量 / 竞争度 / Keyword Planner) | P8、P9、P1、P4;**禁止**纯 WebSearch 代替 `keyword` |
222
+ | **OKKI** | P4 默认周期 |
223
+ | **询盘** + Google 账户 | P4、P1 简版诊断 |
224
+ | 仅 **WebSearch 写行业长文** | 代替 P9 `collect`+`render` |
225
+ | 仅 **Markdown 摘要** | 代替 P8/P9/P1 的 HTML `render` |
226
226
 
227
227
  ---
228
228
 
@@ -234,7 +234,7 @@
234
234
  > **A** — **网站/落地页**质量报告(需要发我 **网址**)→ P8
235
235
  > **B** — **行业/市场**战略报告(需要 **行业或客户名**,**不是**网址检测)→ P9
236
236
  > **C** — **Google 广告账户**诊断或周期报告(需要 **账户 ID**)→ P1 或 P4
237
- > **D** — 根据官网 **生成 Google 搜索广告方案**(需要 **网址 + 预算/地域**)→ W3
237
+ > **D** — 根据官网 **生成 Google 搜索广告方案**(需要 **网址 + 预算/地域**)→ W3
238
238
 
239
239
  **§零 已命中时禁止本段追问**(例如用户已给 URL 并说「网络诊断」→ 直接 P8)。
240
240
 
@@ -242,28 +242,27 @@
242
242
 
243
243
  ## 六、各工作流缺参时的补参话术(定工作流后)
244
244
 
245
- | 工作流 | 缺什么 | Agent 怎么说(示例) |
246
- | ------ | ------ | -------------------- |
247
- | P8 | URL | 「网站诊断需要完整网址,请发官网链接(`https://` 或域名均可)。」 |
248
- | P9 | 四选一全空 | 「请给行业名(如电商)或客户名/核心产品至少一项。」 |
249
- | P1 / P4 | 账户 ID | 「请提供 Google 广告账户 ID(mediaCustomerId)。」 |
250
- | P1 / P4 | 时间 | 按 `agent-conventions.md` §五 反问区间 |
251
- | P6 | 非 OKKI 话术 | 若用户实际要普通周期报告 → 改 P4 并说明 |
252
- | P7 | 无询盘文件 | 贴字段清单,**禁止编造询盘** |
253
- | W3 | 预算/地域 | 先列待确认项,再进入 campaign-plan 流水线 |
245
+ | 工作流 | 缺什么 | Agent 怎么说(示例) |
246
+ | ------- | ------------ | ----------------------------------------------------------------- |
247
+ | P8 | URL | 「网站诊断需要完整网址,请发官网链接(`https://` 或域名均可)。」 |
248
+ | P9 | 四选一全空 | 「请给行业名(如电商)或客户名/核心产品至少一项。」 |
249
+ | P1 / P4 | 账户 ID | 「请提供 Google 广告账户 ID(mediaCustomerId)。」 |
250
+ | P1 / P4 | 时间 | 按 `agent-conventions.md` §五 反问区间 |
251
+ | P6 | 非 OKKI 话术 | 若用户实际要普通周期报告 → 改 P4 并说明 |
252
+ | P7 | 无询盘文件 | 贴字段清单,**禁止编造询盘** |
253
+ | W3 | 预算/地域 | 先列待确认项,再进入 campaign-plan 流水线 |
254
254
 
255
255
  ---
256
256
 
257
257
  ## 七、与 SKILL 路由表的对应
258
258
 
259
- | SKILL 路由表章节 | 本文件章节 |
260
- | ---------------- | ---------- |
261
- | 分析与报告(P1–P9) | **§零**、**§零·B**、§二、§三 |
262
- | 行业 / 市场分析报告 P9(100% 走 CLI) | **§零·B**、§二 P9、§四 |
263
- | Google Ads 关键词规划 W5(100% 走 `keyword` CLI) | **§零·C**、§二 W5、§三、§四 |
264
- | Google 广告投放 W3 | §二 W3、§四 |
265
- | TSO 平台优化报告 W7 | §二 W7、§三 |
266
- | `agent-preamble.md` 消歧摘要 | **§零** + **§零·B** + §二 P8/P9/W3 段 |
259
+ | SKILL 路由表章节 | 本文件章节 |
260
+ | ------------------------------------------------- | ------------------------------------- |
261
+ | 分析与报告(P1–P9) | **§零**、**§零·B**、§二、§三 |
262
+ | 行业 / 市场分析报告 P9(100% 走 CLI) | **§零·B**、§二 P9、§四 |
263
+ | Google Ads 关键词规划 W5(100% 走 `keyword` CLI) | **§零·C**、§二 W5、§三、§四 |
264
+ | Google 广告投放 W3 | §二 W3、§四 |
265
+ | TSO 平台优化报告 W7 | §二 W7、§三 |
266
+ | `agent-preamble.md` 消歧摘要 | **§零** + **§零·B** + §二 P8/P9/W3 段 |
267
267
 
268
268
  **维护约定**:新增报告类工作流时,必须同步更新本文件 §二 一行 + §三(若有魔法短语)+ 可选 eval 场景(`eval/scenarios/intent-routing.ts`)。
269
-
@@ -42,7 +42,7 @@
42
42
  | **P7 询盘**:`m1`/`m2`/`m3` 三月拉数 | **并行委派** | 3× Task(`handoff-p7-inquiry.md` 子目录变体) | 3× 主会话顺序跑 |
43
43
  | **P5** `google-analysis-batch run` 全量 | **主会话或单次 Bash** | **一次** batch;CLI 内置并发 | per-account 子会话调 API |
44
44
  | **P5** batch **完成后** 按账户聚合 | **可选并行** | N× Task,只读 `results/<accountId>/` | 子会话 `run` 新 batch |
45
- | 读 `references/google-ads/rules/*` 全文做方案 | **委派** | **Explore** + `readonly` | 主会话 Read 全文进上下文 |
45
+ | 读 `references/google-ads/rules/*` 全文做方案 | **委派** | **Explore** + `readonly` | 主会话 Read 全文进上下文 |
46
46
  | 用户仅闲聊 / 解释字段口径 | **主会话** | — | — |
47
47
 
48
48
  ---
@@ -4,20 +4,20 @@
4
4
  >
5
5
  > **通用纪律统一见 `references/core/agent-conventions.md`**(写操作确认 + `--commit`、ID 口径、数据处理协议),各卡片不再重复。**命令参数、字段口径以「必读」指向的域 reference 为唯一真相源,本文件只给线性步骤,不重复参数表。** 每张卡片结构统一:`触发 / 必读 / 步骤 / 交付与确认`。
6
6
 
7
- | 编号 | 业务 | 必读 |
8
- | ---- | ------------------------------- | --------------------------------------------------------------------- |
9
- | W1 | 账户查询(列表/余额/消耗/账单) | `references/accounts/accounts.md` |
10
- | W2 | 开户申请(六大媒体) | `references/accounts/open-account-by-media.md` |
7
+ | 编号 | 业务 | 必读 |
8
+ | ---- | ------------------------------- | ------------------------------------------------------------------------------------------- |
9
+ | W1 | 账户查询(列表/余额/消耗/账单) | `references/accounts/accounts.md` |
10
+ | W2 | 开户申请(六大媒体) | `references/accounts/open-account-by-media.md` |
11
11
  | W3 | Google 广告创建与精细管理 | `references/google-ads/google-ads-campaign-plan.md` + `references/google-ads/google-ads.md` |
12
- | W4 | AI 智投草稿 → 发布 | `references/google-ads/google-ads.md`(ad batch) |
12
+ | W4 | AI 智投草稿 → 发布 | `references/google-ads/google-ads.md`(ad batch) |
13
13
  | W5 | 拓词 / RAG | `references/analytics/keyword-planner-workflows.md` + `references/analytics/rag.md` |
14
- | W6 | AI 广告优化记录查看与执行 | `references/operations/optimize.md` |
15
- | W7 | TSO 优化报告生成 → 推送 | `references/analytics/reporting.md` |
16
- | W8 | 财务:充值 / 转账 / 开票 | `references/accounts/finance.md` |
17
- | W9 | 账户权限管理 | `references/accounts/accounts.md`(account 子命令) |
18
- | W10 | 智能预警规则管理 | `references/operations/forewarning.md` |
19
- | W11 | 广告线索提取 | `references/operations/clue.md` |
20
- | W12 | 日 / 周巡检 | `references/accounts/accounts.md` + 各域 |
14
+ | W6 | AI 广告优化记录查看与执行 | `references/operations/optimize.md` |
15
+ | W7 | TSO 优化报告生成 → 推送 | `references/analytics/reporting.md` |
16
+ | W8 | 财务:充值 / 转账 / 开票 | `references/accounts/finance.md` |
17
+ | W9 | 账户权限管理 | `references/accounts/accounts.md`(account 子命令) |
18
+ | W10 | 智能预警规则管理 | `references/operations/forewarning.md` |
19
+ | W11 | 广告线索提取 | `references/operations/clue.md` |
20
+ | W12 | 日 / 周巡检 | `references/accounts/accounts.md` + 各域 |
21
21
 
22
22
  ---
23
23