siluzan-tso-cli 1.1.21 → 1.1.22-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 (121) hide show
  1. package/README.md +3 -2
  2. package/dist/index.js +140 -58
  3. package/dist/skill/AGENTS.md +45 -0
  4. package/dist/skill/SKILL.md +60 -346
  5. package/dist/skill/_meta.json +2 -2
  6. package/dist/skill/assets/campaign-create-template.md +4 -4
  7. package/dist/skill/assets/pmax-create-template.md +4 -3
  8. package/dist/skill/docs/skill-guide.md +44 -0
  9. package/dist/skill/references/README.md +73 -0
  10. package/dist/skill/references/{accounts.md → accounts/accounts.md} +7 -7
  11. package/dist/skill/references/{currency.md → accounts/currency.md} +7 -7
  12. package/dist/skill/references/{finance.md → accounts/finance.md} +5 -5
  13. package/dist/skill/references/accounts/open-account-by-media.md +151 -0
  14. package/dist/skill/references/{open-account-google-ui.md → accounts/open-account-google-ui.md} +2 -2
  15. package/dist/skill/references/{account-analytics.md → analytics/account-analytics.md} +2 -2
  16. package/dist/skill/references/{google-analysis-batch.md → analytics/google-analysis-batch.md} +2 -2
  17. package/dist/skill/references/{keyword-planner-workflows.md → analytics/keyword-planner-workflows.md} +9 -9
  18. package/dist/skill/references/{rag.md → analytics/rag.md} +6 -6
  19. package/dist/skill/references/{reporting.md → analytics/reporting.md} +6 -6
  20. package/dist/skill/references/core/agent-conventions.md +180 -0
  21. package/dist/skill/references/core/playbooks.md +141 -0
  22. package/dist/skill/references/{setup.md → core/setup.md} +5 -5
  23. package/dist/skill/references/core/skill-authoring.md +192 -0
  24. package/dist/skill/references/{tips.md → core/tips.md} +5 -5
  25. package/dist/skill/references/{workflows.md → core/workflows.md} +23 -25
  26. package/dist/skill/references/{google-ads-campaign-plan.md → google-ads/google-ads-campaign-plan.md} +22 -22
  27. package/dist/skill/references/{google-ads.md → google-ads/google-ads.md} +11 -15
  28. package/dist/skill/references/{pmax-api.md → google-ads/pmax-api.md} +0 -2
  29. package/dist/skill/references/google-ads/rules/README.md +21 -0
  30. package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-keyword-taxonomy.md +2 -2
  31. package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-launch-plan-template.md +8 -8
  32. package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-pmax-guide.md +1 -1
  33. package/dist/skill/references/{tso-home.md → misc/tso-home.md} +5 -5
  34. package/dist/skill/references/{hosted-automation-monitoring-json.md → operations/hosted-automation-monitoring-json.md} +8 -8
  35. package/dist/skill/references/{hosted-automation-optimize-ab-winner.md → operations/hosted-automation-optimize-ab-winner.md} +2 -2
  36. package/dist/skill/references/{hosted-automation-optimize-index.md → operations/hosted-automation-optimize-index.md} +6 -6
  37. package/dist/skill/references/{hosted-automation-optimize-scale.md → operations/hosted-automation-optimize-scale.md} +2 -2
  38. package/dist/skill/references/{hosted-automation-optimize-weak-downbid.md → operations/hosted-automation-optimize-weak-downbid.md} +5 -5
  39. package/dist/skill/references/operations/hosted-automation-scenarios.md +23 -0
  40. package/dist/skill/references/{hosted-automation-self-control.md → operations/hosted-automation-self-control.md} +14 -14
  41. package/{assets/siluzan-ads/references → dist/skill/references/operations}/hosted-automation-user-catalog.md +12 -12
  42. package/dist/skill/report-templates/README.md +2 -1
  43. package/dist/skill/report-templates/REPORT-WORKFLOW.md +2 -2
  44. package/dist/skill/report-templates/google-ads-diagnosis.md +1 -1
  45. package/dist/skill/report-templates/google-inquiry-analysis.md +6 -6
  46. package/dist/skill/report-templates/google-period-report.md +1 -1
  47. package/dist/skill/report-templates/okki-weekly-google-client.md +4 -4
  48. package/dist/skill/scripts/install.ps1 +3 -3
  49. package/dist/skill/scripts/install.sh +3 -3
  50. package/eval/cases/accounts-entityid-vs-mediaccustomerid.scenario.json +2 -2
  51. package/eval/cases/accounts-mcc-bind-inquiry.scenario.json +3 -3
  52. package/eval/cases/accounts-single-balance-not-bulk.scenario.json +2 -2
  53. package/eval/cases/clue-meta-leads-json.scenario.json +2 -2
  54. package/eval/cases/clue-tiktok-leads-json.scenario.json +2 -2
  55. package/eval/cases/destructive-account-delink-needs-confirm.scenario.json +1 -1
  56. package/eval/cases/destructive-forewarning-delete-needs-confirm.scenario.json +1 -1
  57. package/eval/cases/destructive-invoice-apply-needs-confirm.scenario.json +1 -1
  58. package/eval/cases/finance-invoice-info-list.scenario.json +2 -2
  59. package/eval/cases/forewarning-list-google.scenario.json +2 -2
  60. package/eval/cases/google-ads-no-structural-without-confirm.scenario.json +3 -3
  61. package/eval/cases/google-analysis-keywords-route.scenario.json +2 -2
  62. package/eval/cases/hosted-sop-cpa-spike-downbid.scenario.json +5 -5
  63. package/eval/cases/hosted-sop-daily-budget-circuit-breaker.scenario.json +3 -3
  64. package/eval/cases/hosted-sop-empty-spend-pause-p1.scenario.json +5 -5
  65. package/eval/cases/meta-single-balance-not-bulk.scenario.json +2 -2
  66. package/eval/cases/open-account-bing-noninteractive.scenario.json +3 -3
  67. package/eval/cases/open-account-google-noninteractive.scenario.json +2 -2
  68. package/eval/cases/open-account-tiktok-license-file.scenario.json +2 -2
  69. package/eval/cases/optimize-list-by-account.scenario.json +2 -2
  70. package/eval/cases/rag-before-keyword-expand.scenario.json +3 -3
  71. package/eval/cases/rag-list-then-query.scenario.json +2 -2
  72. package/eval/cases/report-list-google.scenario.json +2 -2
  73. package/eval/cases/report-push-list-google.scenario.json +3 -3
  74. package/eval/cases/reporting-vs-account-analytics-routing.scenario.json +4 -4
  75. package/eval/cases/setup-login-or-env.scenario.json +2 -2
  76. package/eval/cases/setup-siluzan-data-permission-env.scenario.json +2 -2
  77. package/eval/cases/skill-optimize-vs-google-ads-distinction.scenario.json +4 -4
  78. package/eval/cases/tiktok-bc-bind-inquiry.scenario.json +2 -2
  79. package/eval/cases/tips-json-filtering.scenario.json +4 -4
  80. package/eval/cases/tips-large-json-pagination.scenario.json +3 -3
  81. package/eval/cases/uj-ad-bluetooth-keywords-exclude-cheap-free.scenario.json +1 -1
  82. package/eval/cases/uj-ad-campaign-validate-before-create-stub.scenario.json +2 -2
  83. package/eval/cases/uj-ad-keywords-camping-tent-outdoor-plan.scenario.json +1 -1
  84. package/eval/cases/uj-ad-outdoor-campgear-search-plan.scenario.json +3 -3
  85. package/eval/cases/uj-analytics-30d-pdf-campaign-device-geo.scenario.json +2 -2
  86. package/eval/cases/uj-analytics-compare-google-tiktok-last-month-roi.scenario.json +1 -1
  87. package/eval/cases/uj-analytics-google-weekly-trends-campaigns-keywords.scenario.json +2 -2
  88. package/eval/cases/uj-analytics-report-push-weekly-email.scenario.json +3 -3
  89. package/eval/cases/uj-finance-invoice-records-this-month.scenario.json +2 -2
  90. package/eval/cases/uj-life-newbie-siluzan-google-end-to-end.scenario.json +2 -2
  91. package/eval/cases/uj-ops-google-accounts-list-normal.scenario.json +2 -2
  92. package/eval/cases/uj-ops-google-yesterday-spend-conversions.scenario.json +2 -2
  93. package/eval/cases/uj-ops-open-google-b2c-usd-shenzhen.scenario.json +3 -3
  94. package/eval/cases/uj-ops-pause-worst-adgroup-confirm.scenario.json +2 -2
  95. package/eval/cases/uj-ops-tiktok-leads-last-week.scenario.json +2 -2
  96. package/eval/cases/uj-patrol-cpc-spike-adgroups-over-15.scenario.json +3 -3
  97. package/eval/cases/uj-patrol-forewarning-create-daily-cap-3000.scenario.json +3 -3
  98. package/eval/cases/uj-patrol-forewarning-trigger-records.scenario.json +2 -2
  99. package/eval/cases/uj-patrol-google-balances-low.scenario.json +2 -2
  100. package/eval/cases/uj-roi-full-google-account-diagnosis.scenario.json +1 -1
  101. package/eval/cases/uj-roi-keywords-high-cpa-low-cvr-triage.scenario.json +1 -1
  102. package/eval/cases/uj-roi-optimize-records-then-execute-cautiously.scenario.json +2 -2
  103. package/eval/cases/uj-roi-search-terms-add-negative-keywords.scenario.json +2 -2
  104. package/package.json +2 -2
  105. package/dist/skill/references/hosted-automation-scenarios.md +0 -23
  106. package/dist/skill/references/hosted-automation-user-catalog.md +0 -38
  107. /package/dist/skill/references/{write-audit-restore.md → accounts/write-audit-restore.md} +0 -0
  108. /package/dist/skill/references/{geo-continents.json → analytics/geo-continents.json} +0 -0
  109. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-account-audit.md +0 -0
  110. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-audience-strategy.md +0 -0
  111. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-campaign-optimization.md +0 -0
  112. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-compliance.md +0 -0
  113. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-conversion-architecture.md +0 -0
  114. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-creative-optimization.md +0 -0
  115. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-keyword-optimization.md +0 -0
  116. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-keyword-strategy.md +0 -0
  117. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/google-ads-landing-page-discovery-via-webfetch.md +0 -0
  118. /package/dist/skill/references/{google-ads-rules → google-ads/rules}/sensitive-industries.md +0 -0
  119. /package/dist/skill/references/{clue.md → operations/clue.md} +0 -0
  120. /package/dist/skill/references/{forewarning.md → operations/forewarning.md} +0 -0
  121. /package/dist/skill/references/{optimize.md → operations/optimize.md} +0 -0
