siluzan-tso-cli 1.1.30-beta.4 → 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 (45) hide show
  1. package/README.md +1 -1
  2. package/dist/skill/SKILL.md +39 -42
  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 -34
  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 +5 -4
  14. package/dist/skill/references/core/intent-routing.md +135 -0
  15. package/dist/skill/references/core/playbooks.md +14 -12
  16. package/dist/skill/references/core/subagent-orchestration.md +5 -5
  17. package/dist/skill/references/core/tips.md +1 -1
  18. package/dist/skill/references/core/workflows.md +25 -25
  19. package/dist/skill/references/google-ads/google-ads-campaign-plan.md +18 -18
  20. package/dist/skill/references/google-ads/google-ads.md +4 -4
  21. package/dist/skill/references/google-ads/rules/README.md +1 -1
  22. package/dist/skill/references/operations/hosted-automation-monitoring-json.md +4 -4
  23. package/dist/skill/references/operations/hosted-automation-optimize-ab-winner.md +2 -2
  24. package/dist/skill/references/operations/hosted-automation-optimize-index.md +5 -5
  25. package/dist/skill/references/operations/hosted-automation-optimize-scale.md +1 -1
  26. package/dist/skill/references/operations/hosted-automation-optimize-weak-downbid.md +5 -5
  27. package/dist/skill/references/operations/hosted-automation-scenarios.md +4 -4
  28. package/dist/skill/references/operations/hosted-automation-self-control.md +7 -7
  29. package/dist/skill/references/operations/hosted-automation-user-catalog.md +12 -12
  30. package/dist/skill/references/report-templates/README.md +1 -1
  31. package/dist/skill/references/report-templates/google-inquiry-analysis.md +2 -2
  32. package/dist/skill/references/report-templates/google-period-report-excel.md +3 -3
  33. package/dist/skill/report-templates/google-inquiry-analysis.md +2 -2
  34. package/dist/skill/report-templates/google-period-report-excel.md +3 -3
  35. package/dist/skill/report-templates/website-diagnosis-report.html +0 -25
  36. package/dist/skill/scripts/install.ps1 +1 -1
  37. package/dist/skill/scripts/install.sh +1 -1
  38. package/eval/cases/ir-p1-vs-p8-account-vs-url.scenario.json +32 -0
  39. package/eval/cases/ir-p4-period-not-diagnosis.scenario.json +26 -0
  40. package/eval/cases/ir-p8-website-monitor-report-with-url.scenario.json +39 -0
  41. package/eval/cases/ir-p8-website-test-report-no-url.scenario.json +20 -0
  42. package/eval/cases/ir-p9-industry-not-p8.scenario.json +29 -0
  43. package/eval/cases/ir-vague-report-clarify.scenario.json +20 -0
  44. package/eval/cases/ir-w3-vs-p8-from-website.scenario.json +18 -0
  45. 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.4），供内部测试使用。正式发布后安装命令将改为 `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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: siluzan-tso
3
- description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及以下业务必须先加载本 skill：网站诊断/网站诊断报告/落地页评分、市场分析/市场调查报告/行业分析/行业分析报告/生成行业报告/战略市场报告/电商等行业报告（须 siluzan-tso market-analysis）、Google 广告计划/投放方案/根据官网·网站·URL 生成搜索广告方案或关键词文案表/PMax 创建/系列组广告关键词 CRUD、广告账户列表/余额/消耗/开户/MCC/BC/BM、账户画像/广告诊断/周期报告/OKKI 周报/询盘分析、关键词拓词/RAG/智能预警/线索/转账发票、丝路赞/TSO、投广告、出价预算、报告诊断、开票等广告账户管理。
3
+ description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理须加载本 skill。【报告/诊断消歧】用户说报告/诊断/分析/检测/监测/月报时禁止默认某一 CLI——先识别对象：URL→P8 website-diagnosis（网站诊断·检测·监测/落地页报告）；行业/市场/战略→P9 market-analysis；Google账户ID+健康诊断→P1 google-ads-diagnosis；账户ID+周期/月度→P4；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+搜索广告方案/关键词表→W3；平台优化报告列表/推送→W7；对象不清→Read references/core/intent-routing.md。【账户】列表/余额/消耗/激活账单（W1）、多账户余额预警 balance-scan（P2）、多户消耗汇总 accounts-digest（P3）、六大媒体开户与进度（W2）、分享/解绑/MCC/BC/BM/权限（W9）。【投放】Google搜索系列方案与 campaign-validate/create（W3）、系列/组/广告/关键词 CRUD/拒审、PMax 创建与素材、AI智投草稿 batch（W4）、拓词 keyword suggest（W5）、AI广告优化 optimize（W6）、优化合规 SOP。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。
4
4
  license: MIT
5
5
  compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
6
6
  metadata:
@@ -22,11 +22,9 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
22
22
 
23
23
  > **Agent 纪律（每个新任务必读）**：先 Read `references/core/agent-conventions.md`（唯一规则真相源：加载纪律、数据处理协议、时间/币种、批量约束、交付前自检），再按下方路由表 Read「必读文档」与对应工作流卡片。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（脚本示例见 `references/core/tips.md`）。
24
24
  >
25
- > **默认交付格式**：用户未指定格式时，网站诊断 P8、Meta 周期 P4-FB、战略市场 P9、**Google 广告诊断 P1** 默认 **HTML**（各自 `render` 子命令），Google 周期 P4 默认 HTML；**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
26
- >
27
- > **意图消歧（Google 搜索广告方案）**：用户说「根据官网/网站/URL 生成 Google **搜索**广告」「出搜索广告方案/计划/文案/关键词表」「要表格格式」→ **一律走 W3**（`google-ads/google-ads-campaign-plan.md`），**不是** P8 网站诊断、**不是** P9 市场分析、**不是** W5 仅拓词。**禁止**跳过 JSON + `campaign-validate` 门禁，直接凭官网内容手写一张创意/关键词表。**「表格格式」** = 按 `google-ads/rules/google-ads-launch-plan-template.md` 从已 validate 的 JSON **投影** Markdown 表格（先 JSON 代码块 → 再表格正文 → 待确认）；缺预算/地域/账户等必填项时先追问，再进入标准流水线。
25
+ > **报告 / 分析类统一消歧（必读）**：用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 月报 / 周报」等，或对象不清（只有「帮我出份报告」）→ **必须先 Read `references/core/intent-routing.md`**，按 §一 三步协议定 **唯一** 工作流后再执行 CLI。**禁止**见「报告」就默认 P4 周期或 P1 诊断。
28
26
  >
29
- > **意图消歧（行业 / 战略市场分析报告）**：用户说「**行业分析**」「**行业分析报告**」「市场分析/调查报告」「战略市场报告」「生成/写一份 **XX 行业** 报告」（如「电商行业」「制造业」）→ **一律走 P9**（`analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`）。**第一步必须**执行 `siluzan-tso market-analysis collect … --json-out`（仅给行业时可 `--industry "电商"` 等），调研后 `market-analysis render` 交付 **HTML**。**禁止**不调用 CLI、仅用 WebSearch 在对话里写 Markdown/长文当终稿；**不是** `google-analysis` 账户数据报告、**不是** P8 网站诊断、**不是** W5 拓词。
27
+ > **默认交付格式**：用户未指定格式时，网站诊断 P8、Meta 周期 P4-FB、战略市场 P9、**Google 广告诊断 P1** 默认 **HTML**（各自 `render` 子命令），Google 周期 P4 默认 HTML；**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
30
28
 
31
29
  ---
32
30
 
@@ -55,68 +53,67 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
55
53
  siluzan-tso -h # 查看帮助
56
54
  ```
