siluzan-tso-cli 1.1.30-beta.5 → 1.1.30-beta.6

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 (36) hide show
  1. package/README.md +1 -1
  2. package/dist/skill/SKILL.md +34 -34
  3. package/dist/skill/_meta.json +2 -2
  4. package/dist/skill/assets/campaign-create-template.md +1 -1
  5. package/dist/skill/references/README.md +35 -35
  6. package/dist/skill/references/accounts/accounts.md +4 -4
  7. package/dist/skill/references/accounts/currency.md +2 -2
  8. package/dist/skill/references/accounts/open-account-google-ui.md +1 -1
  9. package/dist/skill/references/analytics/account-analytics.md +2 -2
  10. package/dist/skill/references/analytics/keyword-planner-workflows.md +3 -3
  11. package/dist/skill/references/analytics/rag.md +4 -4
  12. package/dist/skill/references/analytics/website-diagnosis-guide.md +1 -1
  13. package/dist/skill/references/core/agent-conventions.md +4 -4
  14. package/dist/skill/references/core/playbooks.md +11 -11
  15. package/dist/skill/references/core/subagent-orchestration.md +5 -5
  16. package/dist/skill/references/core/tips.md +1 -1
  17. package/dist/skill/references/core/workflows.md +25 -25
  18. package/dist/skill/references/google-ads/google-ads-campaign-plan.md +18 -18
  19. package/dist/skill/references/google-ads/google-ads.md +4 -4
  20. package/dist/skill/references/google-ads/rules/README.md +1 -1
  21. package/dist/skill/references/operations/hosted-automation-monitoring-json.md +4 -4
  22. package/dist/skill/references/operations/hosted-automation-optimize-ab-winner.md +2 -2
  23. package/dist/skill/references/operations/hosted-automation-optimize-index.md +5 -5
  24. package/dist/skill/references/operations/hosted-automation-optimize-scale.md +1 -1
  25. package/dist/skill/references/operations/hosted-automation-optimize-weak-downbid.md +5 -5
  26. package/dist/skill/references/operations/hosted-automation-scenarios.md +4 -4
  27. package/dist/skill/references/operations/hosted-automation-self-control.md +7 -7
  28. package/dist/skill/references/operations/hosted-automation-user-catalog.md +12 -12
  29. package/dist/skill/references/report-templates/google-inquiry-analysis.md +2 -2
  30. package/dist/skill/references/report-templates/google-period-report-excel.md +3 -3
  31. package/dist/skill/report-templates/google-inquiry-analysis.md +2 -2
  32. package/dist/skill/report-templates/google-period-report-excel.md +3 -3
  33. package/dist/skill/report-templates/website-diagnosis-report.html +0 -25
  34. package/dist/skill/scripts/install.ps1 +1 -1
  35. package/dist/skill/scripts/install.sh +1 -1
  36. package/package.json +1 -1
package/README.md CHANGED
@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
51
51
  siluzan-tso init --force # 强制覆盖已存在文件
