siluzan-tso-cli 1.1.28-beta.6 → 1.1.28-beta.7
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.
- package/README.md +1 -1
- package/dist/skill/AGENTS.md +13 -4
- package/dist/skill/SKILL.md +73 -59
- package/dist/skill/_meta.json +2 -2
- package/dist/skill/references/README.md +3 -3
- package/dist/skill/references/analytics/account-analytics.md +9 -33
- package/dist/skill/references/core/playbooks.md +112 -181
- package/dist/skill/references/core/workflows.md +141 -897
- package/dist/skill/scripts/install.ps1 +1 -1
- package/dist/skill/scripts/install.sh +1 -1
- package/eval/cases/facebook-analysis-not-google-keywords.scenario.json +2 -6
- package/eval/cases/facebook-analysis-period-default.scenario.json +1 -3
- 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.28-beta.
|
|
54
|
+
> **注意**：当前为测试版（1.1.28-beta.7），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
55
55
|
|
|
56
56
|
| 助手 | 建议 `--ai` |
|
|
57
57
|
| ----------------------- | ------------------------------------ |
|
package/dist/skill/AGENTS.md
CHANGED
|
@@ -4,9 +4,12 @@
|
|
|
4
4
|
|
|
5
5
|
## 启动顺序
|
|
6
6
|
|
|
7
|
-
1. Read `SKILL.md
|
|
7
|
+
1. Read `SKILL.md`（单一路由表：意图 → 工作流 → 必读文档）
|
|
8
8
|
2. **每个新任务** Read `references/core/agent-conventions.md`
|
|
9
|
-
3.
|
|
9
|
+
3. 按路由表 Read「必读文档」与对应工作流卡片，再执行 `siluzan-tso …`：
|
|
10
|
+
- 分析/报告类线性步骤 → `references/core/playbooks.md`（P1–P9）
|
|
11
|
+
- 操作/管理类线性步骤 → `references/core/workflows.md`（W1–W12）
|
|
12
|
+
- 命令参数/字段口径 → 各域 `references/*.md`
|
|
10
13
|
4. **P5 / P6 / P7** 或长 CLI 输出：可选 Read `references/core/subagent-orchestration.md`（主 Agent 自行决定是否委派 subagent）
|
|
11
14
|
|
|
12
15
|
## 文档域（gstack-style domains）
|
|
@@ -21,11 +24,17 @@
|
|
|
21
24
|
| **Operations** | `references/operations/` | 预警、线索、优化记录、宿主编排自动化 |
|
|
22
25
|
| **Templates** | `assets/`、`report-templates/` | JSON 契约、报告纲要 |
|
|
23
26
|
|
|
24
|
-
##
|
|
27
|
+
## 工作流目录
|
|
28
|
+
|
|
29
|
+
| 类别 | 文档 | 编号 |
|
|
30
|
+
| --- | --- | --- |
|
|
31
|
+
| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9 |
|
|
32
|
+
| 操作 / 管理类 | `references/core/workflows.md` | W1–W12 |
|
|
33
|
+
|
|
34
|
+
专用报告模板（被工作流卡片引用）：
|
|
25
35
|
|
|
26
36
|
| ID | 文档 |
|
|
27
37
|
| --- | --- |
|
|
28
|
-
| P1–P9 | `references/core/playbooks.md` |
|
|
29
38
|
| 网站诊断 | `report-templates/website-diagnosis-report.md` |
|
|
30
39
|
| 战略市场分析 | `report-templates/market-analysis-report.md` |
|
|
31
40
|
| OKKI 周报 | `report-templates/okki-weekly-google-client.md` |
|
package/dist/skill/SKILL.md
CHANGED
|
@@ -11,11 +11,16 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
|
|
|
11
11
|
|
|
12
12
|
# Siluzan TSO Skill
|
|
13
13
|
|
|
14
|
-
本 Skill
|
|
14
|
+
本 Skill 只做 **任务路由**：用一张「意图 → 工作流」表把用户需求映射到**唯一**的线性工作流。
|
|
15
|
+
|
|
16
|
+
- **每个业务都有一条线性工作流**（编号步骤）：
|
|
17
|
+
- **分析 / 报告类**（拉数 → 脚本 → 交付）→ `references/core/playbooks.md`（P1–P9）
|
|
18
|
+
- **操作 / 管理类**（开户、广告 CRUD、优化、预警、推送、线索、财务、权限、巡检）→ `references/core/workflows.md`（W1–W12）
|
|
19
|
+
- 业务细节、命令参数、字段口径以各域 `references/*.md` 为准（被工作流卡片引用，**不在本文件重复**）。
|
|
15
20
|
|
|
16
21
|
<!-- 注入到 SKILL.md.tmpl 的 {{AGENT_PREAMBLE}}；构建时由 gen-skill-docs.mjs 合并 -->
|
|
17
22
|
|
|
18
|
-
> **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md`
|
|
23
|
+
> **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md` 路由表 Read「必读文档」与对应工作流卡片（`core/playbooks.md` P1–P9 或 `core/workflows.md` W1–W12）。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（见 `references/core/tips.md`）——**禁止**用 Read 工具打开 `writtenFiles` 里的完整 `*.json`。
|
|
19
24
|
>
|
|
20
25
|
> **报告/Excel 交付前**：Read `references/core/deliverable-preflight.md`，**Read 最终产物**并按自检表确认币种与章节完整；币种只认当次 `list-accounts` 的 `currencyCode`。
|
|
21
26
|
>
|
|
@@ -44,75 +49,84 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
|
|
|
44
49
|
|
|
45
50
|
---
|
|
46
51
|
|
|
47
|
-
|
|
48
52
|
## 基本使用
|
|
49
53
|
|
|
50
|
-
siluzan-tso-cli
|
|
54
|
+
`siluzan-tso-cli` 只是包名，安装后可执行命令为 `siluzan-tso`。
|
|
51
55
|
|
|
52
56
|
```bash
|
|
53
|
-
siluzan-tso -h
|
|
57
|
+
siluzan-tso -h # 查看帮助
|
|
54
58
|
```
|
|
55
59
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
## 域路由（lazy-load）
|
|
59
|
-
|
|
60
|
-
| 域 | 入口 | 典型任务 |
|
|
61
|
-
| ---- | ---- | -------- |
|
|
62
|
-
| `references/core/` | `agent-conventions.md` | 纪律、tips、playbooks、workflows |
|
|
63
|
-
| `references/accounts/` | `accounts.md` | 列表、余额、MCC/BC、开户、发票 |
|
|
64
|
-
| `references/google-ads/` | `google-ads.md` | CRUD、PMax、campaign-plan；`rules/` 优化 SOP |
|
|
65
|
-
| `references/analytics/` | `account-analytics.md` | google-analysis、facebook-analysis、website-diagnosis、market-analysis、批处理、拓词、RAG |
|
|
66
|
-
| `references/operations/` | `forewarning.md` | 预警、线索、optimize、宿主编排 |
|
|
67
|
-
| `references/core/` | `subagent-orchestration.md` | **可选** subagent 自主委派（P5/P6/P7、长日志） |
|
|
68
|
-
|
|
69
|
-
完整文件列表：`references/README.md` · Agent 目录：`AGENTS.md`
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
## Subagent 自主委派（可选）
|
|
74
|
-
|
|
75
|
-
宿主具备 **Task / subagent**（或内置 Bash/Explore）时：
|
|
76
|
-
|
|
77
|
-
1. **复杂报告或批处理**（P5 / P6 OKKI / P7 询盘）、预计 CLI 输出很长 → 先 Read `references/core/subagent-orchestration.md`，按**决策矩阵**选择主会话或子会话。
|
|
78
|
-
2. Handoff 模板在 skill 根目录 `snippets/handoff-p{5,6,7}-*.md`；子会话只回传 manifest/exitCode 摘要，**禁止** Read 落盘业务 JSON、**禁止**把 MB 级 JSON 贴回主对话（须脚本读盘后只回传脚本输出）。
|
|
79
|
-
3. **无 subagent 能力** → 跳过本节，按 `core/playbooks.md` 在主会话执行。
|
|
80
|
-
|
|
81
|
-
写操作、`--commit`、401/batch `resume` 策略由**主 Agent**负责，不默认下放子会话。
|
|
60
|
+
**Agent 三步法**：① 在下方路由表按用户意图找到对应行 → ② Read 该行「必读文档」与对应工作流卡片 → ③ 按卡片**编号步骤**逐步执行，写操作前先与用户确认。
|
|
82
61
|
|
|
83
62
|
---
|
|
84
63
|
|
|
85
|
-
##
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
|
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
99
|
-
|
|
|
100
|
-
|
|
|
101
|
-
|
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
64
|
+
## 路由表（意图 → 工作流 → 必读文档）
|
|
65
|
+
|
|
66
|
+
> 首次进入任意任务前先 Read `references/core/agent-conventions.md`。下表每行指向**唯一**工作流；找不到时查 `references/README.md`。
|
|
67
|
+
|
|
68
|
+
### 账户与财务
|
|
69
|
+
|
|
70
|
+
| 用户意图（关键词） | 工作流 | 必读文档 |
|
|
71
|
+
| ------------------ | ------ | -------- |
|
|
72
|
+
| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `accounts/accounts.md`（§ list-accounts 意图速查：`-m <媒体> --page-size 999 --json-out`） |
|
|
73
|
+
| 单户实时余额 | W1 | `accounts/accounts.md`（balance）+ `accounts/currency.md` |
|
|
74
|
+
| 多账户余额 / 续航不足预警 | **P2** | `accounts/accounts.md`（balance-scan）+ `accounts/currency.md` |
|
|
75
|
+
| 单户消耗 / 投放数据 | W1 / **P1** | `accounts/accounts.md`（stats）+ `accounts/currency.md` |
|
|
76
|
+
| 多账户消耗/对比汇总 | **P3** | `accounts/accounts.md`（accounts-digest）+ `accounts/currency.md` |
|
|
77
|
+
| 激活/充值账单明细 | W1 | `accounts/accounts.md`（account-active-bills） |
|
|
78
|
+
| 开户（六大媒体）/ 开户进度 | W2 | `accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `accounts/open-account-google-ui.md`） |
|
|
79
|
+
| 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `accounts/accounts.md`（account 子命令） |
|
|
80
|
+
| 充值 / 钱包 | W8 | `accounts/finance.md`（recharge 引导网页） |
|
|
81
|
+
| 转账记录 / 账户间转账 | W8 | `accounts/finance.md`（transfer） |
|
|
82
|
+
| 发票 / 开票 / 发票抬头 | W8 | `accounts/finance.md`（invoice / invoice-info） |
|
|
83
|
+
| 审计 / 误操作恢复 | — | `accounts/write-audit-restore.md` |
|
|
84
|
+
|
|
85
|
+
### Google 广告投放
|
|
86
|
+
|
|
87
|
+
| 用户意图（关键词） | 工作流 | 必读文档 |
|
|
88
|
+
| ------------------ | ------ | -------- |
|
|
89
|
+
| 新建搜索系列 / 出投放方案 | W3 | `google-ads/google-ads-campaign-plan.md` + `assets/campaign-create-template.md` |
|
|
90
|
+
| 广告系列/组/广告/关键词 CRUD / 拒审 | W3 | `google-ads/google-ads.md` |
|
|
91
|
+
| PMax 系列 | W3 | `assets/pmax-create-template.md` + `google-ads/pmax-api.md` |
|
|
92
|
+
| AI 智投草稿 list/get/update/publish | W4 | `google-ads/google-ads.md`（§ ad batch） |
|
|
93
|
+
| 拓词 / keyword / 关键词规划 | W5 | `analytics/keyword-planner-workflows.md`（客户背景先 `analytics/rag.md`） |
|
|
94
|
+
| AI 广告优化记录 / 建议 | W6 | `operations/optimize.md` |
|
|
95
|
+
| 优化/合规 SOP | W3 / W6 | `google-ads/rules/README.md` |
|
|
96
|
+
|
|
97
|
+
### 分析与报告（CLI 拉数 + Agent 撰稿）
|
|
98
|
+
|
|
99
|
+
| 用户意图（关键词） | 工作流 | 必读文档 |
|
|
100
|
+
| ------------------ | ------ | -------- |
|
|
101
|
+
| 单账户投放画像 / 诊断 | **P1** | `analytics/account-analytics.md` + `core/tips.md` + `core/deliverable-preflight.md` |
|
|
102
|
+
| Google 账户周期报告 | **P4** | `report-templates/google-period-report.md` + `analytics/account-analytics.md` + `core/deliverable-preflight.md` |
|
|
103
|
+
| Meta/Facebook 周期或诊断报告 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `analytics/facebook-analysis-guide.md`；要 Excel 加 `meta-period-report-excel.md` |
|
|
104
|
+
| TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `report-templates/*-period-report.md` |
|
|
105
|
+
| 多账户 × 多维度批处理 | **P5** | `analytics/google-analysis-batch.md` + `analytics/account-analytics.md` |
|
|
106
|
+
| OKKI 周报 | **P6** | `report-templates/okki-weekly-google-client.md`（全文） |
|
|
107
|
+
| Google 询盘分析 | **P7** | `report-templates/google-inquiry-analysis.md`（全文）+ `analytics/geo-continents.json` |
|
|
108
|
+
| 网站诊断 / 落地页评分 | **P8** | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**默认交付 HTML**） |
|
|
109
|
+
| 市场分析 / 行业 / 战略市场报告 | **P9** | `analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**默认交付 HTML**） |
|
|
110
|
+
| Google 广告诊断 / 账户健康检查 | **P1** | `report-templates/google-ads-diagnosis.md` + `report-templates/google-account-diagnosis-report.md` |
|
|
111
|
+
| TSO 平台优化报告：列表/生成/推送 | W7 | `analytics/reporting.md` |
|
|
112
|
+
| RAG 知识库检索 | W5 | `analytics/rag.md` |
|
|
113
|
+
|
|
114
|
+
### 工具与运营
|
|
115
|
+
|
|
116
|
+
| 用户意图（关键词） | 工作流 | 必读文档 |
|
|
117
|
+
| ------------------ | ------ | -------- |
|
|
118
|
+
| 智能预警：创建/查询/启停/触发记录 | W10 | `operations/forewarning.md` |
|
|
119
|
+
| TikTok / Meta 线索表单 | W11 | `operations/clue.md` |
|
|
120
|
+
| 日/周巡检 | W12 | `core/workflows.md`（W12）+ `accounts/accounts.md` |
|
|
121
|
+
| 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `operations/hosted-automation-user-catalog.md`（索引）→ `operations/hosted-automation-*.md` |
|
|
122
|
+
|
|
123
|
+
> **数据/报告类任务通用纪律**：一律 `--json-out` 落盘 + **仅用脚本**读 JSON（见 `core/tips.md`）；交付前 Read 最终产物按 `core/deliverable-preflight.md` 自检（币种/章节）。
|
|
110
124
|
|
|
111
125
|
---
|
|
112
126
|
|
|
113
|
-
##
|
|
127
|
+
## Subagent 自主委派（可选）
|
|
114
128
|
|
|
115
|
-
|
|
129
|
+
宿主具备 **Task / subagent** 时：复杂报告或批处理（**P5 / P6 / P7**）、预计 CLI 输出很长 → 先 Read `references/core/subagent-orchestration.md`，按决策矩阵决定是否委派；handoff 模板在 `snippets/handoff-p{5,6,7}-*.md`。**写操作确认、`--commit`、401/`resume` 策略与对用户的最终交付始终留在主 Agent**。无此能力则跳过，按工作流卡片在主会话执行。
|
|
116
130
|
|
|
117
131
|
---
|
|
118
132
|
|
|
@@ -123,7 +137,7 @@ P1–P9 见 `references/core/playbooks.md`。
|
|
|
123
137
|
| 结构化字段拉取（`--json-out`） | 何时触发检查（cron、对话） |
|
|
124
138
|
| 写命令语义与读命令复核文档 | IF 条件计算与决策 |
|
|
125
139
|
| 金额、ID、字段口径一致 | 触达（钉钉/飞书）与工单 |
|
|
126
|
-
| references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent
|
|
140
|
+
| references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent 并行 |
|
|
127
141
|
|
|
128
142
|
详见 `operations/hosted-automation-self-control.md`、`operations/hosted-automation-monitoring-json.md`、`operations/hosted-automation-optimize-index.md`。
|
|
129
143
|
|
package/dist/skill/_meta.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# References 索引
|
|
2
2
|
|
|
3
|
-
> Agent 按 `SKILL.md
|
|
3
|
+
> Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `core/playbooks.md`（P1–P9），操作/管理类在 `core/workflows.md`（W1–W12），命令参数在各域 reference。维护者见 `core/skill-authoring.md`。
|
|
4
4
|
|
|
5
5
|
## 基础与纪律
|
|
6
6
|
|
|
@@ -10,8 +10,8 @@
|
|
|
10
10
|
| `core/agent-conventions.md` | **Agent 必读**：加载纪律、硬规范、数据转换、时间/币种/批量 |
|
|
11
11
|
| `core/tips.md` | `--json-out` 协议、outline→脚本读 JSON |
|
|
12
12
|
| `core/deliverable-preflight.md` | **交付前审阅最终产物**：Agent Read 报告文件并对照自检表（币种/章节） |
|
|
13
|
-
| `core/playbooks.md` | P1–P9
|
|
14
|
-
| `core/workflows.md` |
|
|
13
|
+
| `core/playbooks.md` | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付） |
|
|
14
|
+
| `core/workflows.md` | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式） |
|
|
15
15
|
| `core/skill-authoring.md` | Skill 文档维护最佳实践（维护者） |
|
|
16
16
|
| `core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7） |
|
|
17
17
|
|
|
@@ -27,42 +27,18 @@
|
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
30
|
-
##
|
|
31
|
-
|
|
32
|
-
1. **先确认统计区间**：用户未给明确起止日期时**必须反问**（参见 SKILL.md 时间范围强制反问）。
|
|
33
|
-
2. 确定报告维度（默认含：执行摘要、每日趋势、月度汇总、系列表现、设备分布、地域分布、关键词表现、优化建议），详见 `report-templates/README.md`。若用户使用 **「使用 okki 周报模板…」「OKKI 周报」** 等固定话术发客户，改走 **`report-templates/okki-weekly-google-client.md`**（与 SKILL **P6** 一致），不再按 `google-period-report.md` 的默认 8 维追问。
|
|
34
|
-
3. **拉数**：使用 `google-analysis … --json-out <dir>`（Google）或对应 `report <media>-*` 命令落盘。
|
|
35
|
-
4. **编写并执行代码**从磁盘读取 `manifest-<accountId>.json` 与各 `<section>-<accountId>.json` 来完成筛选、聚合、排序等计算；**禁止**用宿主 `Read` 打开业务 `*.json`；**禁止**在对话里心算或手填报告数字。
|
|
36
|
-
- **写脚本前**用 Read 仅打开 `<section>-<accountId>.outline.txt`（或 `node -e` 读最后一行类型字面量）了解字段结构；**业务 JSON 只许在脚本里** `require` / `readFileSync`，脚本 `console.log` 打印所需汇总。
|
|
37
|
-
- 真实数据始终从 `<section>-<accountId>.json` 通过代码获取，**不要**把 outline 当作业务数据贴给用户。
|
|
38
|
-
5. **由代码写出最终文件**（HTML/Excel/PDF/PPT/Markdown/word 等）。**禁止**在报告脚本中以源码字面量写死应从 JSON 读取的业务数据（消耗金额、系列名、日期区间等）。允许的常量仅限：快照目录路径、JSON 字段键名、版式/结构占位。
|
|
39
|
-
6. **报告首行**须标注：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`
|
|
40
|
-
7. 交付后帮用户打开报告文件。
|
|
30
|
+
## 工作流入口（线性步骤见 playbooks）
|
|
41
31
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
**原则**：把拉数结果变成磁盘上的单一事实源，Agent 产出可执行脚本 + 模板骨架，由程序 **读取 JSON → 计算 → 写报告产物**。
|
|
47
|
-
|
|
48
|
-
**步骤**：
|
|
49
|
-
|
|
50
|
-
1. 创建 run 目录（如 `./siluzan-snapshots/run-20260429-google-<id>`）。
|
|
51
|
-
2. 执行 `siluzan-tso google-analysis -a <id> [--sections <a,b,c>] [--start/--end] --json-out <run目录>`。目录内生成 `<section>-<accountId>.json` 和 `manifest-<accountId>.json`。同一目录允许多账户共存。
|
|
52
|
-
3. **编写数据处理脚本**（Node.js/Python），从 `manifest-<accountId>.json` 读取文件路径，用标准库完成过滤/分组/求和/排序。所有展示数值须来自 JSON 对象字段，不得在源码中硬编码示例数据。
|
|
53
|
-
4. **由脚本写出报告文件**。HTML 可对齐 `report-templates/report-template.html` 仅作版式参考。
|
|
54
|
-
|
|
55
|
-
**stdout**：`--json-out` 模式下 CLI 只输出一行摘要 JSON（含 `absoluteSnapshotDir`、`writtenFiles`、`manifestFile` 等），完整数据一律从落盘文件读取。
|
|
56
|
-
|
|
57
|
-
**清单文件**：
|
|
58
|
-
|
|
59
|
-
- Google：`manifest-<accountId>.json`
|
|
60
|
-
- Meta/TikTok/Bing：`report-manifest-<accountId>.json` + `<section>-<accountId>.json`
|
|
32
|
+
> 本文件是**拉数命令与字段口径的真相源**；完整线性步骤已统一到 `references/core/playbooks.md`：
|
|
33
|
+
> 单户画像 **P1**、Google 周期报告 **P4**、Meta 周期 **P4-FB**、多账户批处理 **P5**、OKKI **P6**、询盘 **P7**。
|
|
34
|
+
> 「使用 okki 周报模板」固定话术 → **P6**，不按 `google-period-report.md` 默认 8 维追问。
|
|
61
35
|
|
|
62
|
-
|
|
36
|
+
通用纪律（详见 `core/tips.md` 与 `core/deliverable-preflight.md`）：
|
|
63
37
|
|
|
64
|
-
-
|
|
65
|
-
-
|
|
38
|
+
- **拉数**：`google-analysis … --json-out <dir>`（Google）或 `report <media>-*` 命令落盘；目录内生成 `<section>-<accountId>.json` + `manifest-<accountId>.json`（Meta/TikTok/Bing 为 `report-manifest-<accountId>.json`）。
|
|
39
|
+
- **消费**：先 Read `<section>-<accountId>.outline.txt` 了解字段 → **仅用脚本** `require`/`readFileSync` 读业务 JSON → 由脚本计算并写出最终产物；**禁止**用 Read 打开业务 `*.json`、**禁止**对话里心算/手填、**禁止**把应从 JSON 读取的业务数据写成源码字面量。
|
|
40
|
+
- **stdout** 仅一行摘要（`absoluteSnapshotDir`/`writtenFiles`/`manifestFile`），完整数据从落盘文件读。
|
|
41
|
+
- **报告首行**标注 `统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`，交付后帮用户打开文件。
|
|
66
42
|
|
|
67
43
|
---
|
|
68
44
|
|