57
55
 
58
- **Agent 三步法**：① 在下方路由表按用户意图找到对应行 → ② Read 该行「必读文档」与对应工作流卡片 → ③ 按卡片**编号步骤**逐步执行，写操作前先与用户确认。
56
+ **Agent 三步法**：① 报告/分析类若话术模糊，先 Read `references/core/intent-routing.md` → ② 在下方路由表锁定**唯一**工作流行 → ③ Read 该行「必读文档」与工作流卡片 → ④ 按卡片**编号步骤**执行，写操作前先与用户确认。
59
57
 
60
58
  ---
61
59
 
62
60
  ## 路由表（意图 → 工作流 → 必读文档）
63
61
 
64
- > 首次进入任意任务前先 Read `references/core/agent-conventions.md`。下表每行指向**唯一**工作流；找不到时查 `references/README.md`。
62
+ > 首次进入任意任务前先 Read `references/core/agent-conventions.md`。**用户只说「报告 / 诊断 / 分析 / 检测 / 监测」且对象不清** → 必须先 Read `references/core/intent-routing.md`（P1–P9 与 W3/W7 统一消歧）。下表每行指向**唯一**工作流；找不到时查 `references/README.md`。
65
63
 
66
64
  ### 账户与财务
67
65
 
68
66
  | 用户意图（关键词） | 工作流 | 必读文档 |
69
67
  | ------------------ | ------ | -------- |