package/dist/skill/references/hosted-automation-user-catalog.md DELETED
@@ -1,38 +0,0 @@
1
- # 自动化场景
2
-
3
- 这是skill的一些结合Agent客户端可完成的自动化功能，你可以给用户介绍下面的这些内容
4
-
5
- ## 预算 & ROI 控制引擎
6
-
7
- 三条均为 **Google 宿主编排 + siluzan-tso** 路径；IF/定时/通知在宿主，命令与 JSON 以详规为准。
8
-
9
- | 提醒名称 | 系统在后台默默帮你做什么？(自动动作) | 文档（references） |
10
- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
11
- | 1. 单日预算熔断 | 当日系列 **花费**相对**日预算**达到设定比例（如 ≥110%，可配 110%–120% 抗延迟）时，**暂停 Campaign**；恢复需人工加预算后再启用。 | [场景 1 · 单日预算熔断](hosted-automation-self-control.md) · [`google-ads.md`](google-ads.md)（`ad campaigns`、`ad campaign-status`、预算口径） · [`tips.md`](tips.md)（`--json`） |
12
- | 2. CPA 飙升自动降价 | 滑动时间窗内 **转化数**达置信阈值且 **实际 CPA** 高于 **目标 CPA×飙升比例** 时，在 **Campaign / Ad Group** 上**下调** tCPA 或 eCPC 等**出价上限**（具体策略依账户）。 | [场景 2 · CPA 飙升自动降价](hosted-automation-self-control.md) · [`hosted-automation-optimize-weak-downbid.md`](hosted-automation-optimize-weak-downbid.md)（组/创意侧降价关停，可与宿主组合） · [`google-ads.md`](google-ads.md)（`campaign-edit`、`adgroup-edit`） · [`account-analytics.md`](account-analytics.md)（窗口粒度不足时的报表拉数） |
13
- | 3. 连续空耗自动暂停 | **当日**累计 **花费 ≥ 目标 CPA×N** 且 **转化为 0** 时，**暂停**广告组或创意；宿主发 **P1** 且文案含 **「空耗熔断」**。 | [场景 3 · 连续空耗自动暂停](hosted-automation-self-control.md) · [`google-ads.md`](google-ads.md)（`ad groups`、`ad list`、`adgroup-status`、`ad-status`） · [`hosted-automation-monitoring-json.md`](hosted-automation-monitoring-json.md)（JSON 键名勿套用 Google Ads API 官方名） |
14
-
15
- **总索引**：[`hosted-automation-scenarios.md`](hosted-automation-scenarios.md) · **自控全文**：[`hosted-automation-self-control.md`](hosted-automation-self-control.md) · **金额硬规范**（展示用 `*Display` 等）：[`SKILL.md`](../SKILL.md)「金额与货币单位硬约束」。
16
-
17
- ## 异常监控与报警系统
18
-
19
- 编排（定时、HTTP 探活、通知）在宿主；**读哪些 JSON 字段、用什么命令** 以 **[`hosted-automation-monitoring-json.md`](hosted-automation-monitoring-json.md)** 为准（键名以当次 `--json` 为准，勿套用 Google Ads API 官方字段名解析本 CLI 输出）。
20
-
21
- | 功能名称 | 监控层级 / 说明 | CLI 检查入口（`--json`） |
22
- | ----------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
23
- | 1. 账户被封禁 | 账户级；与 Google `CustomerStatus` 及 `list-accounts` 的字段映射**暂不写进本 skill**，由宿主约定。 | `list-accounts`、`balance` 等见 [`accounts.md`](accounts.md) |
24
- | 2. 落地页死链强停 | URL 不可用或跳错页时暂停关联创意，避免无效消耗。 | **`google-analysis --sections final-urls`**；或 **`ad list`** / **`google-analysis --sections ads`** 取落地页字段后由宿主 HTTP 校验 |
25
- | 3. 广告素材拒审 | 创意政策状态异常时告警或配合工单。 | **`ad list`** / **`google-analysis --sections ads`**：`policyApprovalStatusV2`、`approvalStatusDetails` 等（见 **[`google-ads.md`](google-ads.md)**） |
26
- | 4. 花费异动监控 | 系列或账户维度花费相对历史异常波动。 | **`google-analysis --sections campaign-hour`**：按 `campaignId` + `date` + `hour` 看 **`spend`** |
27
- | 5. 余额枯竭预警 | 余额过低或按日均推算续航不足。 | **`balance-scan`**（`balance`、`remainingDays`、`hitReason`、`meta`）或 **`balance`** / **`google-analysis --sections overview`**（`remainingAccountBudget`、`averageDailyCost` 等） |
28
-
29
- ## 自动优化
30
-
31
- 编排与阈值在宿主；**命令、JSON 键名、聚合与写后复核** 见 **[`hosted-automation-optimize-index.md`](hosted-automation-optimize-index.md)**（及链出的三份 SOP）。
32
-
33
- | 功能名称 | 说明 | SOP |
34
- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
35
- | 1. 表现差广告降价/关停 | 组/创意：CTR、CPA、转化等触达后 **下调 `targetCpa` 或 `Paused`**。 | [`hosted-automation-optimize-weak-downbid.md`](hosted-automation-optimize-weak-downbid.md) |
36
- | 2. 高转化广告提价扩量 | 系列/组：ROAS 代理、预算丢失份额等触达后 **提预算 / 上调目标 CPA**。 | [`hosted-automation-optimize-scale.md`](hosted-automation-optimize-scale.md) |
37
- | 3. A/B 测试自动决出胜者 | 同组多创意：聚合后比 **CVPI / all conv** 等，**停输家**。 | [`hosted-automation-optimize-ab-winner.md`](hosted-automation-optimize-ab-winner.md) |
38
- | 4. 异动根因自动排查建议 | 诊断报告与归因：用 `account-analytics`、报告模板等，见 [`account-analytics.md`](account-analytics.md) 与 `report-templates/`。 | （未单独拆 SOP，沿用分析文档） |