52
52
  ```
53
53
 
54
- > **注意**：当前为测试版（1.1.30-beta.5），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
54
+ > **注意**：当前为测试版（1.1.30-beta.6），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
55
55
 
56
56
  | 助手 | 建议 `--ai` |
57
57
  | ----------------------- | ------------------------------------ |
package/dist/skill/SKILL.md CHANGED
@@ -65,55 +65,55 @@ siluzan-tso -h # 查看帮助
65
65
 
66
66
  | 用户意图（关键词） | 工作流 | 必读文档 |
67
67
  | ------------------ | ------ | -------- |
68
- | 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `accounts/accounts.md`（§ list-accounts 意图速查） |
69
- | 单户实时余额 | W1 | `accounts/accounts.md`（balance） |
70
- | 多账户余额 / 续航不足预警 | **P2** | `accounts/accounts.md`（balance-scan） |
71
- | 单户消耗 / 投放数据 | W1 / **P1** | `accounts/accounts.md`（stats） |
72
- | 多账户消耗/对比汇总 | **P3** | `accounts/accounts.md`（accounts-digest） |
73
- | 激活/充值账单明细 | W1 | `accounts/accounts.md`（account-active-bills） |
74
- | 开户（六大媒体）/ 开户进度 | W2 | `accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `accounts/open-account-google-ui.md`） |
75
- | 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `accounts/accounts.md`（account 子命令） |
76
- | 充值 / 钱包 | W8 | `accounts/finance.md`（recharge 引导网页） |
77
- | 转账记录 / 账户间转账 | W8 | `accounts/finance.md`（transfer） |
78
- | 发票 / 开票 / 发票抬头 | W8 | `accounts/finance.md`（invoice / invoice-info） |
79
- | 审计 / 误操作恢复 | — | `accounts/write-audit-restore.md` |
68
+ | 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `references/accounts/accounts.md`（§ list-accounts 意图速查） |
69
+ | 单户实时余额 | W1 | `references/accounts/accounts.md`（balance） |
70
+ | 多账户余额 / 续航不足预警 | **P2** | `references/accounts/accounts.md`（balance-scan） |
71
+ | 单户消耗 / 投放数据 | W1 / **P1** | `references/accounts/accounts.md`（stats） |
72
+ | 多账户消耗/对比汇总 | **P3** | `references/accounts/accounts.md`（accounts-digest） |
73
+ | 激活/充值账单明细 | W1 | `references/accounts/accounts.md`（account-active-bills） |
74
+ | 开户（六大媒体）/ 开户进度 | W2 | `references/accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `references/accounts/open-account-google-ui.md`） |
75
+ | 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `references/accounts/accounts.md`（account 子命令） |
76
+ | 充值 / 钱包 | W8 | `references/accounts/finance.md`（recharge 引导网页） |
77
+ | 转账记录 / 账户间转账 | W8 | `references/accounts/finance.md`（transfer） |
78
+ | 发票 / 开票 / 发票抬头 | W8 | `references/accounts/finance.md`（invoice / invoice-info） |
79
+ | 审计 / 误操作恢复 | — | `references/accounts/write-audit-restore.md` |
80
80
 
81
81
  ### Google 广告投放
82
82
 
83
83
  | 用户意图（关键词） | 工作流 | 必读文档 |
84
84
  | ------------------ | ------ | -------- |
85
- | 新建搜索系列 / 出投放方案 / **根据官网·网站·URL 生成 Google 搜索广告** / 搜索广告文案·关键词·**表格** / 写搜索广告计划 | **W3** | `google-ads/google-ads-campaign-plan.md` + **`assets/campaign-create-template.json`**（结构真相源，先 Read）+ `assets/campaign-create-template.md`（字段说明）；表格交付读 `google-ads/rules/google-ads-launch-plan-template.md`。**≠ P8 网站诊断 / ≠ P9 市场分析 / ≠ W5 仅拓词** |
86
- | 广告系列/组/广告/关键词 CRUD / 拒审 | W3 | `google-ads/google-ads.md` |
87
- | PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `google-ads/pmax-api.md` |
88
- | AI 智投草稿 list/get/update/publish | W4 | `google-ads/google-ads.md`（§ ad batch） |
89
- | 拓词 / keyword / 关键词规划 | W5 | `analytics/keyword-planner-workflows.md`（客户背景先 `analytics/rag.md`） |
90
- | AI 广告优化记录 / 建议 | W6 | `operations/optimize.md` |
91
- | 优化/合规 SOP | W3 / W6 | `google-ads/rules/README.md` |
85
+ | 新建搜索系列 / 出投放方案 / **根据官网·网站·URL 生成 Google 搜索广告** / 搜索广告文案·关键词·**表格** / 写搜索广告计划 | **W3** | `references/google-ads/google-ads-campaign-plan.md` + **`assets/campaign-create-template.json`**（结构真相源，先 Read）+ `assets/campaign-create-template.md`（字段说明）；表格交付读 `references/google-ads/rules/google-ads-launch-plan-template.md`。**≠ P8 网站诊断 / ≠ P9 市场分析 / ≠ W5 仅拓词** |
86
+ | 广告系列/组/广告/关键词 CRUD / 拒审 | W3 | `references/google-ads/google-ads.md` |
87
+ | PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `references/google-ads/pmax-api.md` |
88
+ | AI 智投草稿 list/get/update/publish | W4 | `references/google-ads/google-ads.md`（§ ad batch） |
89
+ | 拓词 / keyword / 关键词规划 | W5 | `references/analytics/keyword-planner-workflows.md`（客户背景先 `references/analytics/rag.md`） |
90
+ | AI 广告优化记录 / 建议 | W6 | `references/operations/optimize.md` |
91
+ | 优化/合规 SOP | W3 / W6 | `references/google-ads/rules/README.md` |
92
92
 
93
93
  ### 分析与报告（CLI 拉数 + Agent 撰稿）
94
94
 
95
95
  | 用户意图（关键词） | 工作流 | 必读文档 |
96
96
  | ------------------ | ------ | -------- |
97
- | 单账户投放画像 / **Google 广告账户诊断** / 账户健康检查 / 投放诊断报告 / 账户体检（**含账户 ID**） | **P1** | `analytics/account-analytics.md`；完整 HTML 诊断加 `references/report-templates/google-ads-diagnosis.md` |
98
- | Google 账户 **周期** / **月度** / **季度** 报告 / 月报（**非** OKKI / **非** 询盘 / **非** 强调健康诊断） | **P4** | `references/report-templates/google-period-report.md` + `analytics/account-analytics.md`；要 **Excel** 加 `references/report-templates/google-period-report-excel.md` |
99
- | Meta/Facebook 周期或诊断报告 | **P4-FB** | `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` |
100
- | TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `references/report-templates/*-period-report.md` |
101
- | 多账户 × 多维度批处理 | **P5** | `analytics/google-analysis-batch.md` + `analytics/account-analytics.md` |
97
+ | 单账户投放画像 / **Google 广告账户诊断** / 账户健康检查 / 投放诊断报告 / 账户体检（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md`；完整 HTML 诊断加 `references/report-templates/google-ads-diagnosis.md` |
98
+ | Google 账户 **周期** / **月度** / **季度** 报告 / 月报（**非** OKKI / **非** 询盘 / **非** 强调健康诊断） | **P4** | `references/report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；要 **Excel** 加 `references/report-templates/google-period-report-excel.md` |
99
+ | Meta/Facebook 周期或诊断报告 | **P4-FB** | `references/report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md`；要 Excel 加 `references/report-templates/meta-period-report-excel.md` |
100
+ | TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `references/report-templates/*-period-report.md` |
101
+ | 多账户 × 多维度批处理 | **P5** | `references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md` |
102
102
  | OKKI 周报 | **P6** | `references/report-templates/okki-weekly-google-client.md`（全文） |
103
- | Google 询盘分析 | **P7** | `references/report-templates/google-inquiry-analysis.md`（全文）+ `analytics/geo-continents.json` |
104
- | 网站诊断 / **网站诊断·检测·监测报告** / 落地页报告 / 网站质量评分 / 官网体检（**要 URL**） | **P8** | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**必须先** `website-diagnosis collect` + `render`，**默认交付 HTML**；**≠ P9 ≠ W3**） |
105
- | 市场分析 / **行业分析** / **行业分析报告** / 市场调查 / 生成 **XX 行业** 报告（如电商）/ 战略市场报告 / KA 市场报告 | **P9** | `analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**必须先** `market-analysis collect` + `render`，**默认交付 HTML**；**禁止**纯 WebSearch 交 Markdown 终稿；**≠ P8**） |
106
- | TSO 平台优化报告：列表/生成/推送 | W7 | `analytics/reporting.md` |
107
- | RAG 知识库检索 | W5 | `analytics/rag.md` |
103
+ | Google 询盘分析 | **P7** | `references/report-templates/google-inquiry-analysis.md`（全文）+ `references/analytics/geo-continents.json` |
104
+ | 网站诊断 / **网站诊断·检测·监测报告** / 落地页报告 / 网站质量评分 / 官网体检（**要 URL**） | **P8** | `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**必须先** `website-diagnosis collect` + `render`，**默认交付 HTML**；**≠ P9 ≠ W3**） |
105
+ | 市场分析 / **行业分析** / **行业分析报告** / 市场调查 / 生成 **XX 行业** 报告（如电商）/ 战略市场报告 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**必须先** `market-analysis collect` + `render`，**默认交付 HTML**；**禁止**纯 WebSearch 交 Markdown 终稿；**≠ P8**） |
106
+ | TSO 平台优化报告：列表/生成/推送 | W7 | `references/analytics/reporting.md` |
107
+ | RAG 知识库检索 | W5 | `references/analytics/rag.md` |
108
108
 
109
109
  ### 工具与运营
110
110
 
111
111
  | 用户意图（关键词） | 工作流 | 必读文档 |
112
112
  | ------------------ | ------ | -------- |
113
- | 智能预警：创建/查询/启停/触发记录 | W10 | `operations/forewarning.md` |
114
- | TikTok / Meta 线索表单 | W11 | `operations/clue.md` |
115
- | 日/周巡检 | W12 | `core/workflows.md`（W12）+ `accounts/accounts.md` |
116
- | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `operations/hosted-automation-user-catalog.md`（索引）→ `operations/hosted-automation-*.md` |
113
+ | 智能预警：创建/查询/启停/触发记录 | W10 | `references/operations/forewarning.md` |
114
+ | TikTok / Meta 线索表单 | W11 | `references/operations/clue.md` |
115
+ | 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts.md` |
116
+ | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（索引）→ `operations/hosted-automation-*.md` |
117
117
 
118
118
  ---
119
119
 
@@ -132,4 +132,4 @@ siluzan-tso -h # 查看帮助
132
132
  | 金额、ID、字段口径一致 | 触达（钉钉/飞书）与工单 |
133
133
  | references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent 并行 |
134
134
 
135
- 详见 `operations/hosted-automation-self-control.md`、`operations/hosted-automation-monitoring-json.md`、`operations/hosted-automation-optimize-index.md`。
135
+ 详见 `references/operations/hosted-automation-self-control.md`、`references/operations/hosted-automation-monitoring-json.md`、`references/operations/hosted-automation-optimize-index.md`。
package/dist/skill/_meta.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.30-beta.5",
4
- "publishedAt": 1782370125040
3
+ "version": "1.1.30-beta.6",
4
+ "publishedAt": 1782372193290
5
5
  }
package/dist/skill/assets/campaign-create-template.md CHANGED
@@ -37,7 +37,7 @@ JSON 模板：同目录 [`campaign-create-template.json`](campaign-create-templa
37
37
 
38
38
  | 命令 | 支持 `--json-out`？ | 推荐用法 |
39
39
  | -------------------------------- | :-----------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
40
- | `ad campaign-validate` | **是** | **推荐** `--json-out ./snap-campaign`（落盘 `ad-campaign-validate-<account>.json`，含 `lengthViolations`）；。人读：`--config-file` 即可；词面规范化：`--write-normalized`。超长勿自动截断，见 `google-ads/google-ads-campaign-plan.md` § 超长人工确认 |
40
+ | `ad campaign-validate` | **是** | **推荐** `--json-out ./snap-campaign`（落盘 `ad-campaign-validate-<account>.json`，含 `lengthViolations`）；。人读：`--config-file` 即可；词面规范化：`--write-normalized`。超长勿自动截断，见 `references/google-ads/google-ads-campaign-plan.md` § 超长人工确认 |
41
41
  | `ad campaign-create` | **是** | 落盘任务响应：`--json-out ./snap-campaign`； |
42
42
  | `ad batch get` / `ad batch diff` | **是** | 轮询与 diff 结果落盘，见 `references/core/tips.md` |
43
43
 
package/dist/skill/references/README.md CHANGED
@@ -1,66 +1,66 @@
1
1
  # References 索引
2
2
 
3
- > Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `core/playbooks.md`（P1–P9），操作/管理类在 `core/workflows.md`（W1–W12），命令参数在各域 reference。
3
+ > Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `references/core/playbooks.md`（P1–P9），操作/管理类在 `references/core/workflows.md`（W1–W12），命令参数在各域 reference。
4
4
 
5
5
  ## 基础与纪律
6
6
 
7
7
  | 文件 | 用途 |
8
8
  | -------------------------------- | ------------------------------------------------------------------------------------------- |
9
- | `core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |
10
- | `core/agent-conventions.md` | **Agent 必读 · 唯一规则真相源**：加载纪律、数据处理协议、硬规范、时间/币种/批量、交付前自检 |
11
- | `core/intent-routing.md` | **报告 / 分析类统一消歧**：P1–P9 与 W3/W7 同义词、信号优先级、一次追问模板 |
12
- | `core/tips.md` | `--json-out` 脚本食谱（node -e 示例、文件命名、分页） |
13
- | `core/playbooks.md` | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付） |
14
- | `core/workflows.md` | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式） |
15
- | `core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7） |
9
+ | `references/core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |
10
+ | `references/core/agent-conventions.md` | **Agent 必读 · 唯一规则真相源**：加载纪律、数据处理协议、硬规范、时间/币种/批量、交付前自检 |
11
+ | `references/core/intent-routing.md` | **报告 / 分析类统一消歧**：P1–P9 与 W3/W7 同义词、信号优先级、一次追问模板 |
12
+ | `references/core/tips.md` | `--json-out` 脚本食谱（node -e 示例、文件命名、分页） |
13
+ | `references/core/playbooks.md` | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付） |
14
+ | `references/core/workflows.md` | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式） |
15
+ | `references/core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7） |
16
16
 
17
17
  ## 账户与财务
18
18
 
19
19
  | 文件 | 用途 |
20
20
  | ------------------------------------ | ---------------------------------------------------------------- |
21
- | `accounts/accounts.md` | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
22
- | `accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |
23
- | `accounts/open-account-by-media.md` | 各媒体开户命令与参数 |
24
- | `accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |
25
- | `accounts/finance.md` | 转账、开票、充值 |
26
- | `accounts/write-audit-restore.md` | 写审计、`--commit`、restore |
21
+ | `references/accounts/accounts.md` | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
22
+ | `references/accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |
23
+ | `references/accounts/open-account-by-media.md` | 各媒体开户命令与参数 |
24
+ | `references/accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |
25
+ | `references/accounts/finance.md` | 转账、开票、充值 |
26
+ | `references/accounts/write-audit-restore.md` | 写审计、`--commit`、restore |
27
27
 
28
28
  ## Google 广告
29
29
 
30
30
  | 文件 | 用途 |
31
31
  | ---------------------------------------- | ------------------------------------ |
32
- | `google-ads/google-ads.md` | Google Ads CRUD、batch、拒审字段 |
33
- | `google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |
34
- | `google-ads/pmax-api.md` | PMax 网关路径、金额口径 |
35
- | `analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词 |
36
- | `google-ads/rules/README.md` | 优化/合规 SOP 索引 |
32
+ | `references/google-ads/google-ads.md` | Google Ads CRUD、batch、拒审字段 |
33
+ | `references/google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |
34
+ | `references/google-ads/pmax-api.md` | PMax 网关路径、金额口径 |
35
+ | `references/analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词 |
36
+ | `references/google-ads/rules/README.md` | 优化/合规 SOP 索引 |
37
37
 
38
38
  ## 分析与报告
39
39
 
40
40
  | 文件 | 用途 |
41
41
  | -------------------------------------- | ------------------------------------------- |
42
- | `analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |
43
- | `analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent |
44
- | `analytics/market-analysis-guide.md` | 战略市场分析 CLI、Agent 调研流程 |
42
+ | `references/analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |
43
+ | `references/analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent |
44
+ | `references/analytics/market-analysis-guide.md` | 战略市场分析 CLI、Agent 调研流程 |
45
45
  | `assets/market-analysis-rules.md` | 市场分析报告章节与 HTML 版式（Agent 必读） |
46
- | `analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |
47
- | `analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |
48
- | `analytics/reporting.md` | TSO 优化报告生成与推送 |
49
- | `analytics/rag.md` | 知识库 list/query |
50
- | `analytics/geo-continents.json` | 国家→大洲映射（询盘分析） |
46
+ | `references/analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |
47
+ | `references/analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |
48
+ | `references/analytics/reporting.md` | TSO 优化报告生成与推送 |
49
+ | `references/analytics/rag.md` | 知识库 list/query |
50
+ | `references/analytics/geo-continents.json` | 国家→大洲映射（询盘分析） |
51
51
 
52
52
  ## 运营工具
53
53
 
54
54
  | 文件 | 用途 |
55
55
  | ------------------------------------------------- | ---------------------- |
56
- | `operations/optimize.md` | AI 优化建议记录 |
57
- | `operations/forewarning.md` | 智能预警 |
58
- | `operations/clue.md` | TikTok / Meta 线索表单 |
59
- | `operations/hosted-automation-user-catalog.md` | 高阶自动化能力目录 |
60
- | `operations/hosted-automation-self-control.md` | 预算/CPA/空耗自控 SOP |
61
- | `operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名 |
62
- | `operations/hosted-automation-optimize-index.md` | 自动优化 SOP 索引 |
63
- | `operations/hosted-automation-scenarios.md` | 宿主编排场景索引 |
56
+ | `references/operations/optimize.md` | AI 优化建议记录 |
57
+ | `references/operations/forewarning.md` | 智能预警 |
58
+ | `references/operations/clue.md` | TikTok / Meta 线索表单 |
59
+ | `references/operations/hosted-automation-user-catalog.md` | 高阶自动化能力目录 |
60
+ | `references/operations/hosted-automation-self-control.md` | 预算/CPA/空耗自控 SOP |
61
+ | `references/operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名 |
62
+ | `references/operations/hosted-automation-optimize-index.md` | 自动优化 SOP 索引 |
63
+ | `references/operations/hosted-automation-scenarios.md` | 宿主编排场景索引 |
64
64
 
65
65
  ## Assets 模板（`../assets/`）
66
66
 
package/dist/skill/references/accounts/accounts.md CHANGED
@@ -32,7 +32,7 @@ siluzan-tso list-accounts [选项]
32
32
  | 有多少个账户 | 同上 | **`total`**（无需翻页；`itemCount < total` 时说明 page-size 不够大） |
33
33
  | 只查某一个户 | `list-accounts -m <媒体> -k <id或名称> --json-out <dir>` | 无需大 page-size |
34
34
 
35
- 仅当读盘后 `total > itemCount` 且已用 `--page-size 999` 时，再 `--page 2` 等同参数补拉；**禁止**对 stdout 写翻页循环（stdout 摘要无 `total` / `items`，读盘协议见 `core/agent-conventions.md` §三）。列账户 / 数个数**不需要** `accounts-digest`、`balance-scan`。
35
+ 仅当读盘后 `total > itemCount` 且已用 `--page-size 999` 时，再 `--page 2` 等同参数补拉；**禁止**对 stdout 写翻页循环（stdout 摘要无 `total` / `items`，读盘协议见 `references/core/agent-conventions.md` §三）。列账户 / 数个数**不需要** `accounts-digest`、`balance-scan`。
36
36
 
37
37
  ```bash
38
38
  # ✅ 推荐：列出或统计全部 Google 账户（Agent 默认路径）
@@ -66,7 +66,7 @@ siluzan-tso list-accounts -m Google --page 2 --page-size 999 --json-out ./snap-p
66
66
  | ----------------- | --------------------------------------------------------------------------------------------------------------------- |
67
67
  | `entityId` | 丝路赞内部 ID，`delink`/`share`、**`account-active-bills`** 等操作使用此 ID（**不是** `mediaCustomerId`） |
68
68
  | `mediaCustomerId` | 媒体平台账户数字 ID（Google Customer ID 等） |
69
- | `currencyCode` | 账户主币种：`CNY`（人民币）或 `USD`（美金）等；**表格有「币种」列**；报告/Excel 须与此一致，见 `accounts/currency.md` |
69
+ | `currencyCode` | 账户主币种：`CNY`（人民币）或 `USD`（美金）等；**表格有「币种」列**；报告/Excel 须与此一致，见 `references/accounts/currency.md` |
70
70
  | `name` | 账户名称 |
71
71
  | `status` | 账户状态 |
72
72
 
@@ -173,11 +173,11 @@ siluzan-tso accounts-digest -m <媒体类型> [选项]
173
173
 
174
174
  **`--json-out` 落盘**：
175
175
 
176
- - 目录模式典型文件：`accounts-digest-<媒体小写>.json`、同 stem 的 `*.outline.txt`、`cli-manifest-<媒体小写>.json`（读盘协议见 `core/agent-conventions.md` §三）。
176
+ - 目录模式典型文件：`accounts-digest-<媒体小写>.json`、同 stem 的 `*.outline.txt`、`cli-manifest-<媒体小写>.json`（读盘协议见 `references/core/agent-conventions.md` §三）。
177
177
  - 响应结构：`{ ok, data: { items: [...] }, meta: { media, window, scanned, returned, source, totals, currencyNote, generatedAt } }`。
178
178
  - `meta.source`：`list` = 全量翻清单后拉数；`subset` = 传了 `-a`，跳过清单翻页（**`advertiserName` 会缺失**，公司名列显示 `-`）。
179
179
 
180
- **与 `stats` / `balance-scan` 的分工**见 `core/agent-conventions.md` §八 批量任务硬约束。
180
+ **与 `stats` / `balance-scan` 的分工**见 `references/core/agent-conventions.md` §八 批量任务硬约束。
181
181
 
182
182
  **示例：**
183
183
 
package/dist/skill/references/accounts/currency.md CHANGED
@@ -33,10 +33,10 @@
33
33
 
34
34
  1. **`list-accounts`**（推荐第一步）：`items[].ma.currencyCode`；表格有 **「币种」** 列。
35
35
  2. **`balance` / `balance-scan` / `accounts-digest`**：`items[].currencyCode` 或行内已格式化的金额（含代码）。
36
- 3. **`stats`**：`items[].currencyCode`（Google 含今天窗口时可能无币种，见 `accounts/accounts.md` 时效性说明）。
36
+ 3. **`stats`**：`items[].currencyCode`（Google 含今天窗口时可能无币种，见 `references/accounts/accounts.md` 时效性说明）。
37
37
  4. **`google-analysis --sections overview`**：`overview-*.json` 的 `record.currencyCode`（汇总维度，`schemaVersion 3` 起整块在 `record`）。
38
38
  5. **`ad campaigns` / `ad groups`**：JSON 内 `currencyCode`（与账户主币种一致）。
39
- 6. **发票/充值**：`invoice billable` 的 `currencyCode`；人民币订单与美金订单开票类型不同，见 `accounts/finance.md`。
39
+ 6. **发票/充值**：`invoice billable` 的 `currencyCode`；人民币订单与美金订单开票类型不同，见 `references/accounts/finance.md`。
40
40
 
41
41
  **单账户任务**：在 `list-accounts -k <id>` 或 `balance -a <id>` 之后，把解析到的 `currencyCode` 记入报告首行与脚本常量（从 JSON 读取，勿写死 `USD`）。
42
42
 
package/dist/skill/references/accounts/open-account-google-ui.md CHANGED
@@ -84,4 +84,4 @@ siluzan-tso account-history -m Google
84
84
  | `open-account google` | 非交互提交 |
85
85
  | `account-history -m Google` | 审核进度 |
86
86
 
87
- 完整参数见 `accounts/accounts.md` → **open-account**。
87
+ 完整参数见 `references/accounts/accounts.md` → **open-account**。
package/dist/skill/references/analytics/account-analytics.md CHANGED
@@ -34,13 +34,13 @@
34
34
  > 「使用 okki 周报模板」固定话术 → **P6**，不按 `google-period-report.md` 默认 8 维追问。
35
35
  > 用户要 **Google 周期 Excel**（非 OKKI/询盘）→ **P4** + 全文 Read `report-templates/google-period-report-excel.md`（先 outline 后写 xlsx 脚本）。
36
36
 
37
- 拉数落盘：`google-analysis … --json-out <dir>`（Google）或 `report <media>-*` 命令；目录内生成 `<section>-<accountId>.json` + `manifest-<accountId>.json`（Meta/TikTok/Bing 为 `report-manifest-<accountId>.json`）。读盘协议、交付自检与报告首行标注统一见 `core/agent-conventions.md` §三、§七。
37
+ 拉数落盘：`google-analysis … --json-out <dir>`（Google）或 `report <media>-*` 命令；目录内生成 `<section>-<accountId>.json` + `manifest-<accountId>.json`（Meta/TikTok/Bing 为 `report-manifest-<accountId>.json`）。读盘协议、交付自检与报告首行标注统一见 `references/core/agent-conventions.md` §三、§七。
38
38
 
39
39
  ---
40
40
 
41
41
  ## 报告硬约束
42
42
 
43
- 报告中「系列状态列」不得来自账户接口（账户状态 ≠ 系列状态，见 `core/agent-conventions.md` §四）：系列是否启用**必须**来自 `ad campaigns`（含 `statusDisplay`）或 `google-analysis --sections campaigns` 落盘的系列数据。
43
+ 报告中「系列状态列」不得来自账户接口（账户状态 ≠ 系列状态，见 `references/core/agent-conventions.md` §四）：系列是否启用**必须**来自 `ad campaigns`（含 `statusDisplay`）或 `google-analysis --sections campaigns` 落盘的系列数据。
44
44
 
45
45
  ### 金额单位
46
46
 
package/dist/skill/references/analytics/keyword-planner-workflows.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 关键词规划师工作流
2
2
 
3
- > **拓词命令**读本文；**建户 JSON + validate + create** 读 `references/google-ads/google-ads-campaign-plan.md`。关键词数量规则：`google-ads/rules/google-ads-keyword-taxonomy.md`。
3
+ > **拓词命令**读本文；**建户 JSON + validate + create** 读 `references/google-ads/google-ads-campaign-plan.md`。关键词数量规则：`references/google-ads/rules/google-ads-keyword-taxonomy.md`。
4
4
  >
5
5
  > **数据口径**：`siluzan-tso keyword` 默认走 `keywordidea/google`（共享 MCC，出价 **USD**）；传 **`-a <mediaCustomerId>`** 时走 `keywordrecommendation/recommend/{id}/google`，出价币种为 `list-accounts` 的 **`currencyCode`**（如 CNY）。可选 `--url` 叠加 **网址拓词**（`websitereco`）。与 **`google-analysis` 投放表现**不是同一套数据。
6
6
 
@@ -59,7 +59,7 @@
59
59
  | 4 | 账户关键词表现 + 市场侧指标：`google-analysis` keywords → 抽词 → 分批 `keyword` | §3 |
60
60
  | 5 | 搜索词 + 拓词：浪费流量 / 否词线索 | §4 |
61
61
  | 6 | 高商业意图粗筛：CPC、竞争度、搜索量 | §5 |
62
- | 7 | 否词或否词根落地：`ad keyword-negative-create` 等 | §4 + `google-ads/google-ads.md` |
62
+ | 7 | 否词或否词根落地：`ad keyword-negative-create` 等 | §4 + `references/google-ads/google-ads.md` |
63
63
  | 8 | Campaign → AdGroup → JSON：`ad campaign-validate` → `ad campaign-create` | §6 |
64
64
  | 9 | 拓词结果导出：`keyword … --json-out`，供脚本消费 | §7 |
65
65
 
@@ -119,7 +119,7 @@ siluzan-tso keyword -k "pipe" --geo 2840,2826 --json-out ./snap-kw-merged
119
119
  ## 通用执行规范
120
120
 
121
121
  - **一律**对可复用中间结果使用 `--json-out <目录>`（或等价快照参数），再读 `cli-manifest*.json` / 各 section 的 `*.outline.txt` 了解字段；详见 **`references/core/tips.md`**。
122
- - **写账户**（新建系列/加词/加否词）：新建系列走 **`references/google-ads/google-ads-campaign-plan.md`**（含 `campaign-validate`）；其余写操作先与用户确认，写后用成对读命令复核（命令见 `google-ads/google-ads.md`）。
122
+ - **写账户**（新建系列/加词/加否词）：新建系列走 **`references/google-ads/google-ads-campaign-plan.md`**（含 `campaign-validate`）；其余写操作先与用户确认，写后用成对读命令复核（命令见 `references/google-ads/google-ads.md`）。
123
123
 
124
124
  ---
125
125
 
package/dist/skill/references/analytics/rag.md CHANGED
@@ -42,14 +42,14 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
42
42
 
43
43
  | 用户意图 | 建议检索词（示例） | 后续 TSO 命令 |
44
44
  | ------------------------------ | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
45
- | Google 搜索广告方案 / 批量草稿 | 产品卖点、应用行业、目标国家、竞品差异 | `google-ads/google-ads-campaign-plan.md` + `keyword` / `campaign-create`；草稿发布见 `google-ads/google-ads.md` § ad batch |
46
- | 关键字拓词补语境 | 产品型号、英文类目、行业术语、应用场景 | `keyword suggest -k "..."`；编排见 `analytics/keyword-planner-workflows.md` |
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
47
  | 账户诊断 / 周期报告「背景」段 | 公司简介、主营产品、目标市场、认证资质 | `google-analysis` + `report-templates/` 对应模板 |
48
48
  | 询盘分析报告 | 产品线、出口市场、客户画像、大洲业务侧重 | `report-templates/google-inquiry-analysis.md` |
49
- | 开户行业/资质核对 | 营业执照经营范围、行业描述、品牌全称 | `accounts/open-account-by-media.md` 对应媒体开户流 |
49
+ | 开户行业/资质核对 | 营业执照经营范围、行业描述、品牌全称 | `references/accounts/open-account-by-media.md` 对应媒体开户流 |
50
50
  | 优化建议解释 | 产品毛利结构、旺季、转化路径（表单/电话） | `optimize` 记录 + 人工解读；数据仍来自 `google-analysis` |
51
51
 
52
- 检索结果**只作事实参考**：广告标题/描述须符合 `google-ads/rules/google-ads-compliance.md`；数值指标仍以 CLI 拉数为准。
52
+ 检索结果**只作事实参考**：广告标题/描述须符合 `references/google-ads/rules/google-ads-compliance.md`；数值指标仍以 CLI 拉数为准。
53
53
 
54
54
  ---
55
55
 
package/dist/skill/references/analytics/website-diagnosis-guide.md CHANGED
@@ -120,7 +120,7 @@ siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-we
120
120
 
121
121
  ## 优化策略中的复用
122
122
 
123
- `tso_agent` 的 `getOptimizationStrategy` 在 `device_2` 等维度会调用**同一** `WebsiteDiagnosisReports/performance`（需 Google 账户 `final-urls`）。与单次网站诊断独立；见 `operations/optimize.md` 与 Google 账户优化策略话术。
123
+ `tso_agent` 的 `getOptimizationStrategy` 在 `device_2` 等维度会调用**同一** `WebsiteDiagnosisReports/performance`（需 Google 账户 `final-urls`）。与单次网站诊断独立；见 `references/operations/optimize.md` 与 Google 账户优化策略话术。
124
124
 
125
125
  ---
126
126
 
package/dist/skill/references/core/agent-conventions.md CHANGED
@@ -32,7 +32,7 @@
32
32
  | 契约说明 / 规则 | `assets/<文件>.md` | 与上表 JSON **成对** Read；如 `assets/campaign-create-template.md` |
33
33
  | HTML 终稿模板 | `report-templates/*.html` | 由 CLI `render` 使用，Agent 通常只 Read 对应 `.md` 纲要 |
34
34
 
35
- 路由表若写 `analytics/…` 或 `report-templates/…` 而无 `references/` 前缀，**Read 时仍须加上 `references/`**（`assets/`、`report-templates/*.html` 除外）。
35
+ 所有文档里的「必读文档」路径**一律相对 Skill 根目录、且已写全前缀**：域文档为 `references/<域>/<文件>.md`，报告纲要为 `references/report-templates/<文件>.md`，JSON 契约为 `assets/<文件>.json`，HTML 终稿模板为 `report-templates/*.html`。**按字面路径直接 Read 即可，无需自行增删前缀**；若仍 File not found，回到 `references/README.md` 核对真实路径。
36
36
 
37
37
  ---
38
38
 
@@ -77,7 +77,7 @@
77
77
  | 允许 Read 的文件 | 必须用代码读取的文件 |
78
78
  | -------------------------------------------------------------------------------- | ------------------------------------------ |
79
79
  | `references/**/*.md`、`assets/**/*.md`（Skill 文档） | 所有 `--json-out` 落盘业务 `*.json`（常为 MB 级） |
80
- | `assets/*-template.json`、`assets/*.schema.json`、`analytics/geo-continents.json` 等**小体积契约/映射** | manifest 中的路径索引（脚本 `JSON.parse`） |
80
+ | `assets/*-template.json`、`assets/*.schema.json`、`references/analytics/geo-continents.json` 等**小体积契约/映射** | manifest 中的路径索引（脚本 `JSON.parse`） |
81
81
  | 当次 `*.outline.txt` | 用户提供的同构大 JSON |
82
82
  | stdout 一行摘要、你刚写出的最终产物文件 | — |
83
83
 
@@ -93,7 +93,7 @@
93
93
  | `keywordText` | `keyword` |
94
94
  | `query` | `searchTermText` |
95
95
 
96
- 国家名、ID、金额、词表等**业务值**禁止写成源码字面量；映射表/模板契约运行时加载（`analytics/geo-continents.json`、`campaign-create-template.json`）。允许的字面量：输出目录、Sheet/列标题、技术格式、用户当轮明确给出的配置（建议落盘 `config.json` 再脚本读）。
96
+ 国家名、ID、金额、词表等**业务值**禁止写成源码字面量；映射表/模板契约运行时加载（`references/analytics/geo-continents.json`、`campaign-create-template.json`）。允许的字面量：输出目录、Sheet/列标题、技术格式、用户当轮明确给出的配置（建议落盘 `config.json` 再脚本读）。
97
97
 
98
98
  **报告/Excel 全流程走本 Skill**：按工作流卡片与 `report-templates/*.md` 拉数、落盘、脚本转换；**禁止**加载宿主第三方 xlsx/Excel Skill 代劳（不知 TSO 字段口径与账户核验）。
99
99
 
@@ -134,7 +134,7 @@
134
134
 
135
135
  **例外**（不反问）：
136
136
 
137
- - `list-accounts` 列全部 / 数个数：一次 `list-accounts -m <媒体> --page-size 999 --json-out <dir>`，脚本读落盘 `total` / `items[]`；**禁止**默认 page-size 20 再翻页（详见 `accounts/accounts.md` § Agent 意图速查）。
137
+ - `list-accounts` 列全部 / 数个数：一次 `list-accounts -m <媒体> --page-size 999 --json-out <dir>`，脚本读落盘 `total` / `items[]`；**禁止**默认 page-size 20 再翻页（详见 `references/accounts/accounts.md` § Agent 意图速查）。
138
138
  - 「昨天」单日 stats：默认 `Asia/Shanghai` 日历日；先 `list-accounts` 再 `stats`。
139
139
  - `forewarning records`、`invoice list`「本月」、TikTok `clue`「最近一周」：见对应 references。
140
140
 
package/dist/skill/references/core/playbooks.md CHANGED
@@ -24,7 +24,7 @@
24
24
  ## P1 · 单账户投放画像
25
25
 
26
26
  - **触发**：对单个 Google 账户做投放画像/诊断/健康检查。
27
- - **必读**：`analytics/account-analytics.md`；诊断报告加 `references/report-templates/google-ads-diagnosis.md` + `references/report-templates/google-account-diagnosis-report.md`。
27
+ - **必读**：`references/analytics/account-analytics.md`；诊断报告加 `references/report-templates/google-ads-diagnosis.md` + `references/report-templates/google-account-diagnosis-report.md`。
28
28
  - **步骤**：
29
29
  1. 确认统计区间（规则见 conventions §五）。
30
30
  2. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-p1`（取 `currencyCode`）。
@@ -40,7 +40,7 @@
40
40
  ## P2 · 多账户余额扫描
41
41
 
42
42
  - **触发**：多账户余额续航不足、充值预警、僵尸账户巡检。
43
- - **必读**：`accounts/accounts.md`（§ balance-scan）。
43
+ - **必读**：`references/accounts/accounts.md`（§ balance-scan）。
44
44
  - **步骤**：
45
45
  1. 全量巡检：`balance-scan -m <媒体> --threshold-days 7 --json-out ./snap-p2`（可选 `--min-balance 100` / `--target-days 60`）。
46
46
  2. 已知子集：`balance-scan -m <媒体> -a id1,id2,id3 --json-out ./snap-p2-subset`（跳过翻页）。
@@ -51,7 +51,7 @@
51
51
  ## P3 · 多账户投放画像汇总
52
52
 
53
53
  - **触发**：多账户消耗/点击/转化/CTR/CPC/CPA 汇总对比表、跨账户巡检。
54
- - **必读**：`accounts/accounts.md`（§ accounts-digest）。
54
+ - **必读**：`references/accounts/accounts.md`（§ accounts-digest）。
55
55
  - **步骤**：
56
56
  1. 确认时间范围后执行 `accounts-digest -m <媒体> -a id1,id2,... --start <S> --end <D> --json-out ./snap-p3`（全量则省略 `-a`）。
57
57
  2. 基于落盘 `data.items` 与 `meta.totals` 生成报告，**不要**再逐账户 `stats`。
@@ -62,7 +62,7 @@
62
62
  ## P4 · Google 账户周期报告
63
63
 
64
64
  - **触发**：Google 账户某区间的周期/月度/季度汇总报告；或用户列出 Sheet/章节要 **Excel**（非 OKKI / 询盘）。
65
- - **必读**：`references/report-templates/google-period-report.md` + `analytics/account-analytics.md`；**要 Excel** 加 `references/report-templates/google-period-report-excel.md`（全文）。
65
+ - **必读**：`references/report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；**要 Excel** 加 `references/report-templates/google-period-report-excel.md`（全文）。
66
66
  - **步骤**：
67
67
  1. **账户核验**：`list-accounts -m Google -k <mediaCustomerId> --json-out <dir>`；无记录则停止并告知用户。
68
68
  2. 确认时间范围；区间 > 3 个月时分段（季度/月）。
@@ -79,7 +79,7 @@
79
79
  ## P4-FB · Meta/Facebook 账户周期报告
80
80
 
81
81
  - **触发**：Meta/Facebook 账户周期/月报/周报或诊断报告。
82
- - **必读**：`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`。
82
+ - **必读**：`references/report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md`（内容丰富度必读）+ `references/analytics/facebook-analysis-guide.md`；要 Excel 加 `references/report-templates/meta-period-report-excel.md`。
83
83
  - **默认交付**：**HTML**（`facebook-analysis render`）；用户明确要 Excel 时 Agent 脚本写 xlsx（步骤 1–3 不变，不调 `render`）。
84
84
  - **步骤**：
85
85
  1. `list-accounts -m MetaAd -k <mediaCustomerId> --json-out ./snap-fb` 确认账户与 `currencyCode`。
@@ -95,7 +95,7 @@
95
95
  ## P5 · 多账户多维度批处理
96
96
 
97
97
  - **触发**：账户数 ≥ 2 且需拉取 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop。
98
- - **必读**：`analytics/google-analysis-batch.md` + `analytics/account-analytics.md`；可选 `core/subagent-orchestration.md`。
98
+ - **必读**：`references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md`；可选 `references/core/subagent-orchestration.md`。
99
99
  - **入口选择**：全量 → 省略 `-a`；2~10 子集 → `google-analysis -a id1,id2,...`；≥10 子集或需 resume → `google-analysis-batch run -a id1,id2,...`。
100
100
  - **步骤**：
101
101
  1. （可选）Read `subagent-orchestration.md` § P5 决定执行模式。
@@ -108,7 +108,7 @@
108
108
  --min-spend 1 --keyword-limit 1000 --json-out ./snap-p5
109
109
  ```
110
110
  4. **中断只能 resume**：`google-analysis-batch resume --json-out ./snap-p5 --run-id <runId>`；只读进度用 `status`。
111
- 5. **outline 门禁（消费产物前）**：每个维度 Read 其一份 `results/<accountId>/<section>-<accountId>.outline.txt`（同维度多账户同结构，读其一即可代表该维度；一批并行把所有维度 outline 读全）确认字段树后再写聚合脚本，**禁止**凭模板字段名直接写（详见 conventions §三 outline 门禁 + `analytics/google-analysis-batch.md` §产物消费）。
111
+ 5. **outline 门禁（消费产物前）**：每个维度 Read 其一份 `results/<accountId>/<section>-<accountId>.outline.txt`（同维度多账户同结构，读其一即可代表该维度；一批并行把所有维度 outline 读全）确认字段树后再写聚合脚本，**禁止**凭模板字段名直接写（详见 conventions §三 outline 门禁 + `references/analytics/google-analysis-batch.md` §产物消费）。
112
112
  - **交付/确认**：**禁止**重新 `run` 续跑；401 → 整批终止，重登录后 `resume`。
113
113
 
114
114
  ---
@@ -116,7 +116,7 @@
116
116
  ## P6 · OKKI 周报
117
117
 
118
118
  - **触发**：话术含 `使用 okki 周报模板` / `OKKI 周报` / `okki 周报`，且指向 Google 账户 + 日期区间。
119
- - **必读**：`references/report-templates/okki-weekly-google-client.md`（**全文**）+ `analytics/account-analytics.md`；可选 `core/subagent-orchestration.md`。
119
+ - **必读**：`references/report-templates/okki-weekly-google-client.md`（**全文**）+ `references/analytics/account-analytics.md`；可选 `references/core/subagent-orchestration.md`。
120
120
  - **步骤**：
121
121
  1. （可选）Read `subagent-orchestration.md` § P6 决定是否分阶段委派。
122
122
  2. 确认 `mediaCustomerId` 与 `--start` / `--end`。
@@ -129,7 +129,7 @@
129
129
  ## P7 · Google 账户询盘分析
130
130
 
131
131
  - **触发**：话术含 `Google 账户询盘分析` / `分析 XXX Google 账号的询盘效果`，或同时含「询盘 + 账户 + Google」。
132
- - **必读**：`references/report-templates/google-inquiry-analysis.md`（**全文**）+ `analytics/account-analytics.md` + `analytics/geo-continents.json`；可选 `core/subagent-orchestration.md`。
132
+ - **必读**：`references/report-templates/google-inquiry-analysis.md`（**全文**）+ `references/analytics/account-analytics.md` + `references/analytics/geo-continents.json`；可选 `references/core/subagent-orchestration.md`。
133
133
  - **时间窗口强约束**：**严格 3 个月** = 分析月份 + 向前 2 个完整自然月，**禁止**扩展到 7 个月。
134
134
  - **步骤**：
135
135
  1. （可选）Read `subagent-orchestration.md` § P7。
@@ -143,7 +143,7 @@
143
143
  ## P8 · 网站诊断
144
144
 
145
145
  - **触发**：对某 URL 做网站/落地页诊断、投放前网站评分；话术含「网站诊断/检测/监测/质量**报告**」「落地页报告」「官网体检」（**非** Google 账户诊断、**非** 行业报告）。同义词见 `intent-routing.md` §二 P8。
146
- - **必读**：`analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `references/report-templates/website-diagnosis-report.md`。
146
+ - **必读**：`references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `references/report-templates/website-diagnosis-report.md`。
147
147
  - **默认交付**：**HTML**（`website-diagnosis render`）；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。
148
148
  - **步骤**：
149
149
  1. 确认完整 URL（`https://` 可省略，CLI 自动补全）。
@@ -158,7 +158,7 @@
158
158
 
159
159
  - **触发**：话术含「市场分析」「**行业分析**」「**行业分析报告**」「生成/写一份 **XX 行业** 报告」（如「电商行业」「制造业」）、「战略市场报告」「KA 市场报告」，或对某客户/行业做竞品/GTM 战略分析（**非** `google-analysis`、**非** 网站诊断、**非** 账户周期 P4）。
160
160
  - **典型误路由**：用户只说「帮我生成一份电商行业的行业分析报告」→ **仍是 P9**；须 `market-analysis collect --industry "电商" --json-out …`，**禁止**跳过 CLI 直接 WebSearch 写 Markdown。
161
- - **必读**：`analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（原始业务维度清单）+ `references/report-templates/market-analysis-report.md`。
161
+ - **必读**：`references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（原始业务维度清单）+ `references/report-templates/market-analysis-report.md`。
162
162
  - **默认交付**：**HTML**（`market-analysis render`）。
163
163
  - **步骤**：
164
164
  1. 确认客户信息（客户名称/网站/行业/核心产品至少一项）；`targetMarket` 默认「全球」、`timeRange` 默认「近12个月」（未给须写明）。
package/dist/skill/references/core/subagent-orchestration.md CHANGED
@@ -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
- | 读 `google-ads/rules/*` 全文做方案 | **委派** | **Explore** + `readonly` | 主会话 Read 全文进上下文 |
45
+ | 读 `references/google-ads/rules/*` 全文做方案 | **委派** | **Explore** + `readonly` | 主会话 Read 全文进上下文 |
46
46
  | 用户仅闲聊 / 解释字段口径 | **主会话** | — | — |
47
47
 
48
48
  ---
@@ -102,16 +102,16 @@ summary: <1-3 句中文，无业务数字除非来自 manifest>
102
102
 
103
103
  ### P6 · OKKI 周报
104
104
 
105
- **必读**：`report-templates/okki-weekly-google-client.md`、`core/playbooks.md` P6。
105
+ **必读**：`report-templates/okki-weekly-google-client.md`、`references/core/playbooks.md` P6。
106
106
 
107
107
  1. 主 Agent：确认账户与日期区间。
108
108
  2. **决策**：拉数阶段若日志长 → Bash/Task + `handoff-p6-okki.md` §拉数；否则主会话执行模板 §拉数命令。
109
- 3. **决策**：写 xlsx 阶段 → Task handoff（只读 `snapDir`，先 outline 后 JSON，见 `core/tips.md`）；或主会话若上下文充足。
109
+ 3. **决策**：写 xlsx 阶段 → Task handoff（只读 `snapDir`，先 outline 后 JSON，见 `references/core/tips.md`）；或主会话若上下文充足。
110
110
  4. 主 Agent：合并交付话术 + 文件路径；金额与 ID 与 manifest 一致。
111
111
 
112
112
  ### P5 · 多账户多维度
113
113
 
114
- **必读**：`analytics/google-analysis-batch.md`、`core/playbooks.md` P5。
114
+ **必读**：`references/analytics/google-analysis-batch.md`、`references/core/playbooks.md` P5。
115
115
 
116
116
  1. 主 Agent：确认区间与 `--sections`。
117
117
  2. **batch 本身**：主会话或**单次** Bash 执行 `google-analysis-batch run`（全量省略 `-a`）或 `resume` — **禁止** per-account 子会话调 API。
@@ -121,7 +121,7 @@ summary: <1-3 句中文，无业务数字除非来自 manifest>
121
121
 
122
122
  ### P7 · Google 询盘分析
123
123
 
124
- **必读**：`report-templates/google-inquiry-analysis.md`、`core/playbooks.md` P7。
124
+ **必读**：`report-templates/google-inquiry-analysis.md`、`references/core/playbooks.md` P7。
125
125
 
126
126
  1. 主 Agent：询盘资料落盘或流程 B 反问。
127
127
  2. **决策**：主 snap 拉数 + **并行** 3× Task 跑 `m1`/`m2`/`m3`（`handoff-p7-inquiry.md`），或主会话顺序执行若客户端不支持并行。
package/dist/skill/references/core/tips.md CHANGED
@@ -287,7 +287,7 @@ console.log('可用字段：', first && Object.keys(first));
287
287
  ## 通用分页与查询建议
288
288
 
289
289
  - 绝大多数列表类命令默认每页 20 条记录，数据量较大时须显式指定 `--page-size`。
290
- - **`list-accounts` 列全部 / 数个数**：优先 **`--page-size 999` 一次拉取** + `--json-out` + 脚本读盘（见 `accounts/accounts.md` § Agent 意图速查）；**不要**先试默认 20 再翻页。
290
+ - **`list-accounts` 列全部 / 数个数**：优先 **`--page-size 999` 一次拉取** + `--json-out` + 脚本读盘（见 `references/accounts/accounts.md` § Agent 意图速查）；**不要**先试默认 20 再翻页。
291
291
  - 其他列表命令（报告列表、发票列表等）在单页拉不满时，再用 `--page-size`（如 `100`）与 `--page` 组合翻页；读盘确认 `total > itemCount` 后再补下一页。
292
292
 
293
293
  ---