70
- | 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `accounts/accounts.md`（§ list-accounts 意图速查） |
71
- | 单户实时余额 | W1 | `accounts/accounts.md`（balance） |
72
- | 多账户余额 / 续航不足预警 | **P2** | `accounts/accounts.md`（balance-scan） |
73
- | 单户消耗 / 投放数据 | W1 / **P1** | `accounts/accounts.md`（stats） |
74
- | 多账户消耗/对比汇总 | **P3** | `accounts/accounts.md`（accounts-digest） |
75
- | 激活/充值账单明细 | W1 | `accounts/accounts.md`（account-active-bills） |
76
- | 开户（六大媒体）/ 开户进度 | W2 | `accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `accounts/open-account-google-ui.md`） |
77
- | 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `accounts/accounts.md`（account 子命令） |
78
- | 充值 / 钱包 | W8 | `accounts/finance.md`（recharge 引导网页） |
79
- | 转账记录 / 账户间转账 | W8 | `accounts/finance.md`（transfer） |
80
- | 发票 / 开票 / 发票抬头 | W8 | `accounts/finance.md`（invoice / invoice-info） |
81
- | 审计 / 误操作恢复 | — | `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` |
82
80
 
83
81
  ### Google 广告投放
84
82
 
85
83
  | 用户意图（关键词） | 工作流 | 必读文档 |
86
84
  | ------------------ | ------ | -------- |
87
- | 新建搜索系列 / 出投放方案 / **根据官网·网站·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 仅拓词** |
88
- | 广告系列/组/广告/关键词 CRUD / 拒审 | W3 | `google-ads/google-ads.md` |
89
- | PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `google-ads/pmax-api.md` |
90
- | AI 智投草稿 list/get/update/publish | W4 | `google-ads/google-ads.md`（§ ad batch） |
91
- | 拓词 / keyword / 关键词规划 | W5 | `analytics/keyword-planner-workflows.md`（客户背景先 `analytics/rag.md`） |
92
- | AI 广告优化记录 / 建议 | W6 | `operations/optimize.md` |
93
- | 优化/合规 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` |
94
92
 
95
93
  ### 分析与报告（CLI 拉数 + Agent 撰稿）
96
94
 
97
95
  | 用户意图（关键词） | 工作流 | 必读文档 |
98
96
  | ------------------ | ------ | -------- |
99
- | 单账户投放画像 / 诊断 | **P1** | `analytics/account-analytics.md` |
100
- | Google 账户周期报告 | **P4** | `references/report-templates/google-period-report.md` + `analytics/account-analytics.md`；要 **Excel** 加 `references/report-templates/google-period-report-excel.md` |
101
- | 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` |
102
- | TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `references/report-templates/*-period-report.md` |
103
- | 多账户 × 多维度批处理 | **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` |
104
102
  | OKKI 周报 | **P6** | `references/report-templates/okki-weekly-google-client.md`（全文） |
105
- | Google 询盘分析 | **P7** | `references/report-templates/google-inquiry-analysis.md`（全文）+ `analytics/geo-continents.json` |
106
- | 网站诊断 / 落地页评分 | **P8** | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**默认交付 HTML**） |
107
- | 市场分析 / **行业分析** / **行业分析报告** / 生成 **XX 行业** 报告（如电商）/ 战略市场报告 / KA 市场报告 | **P9** | `analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**必须先** `market-analysis collect` + `render`，**默认交付 HTML**；**禁止**纯 WebSearch 交 Markdown 终稿） |
108
- | Google 广告诊断 / 账户健康检查 | **P1** | `references/report-templates/google-ads-diagnosis.md` + `google-account-diagnosis-report.md`（**必须先** `google-ads-diagnosis render` 交付 HTML） |
109
- | TSO 平台优化报告：列表/生成/推送 | W7 | `analytics/reporting.md` |
110
- | 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` |
111
108
 
112
109
  ### 工具与运营
113
110
 
114
111
  | 用户意图（关键词） | 工作流 | 必读文档 |
115
112
  | ------------------ | ------ | -------- |
116
- | 智能预警：创建/查询/启停/触发记录 | W10 | `operations/forewarning.md` |
117
- | TikTok / Meta 线索表单 | W11 | `operations/clue.md` |
118
- | 日/周巡检 | W12 | `core/workflows.md`（W12）+ `accounts/accounts.md` |
119
- | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `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` |
120
117
 
121
118
  ---
122
119
 
@@ -135,4 +132,4 @@ siluzan-tso -h # 查看帮助
135
132
  | 金额、ID、字段口径一致 | 触达（钉钉/飞书）与工单 |
136
133
  | references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent 并行 |
137
134
 
138
- 详见 `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.4",
4
- "publishedAt": 1782368830612
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,65 +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/tips.md` | `--json-out` 脚本食谱（node -e 示例、文件命名、分页） |
12
- | `core/playbooks.md` | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付） |
13
- | `core/workflows.md` | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式） |
14
- | `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） |
15
16
 
16
17
  ## 账户与财务
17
18
 
18
19
  | 文件 | 用途 |
19
20
  | ------------------------------------ | ---------------------------------------------------------------- |
20
- | `accounts/accounts.md` | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
21
- | `accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |
22
- | `accounts/open-account-by-media.md` | 各媒体开户命令与参数 |
23
- | `accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |
24
- | `accounts/finance.md` | 转账、开票、充值 |
25
- | `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 |
26
27
 
27
28
  ## Google 广告
28
29
 
29
30
  | 文件 | 用途 |
30
31
  | ---------------------------------------- | ------------------------------------ |
31
- | `google-ads/google-ads.md` | Google Ads CRUD、batch、拒审字段 |
32
- | `google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |
33
- | `google-ads/pmax-api.md` | PMax 网关路径、金额口径 |
34
- | `analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词 |
35
- | `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 索引 |
36
37
 
37
38
  ## 分析与报告
38
39
 
39
40
  | 文件 | 用途 |
40
41
  | -------------------------------------- | ------------------------------------------- |
41
- | `analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |
42
- | `analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent |
43
- | `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 调研流程 |
44
45
  | `assets/market-analysis-rules.md` | 市场分析报告章节与 HTML 版式（Agent 必读） |
45
- | `analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |
46
- | `analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |
47
- | `analytics/reporting.md` | TSO 优化报告生成与推送 |
48
- | `analytics/rag.md` | 知识库 list/query |
49
- | `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` | 国家→大洲映射（询盘分析） |
50
51
 
51
52
  ## 运营工具
52
53
 
53
54
  | 文件 | 用途 |
54
55
  | ------------------------------------------------- | ---------------------- |
55
- | `operations/optimize.md` | AI 优化建议记录 |
56
- | `operations/forewarning.md` | 智能预警 |
57
- | `operations/clue.md` | TikTok / Meta 线索表单 |
58
- | `operations/hosted-automation-user-catalog.md` | 高阶自动化能力目录 |
59
- | `operations/hosted-automation-self-control.md` | 预算/CPA/空耗自控 SOP |
60
- | `operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名 |
61
- | `operations/hosted-automation-optimize-index.md` | 自动优化 SOP 索引 |
62
- | `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` | 宿主编排场景索引 |
63
64
 
64
65
  ## Assets 模板（`../assets/`）
65
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
@@ -14,6 +14,7 @@
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
18
  | **专用 report-templates**（OKKI / 询盘分析 / 周期报告纲要） | Read `references/report-templates/<名>.md` **全文**（与 `report-templates/<名>.md` 同源）；勿只凭 SKILL 摘要 |
18
19
  | **上下文被压缩 / 记不清字段或命令** | 重读 `SKILL.md` 路由表 + 当次任务 references |
19
20
  | **CLI 返回 400 / 字段对不上** | 回到对应 reference 核对参数名与口径，勿猜 |
@@ -31,7 +32,7 @@
31
32
  | 契约说明 / 规则 | `assets/<文件>.md` | 与上表 JSON **成对** Read；如 `assets/campaign-create-template.md` |
32
33
  | HTML 终稿模板 | `report-templates/*.html` | 由 CLI `render` 使用，Agent 通常只 Read 对应 `.md` 纲要 |
33
34
 
34
- 路由表若写 `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` 核对真实路径。
35
36
 
36
37
  ---
37
38
 
@@ -76,7 +77,7 @@
76
77
  | 允许 Read 的文件 | 必须用代码读取的文件 |
77
78
  | -------------------------------------------------------------------------------- | ------------------------------------------ |
78
79
  | `references/**/*.md`、`assets/**/*.md`（Skill 文档） | 所有 `--json-out` 落盘业务 `*.json`（常为 MB 级） |
79
- | `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`） |
80
81
  | 当次 `*.outline.txt` | 用户提供的同构大 JSON |
81
82
  | stdout 一行摘要、你刚写出的最终产物文件 | — |
82
83
 
@@ -92,7 +93,7 @@
92
93
  | `keywordText` | `keyword` |
93
94
  | `query` | `searchTermText` |
94
95
 
95
- 国家名、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` 再脚本读）。
96
97
 
97
98
  **报告/Excel 全流程走本 Skill**：按工作流卡片与 `report-templates/*.md` 拉数、落盘、脚本转换；**禁止**加载宿主第三方 xlsx/Excel Skill 代劳（不知 TSO 字段口径与账户核验）。
98
99
 
@@ -133,7 +134,7 @@
133
134
 
134
135
  **例外**（不反问）：
135
136
 
136
- - `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 意图速查）。
137
138
  - 「昨天」单日 stats：默认 `Asia/Shanghai` 日历日；先 `list-accounts` 再 `stats`。
138
139
  - `forewarning records`、`invoice list`「本月」、TikTok `clue`「最近一周」：见对应 references。
139
140