siluzan-tso-cli 1.1.23-beta.2 → 1.1.24-beta.2

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.23-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.24-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/skill/AGENTS.md

@@ -7,12 +7,14 @@
 1. Read `SKILL.md`（路由 + 任务→文档表）
 2. **每个新任务** Read `references/core/agent-conventions.md`
 3. 按任务表 Read 对应域文档后再执行 `siluzan-tso …`
+4. **P5 / P6 / P7** 或长 CLI 输出：可选 Read `references/core/subagent-orchestration.md`（主 Agent 自行决定是否委派 subagent）
 
 ## 文档域（gstack-style domains）
 
 | 域 | 路径 | 何时 Read |
 | --- | --- | --- |
-| **Core** | `references/core/` | 纪律、安装、tips、playbooks、workflows |
+| **Core** | `references/core/` | 纪律、安装、tips、playbooks、workflows、subagent-orchestration |
+| **Handoff** | `snippets/` | P5/P6/P7 Task 派发模板（与 SKILL 同级） |
 | **Accounts** | `references/accounts/` | 列表、余额、开户、财务、审计 |
 | **Google Ads** | `references/google-ads/` | CRUD、PMax、搜索系列流水线；`rules/` 为优化 SOP |
 | **Analytics** | `references/analytics/` | 拉数、批处理、拓词、RAG、TSO 报告 |

package/dist/skill/SKILL.md

@@ -16,6 +16,8 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 <!-- 注入到 SKILL.md.tmpl 的 {{AGENT_PREAMBLE}}；构建时由 gen-skill-docs.mjs 合并 -->
 
 > **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md` 任务表 Read 域文档。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + 脚本读盘（见 `references/core/tips.md`）。
+>
+> **Subagent（可选）**：若宿主支持 Task / 子会话，复杂报告（P5/P6/P7）或长 CLI 输出前 Read `references/core/subagent-orchestration.md`，**自行决定**是否委派；写操作确认与对用户的最终交付留在主 Agent。
 
 ---
 
@@ -55,11 +57,24 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | `references/google-ads/` | `google-ads.md` | CRUD、PMax、campaign-plan；`rules/` 优化 SOP |
 | `references/analytics/` | `account-analytics.md` | google-analysis、批处理、拓词、RAG |
 | `references/operations/` | `forewarning.md` | 预警、线索、optimize、宿主编排 |
+| `references/core/` | `subagent-orchestration.md` | **可选** subagent 自主委派（P5/P6/P7、长日志） |
 
 完整文件列表：`references/README.md` · Agent 目录：`AGENTS.md`
 
 ---
 
+## Subagent 自主委派（可选）
+
+宿主具备 **Task / subagent**（或内置 Bash/Explore）时：
+
+1. **复杂报告或批处理**（P5 / P6 OKKI / P7 询盘）、预计 CLI 输出很长 → 先 Read `references/core/subagent-orchestration.md`，按**决策矩阵**选择主会话或子会话。
+2. Handoff 模板在 skill 根目录 `snippets/handoff-p{5,6,7}-*.md`；子会话只回传 manifest/exitCode 摘要，**禁止**把 MB 级 JSON 贴回主对话。
+3. **无 subagent 能力** → 跳过本节，按 `core/playbooks.md` 在主会话执行。
+
+写操作、`--commit`、401/batch `resume` 策略由**主 Agent**负责，不默认下放子会话。
+
+---
+
 ## 任务 → 必读 references
 
 | 用户意图（关键词） | 必读（Read 后再 `-h` / 执行） |
@@ -75,9 +90,10 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | 预警 | `operations/forewarning.md` |
 | 发票 / 转账 / 充值 | `accounts/finance.md` |
 | 开户 | `accounts/open-account-by-media.md`（Google 加 `accounts/open-account-google-ui.md`） |
-| OKKI 周报 | `report-templates/okki-weekly-google-client.md` + `core/playbooks.md` P6 |
-| Google 询盘分析 | `report-templates/google-inquiry-analysis.md` + `core/playbooks.md` P7 |
+| OKKI 周报 | `report-templates/okki-weekly-google-client.md` + `core/playbooks.md` P6；可选 `core/subagent-orchestration.md` |
+| Google 询盘分析 | `report-templates/google-inquiry-analysis.md` + `core/playbooks.md` P7；可选 `core/subagent-orchestration.md` |
 | 标准画像/扫描/周期报告 | `core/playbooks.md` 对应 P1–P5 |
+| P5 多账户多维度 batch | `analytics/google-analysis-batch.md` + `core/playbooks.md` P5；可选 `core/subagent-orchestration.md` |
 
 > 表未覆盖时：查 `references/README.md` → Read 对应 reference → 再执行 CLI。
 
@@ -96,7 +112,7 @@ P1–P7 见 `references/core/playbooks.md`。
 | 结构化字段拉取（`--json-out`） | 何时触发检查（cron、对话） |
 | 写命令语义与读命令复核文档 | IF 条件计算与决策 |
 | 金额、ID、字段口径一致 | 触达（钉钉/飞书）与工单 |
-| references 与命令对齐 | 批处理循环、限速、重试 |
+| references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent 并行（见 `subagent-orchestration.md`） |
 
 详见 `operations/hosted-automation-self-control.md`、`operations/hosted-automation-monitoring-json.md`、`operations/hosted-automation-optimize-index.md`。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.23-beta.2",
-  "publishedAt": 1780022870426
+  "version": "1.1.24-beta.2",
+  "publishedAt": 1780295970911
 }

package/dist/skill/references/README.md

@@ -12,6 +12,7 @@
 | `core/playbooks.md` | P1–P7 高频任务标准动作 |
 | `core/workflows.md` | 多命令串联业务流程 |
 | `core/skill-authoring.md` | Skill 文档维护最佳实践（维护者） |
+| `core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7） |
 
 ## 账户与财务
 
@@ -71,3 +72,13 @@
 ## 报告模板（`../report-templates/`）
 
 见 `report-templates/README.md`。
+
+## Handoff 模板（`../snippets/`，随 skill 安装）
+
+| 文件 | 用途 |
+| ---- | ---- |
+| `handoff-p5-batch.md` | P5 batch 与按账户聚合 Task prompt |
+| `handoff-p6-okki.md` | P6 OKKI 拉数 / 写 xlsx |
+| `handoff-p7-inquiry.md` | P7 询盘拉数与 xlsx |
+
+`agent-preamble.md` 仅用于构建时注入 `SKILL.md`，不复制到 `dist/skill/snippets/`。

package/dist/skill/references/analytics/google-analysis-batch.md

@@ -200,6 +200,18 @@ const tsType = outline
 
 ---
 
+## 产物消费与 subagent（可选）
+
+batch 完成后，主 Agent 按 `references/core/tips.md`：**先 outline 后 JSON**，脚本读盘聚合。
+
+若宿主支持 subagent（见 `references/core/subagent-orchestration.md` § P5）：
+
+- **batch `run` / `resume`**：主会话或**单次** Bash 执行，**禁止** per-account 子会话重复调 API。
+- **按账户写报告片段**：可对每个 `results/<accountId>/` 并行 Task，handoff 见 `snippets/handoff-p5-batch.md` §阶段 B。
+- 子会话**禁止**重新 `run` batch；401 由主 Agent 统一 `login` 后 `resume`。
+
+---
+
 ## 常见问题
 
 **Q：拉全量是不是先 `list-accounts` 再把 ID 拼进 `-a`？**

package/dist/skill/references/core/agent-conventions.md

@@ -46,6 +46,14 @@
 | **客户/产品背景** | 拓词、方案、报告背景段：先 `rag list` + `rag query`，再衔接 `keyword` / `ad` / `google-analysis` |
 | **仅调接口** | 优化记录、线索表单、预警、财务命令：无需输出转换 |
 
+### Subagent（可选）
+
+宿主支持 Task / 子会话时：
+
+1. **P5 / P6 / P7** 或预计 CLI 日志很长 → Read `references/core/subagent-orchestration.md`，按决策矩阵选择主会话或委派。
+2. 子会话**不替代**本节「文档加载纪律」：主 Agent 仍须 Read 当次必读 references；handoff 只传路径与命令块，不传对话记忆。
+3. 写入/修改/删除、`--commit`、对用户确认与最终交付 → **主 Agent**。
+
 ---
 
 ## 硬规范

package/dist/skill/references/core/playbooks.md

@@ -8,9 +8,9 @@
 | P2 | 多账户余额扫描 | `accounts/accounts.md`（`balance-scan`）、`accounts/currency.md` |
 | P3 | 多账户投放画像汇总 | `accounts/accounts.md` § accounts-digest、`accounts/currency.md`、`core/tips.md` |
 | P4 | Google 账户周期报告 | `report-templates/google-period-report.md`、`analytics/account-analytics.md`、`core/tips.md` |
-| P5 | 多账户多维度报告 | `analytics/google-analysis-batch.md`、`analytics/account-analytics.md`、`core/tips.md` |
-| P6 | OKKI 周报 | `report-templates/okki-weekly-google-client.md`（全文）、`analytics/account-analytics.md`、`core/tips.md` |
-| P7 | Google 询盘分析 | `report-templates/google-inquiry-analysis.md`（全文）、`analytics/account-analytics.md`、`core/tips.md`、`analytics/geo-continents.json` |
+| P5 | 多账户多维度报告 | `analytics/google-analysis-batch.md`、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
+| P6 | OKKI 周报 | `report-templates/okki-weekly-google-client.md`（全文）、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
+| P7 | Google 询盘分析 | `report-templates/google-inquiry-analysis.md`（全文）、`analytics/account-analytics.md`、`core/tips.md`、`analytics/geo-continents.json`；可选 `core/subagent-orchestration.md` |
 
 ---
 
@@ -72,6 +72,8 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 
 **入口选择**：全量 → 省略 `-a`；2~10 子集 → `google-analysis -a id1,id2,...`；≥10 子集或需 resume → `google-analysis-batch run -a id1,id2,...`
 
+0. **执行模式**（可选）：Read `core/subagent-orchestration.md` § P5。batch 本身用主会话或**单次** Bash；**禁止** per-account 子会话调 API；batch 完成后可按账户并行 Task 聚合（`snippets/handoff-p5-batch.md`）。
+
 1. 反问时间范围 + 维度（默认 `campaigns,geographic,keywords`）。
 2. **执行**：
 
@@ -102,6 +104,8 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 
 > **触发**：用户话术含 `使用okki周报模板` / `OKKI 周报` / `okki 周报` 等，且指向 Google 账户 + 日期区间。
 
+0. **执行模式**（可选）：Read `core/subagent-orchestration.md` § P6。拉数 / 写 xlsx 可分阶段委派（`snippets/handoff-p6-okki.md`）；无 subagent 则主会话执行下列步骤。
+
 1. **不要**按 `google-period-report.md` 展开默认 8 维；改读 `report-templates/okki-weekly-google-client.md` 全文。
 2. 确认 `mediaCustomerId` 与 `--start` / `--end`（未给齐按 `core/agent-conventions.md` 时间范围规则反问）。
 3. 同一 `--json-out` 目录执行模板中的命令组合：`list-accounts`（可选）、`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched`。
@@ -115,6 +119,8 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 > **触发**：用户话术含 `Goog账户询盘分析` / `Google 账户询盘分析` / `分析XXX Google账号的询盘效果`，或同时包含「询盘 + 账户 + Google」三要素。  
 > **不要**按 `google-period-report.md` 默认 8 维流程。
 
+0. **执行模式**（可选）：Read `core/subagent-orchestration.md` § P7。`m1`/`m2`/`m3` 可并行 Task（`snippets/handoff-p7-inquiry.md`）；写 8 Sheet xlsx 建议主 Agent 或单 Task 收尾。
+
 1. **时间窗口强约束**：**严格 3 个月** = 分析月份 + 向前 2 个完整自然月。**禁止**扩展到 7 个月。
 2. **询盘资料入场**：
    - **流程 A**（用户已附文件）：解析 → 落盘 `./snap-inquiry/inquiries.json`（字段见模板「询盘字段清单」）。

package/dist/skill/references/core/skill-authoring.md

@@ -14,8 +14,9 @@ siluzan-tso/                    # 安装后目录名
 ├── SKILL.md.tmpl → SKILL.md    # 构建生成
 ├── snippets/                   # 共享注入块
 ├── docs/skill-guide.md         # 人类导读
+├── snippets/                   # agent-preamble、handoff-p5/p6/p7（构建时注入 SKILL 或随包复制）
 ├── references/
-│   ├── core/                   # 纪律、安装、playbooks
+│   ├── core/                   # 纪律、安装、playbooks、subagent-orchestration
 │   ├── accounts/               # 账户、开户、财务
 │   ├── google-ads/             # CLI + rules/
 │   ├── analytics/              # 拉数、批处理、拓词
@@ -104,6 +105,8 @@ Agent 已具备通用能力。文档只写 **CLI 特有** 内容：字段口径
 | `SKILL.md` | 安装、能力边界、文档路由表、任务→文档速查、Playbook 索引 |
 | `references/core/agent-conventions.md` | Agent 纪律：加载时机、硬规范、数据转换、时间/币种/批量 |
 | `references/core/playbooks.md` | P1–P7 标准动作（可复制命令块） |
+| `references/core/subagent-orchestration.md` | 主 Agent 自主委派决策矩阵（无 `agents/` 目录） |
+| `snippets/handoff-p*.md` | Task handoff 模板（随 skill 安装根复制） |
 | `references/core/tips.md` | `--json-out` 协议、outline 处理顺序 |
 | `references/*.md` | 单功能域：命令、参数、输出示例 |
 | `references/google-ads/rules/` | Google 优化/合规 SOP（非 CLI 参数） |
@@ -181,6 +184,7 @@ description: >-
 | google-ads-rules 深链三层 | SKILL → `google-ads/rules/README.md` → 具体规则 |
 | HTML 模板假数据当示例 | 纲要 `.md` 定义维度，数据来自 CLI |
 | 凭记忆跨任务复用参数 | 每任务重读 `core/agent-conventions.md` § 加载纪律 |
+| 固定 `agents/` 与 skill 双源维护 | 用 `subagent-orchestration.md` + handoff snippets，主 Agent 自主决策 |
 
 ---
 

package/dist/skill/references/core/subagent-orchestration.md

@@ -0,0 +1,148 @@
+# Subagent 自主委派（宿主客户端）
+
+> 本文件定义：在已激活 **siluzan-tso** Skill 的前提下，**主 Agent 如何根据当前任务自行决定**是否在子会话中执行部分步骤，以及如何 handoff。  
+> 不预置固定 `agents/` 目录；不修改 CLI。若宿主**无** Task / subagent 能力，**整节不适用**，按 `playbooks.md` 在主会话执行即可。
+
+协议背景：[Agent Skills — Subagent delegation](https://agentskills.io/client-implementation/adding-skills-support)（可选：子会话执行 + 摘要回传）。Cursor 对照：[Skills vs Subagents](https://cursor.com/docs/subagents)。
+
+---
+
+## 主 Agent 与主会话的职责（不可下放）
+
+| 保留在主 Agent | 禁止默认交给子会话 |
+| -------------- | ------------------ |
+| 时间范围反问（见 `agent-conventions.md`） | 写入/修改/删除及 `--commit` 确认 |
+| 向用户说明计划并获确认 | 401 后统一停批、引导 `login` 再 `resume` |
+| 合并子会话摘要并交付用户 | 编造 `mediaCustomerId`、金额、业务数据 |
+| 选择 Playbook（P1–P7）与必读 references | 用子会话替代「每任务 Read references」 |
+
+子会话**不继承**父对话历史；handoff 必须**自包含**（见下文）。
+
+---
+
+## 每任务决策流程（建议顺序）
+
+1. Read 当次任务必读 references（`SKILL.md` 任务表 + `agent-conventions.md`）。
+2. **若**任务属于 P5 / P6 / P7，或预计 CLI 日志冗长 / 需并行拉数 / 需读大段只读 SOP → **Read 本节决策矩阵**。
+3. 选定执行模式：**主会话** | **单次 Bash 子会话** | **单次 Task handoff** | **并行多个 Task**。
+4. 执行；子会话仅回传 `returnSchema`（见下），主 Agent 再脚本聚合或写报告。
+
+**默认路径**：不确定时 → **主会话直接执行**（与「简单任务不滥用 subagent」一致）。
+
+---
+
+## 决策矩阵
+
+| 信号 | 倾向 | 推荐子会话类型 | 勿委派 |
+| ---- | ---- | -------------- | ------ |
+| 单次 `list-accounts -k`、P1 三步拉数、`-h` 查参 | **主会话** | — | 为查一个账户开子会话 |
+| `balance-scan` / `accounts-digest` 单命令 | **主会话** | — | 外层 for-loop 逐账户 |
+| 预计 CLI **>2 分钟** 或 stderr/stdout 很长 | **委派** | 内置 **Bash** 或 Task + `snippets/handoff-*.md` 拉数段 | 在主会话逐行读日志 |
+| **P6 OKKI**：拉数 → 写 xlsx（两阶段） | **委派** | 阶段 1：Bash/Task 拉数；阶段 2：Task 只读 snap 写脚本 | 子会话做写操作确认 |
+| **P7 询盘**：`m1`/`m2`/`m3` 三月拉数 | **并行委派** | 3× Task（`handoff-p7-inquiry.md` 子目录变体） | 3× 主会话顺序跑 |
+| **P5** `google-analysis-batch run` 全量 | **主会话或单次 Bash** | **一次** batch；CLI 内置并发 | per-account 子会话调 API |
+| **P5** batch **完成后** 按账户聚合 | **可选并行** | N× Task，只读 `results/<accountId>/` | 子会话 `run` 新 batch |
+| 读 `google-ads/rules/*` 全文做方案 | **委派** | **Explore** + `readonly` | 主会话 Read 全文进上下文 |
+| 用户仅闲聊 / 解释字段口径 | **主会话** | — | — |
+
+---
+
+## Handoff 规范
+
+### 必填字段（写入 Task prompt 或 Bash 说明）
+
+| 字段 | 说明 |
+| ---- | ---- |
+| `playbookId` | `P5` / `P6` / `P7` 等 |
+| `snapDir` | `--json-out` 根目录（绝对或相对 cwd） |
+| `mediaCustomerId` | 来自当次 `list-accounts`，禁止猜 |
+| `dateRange` | `start` / `end`（YYYY-MM-DD）；P7 另附 `m1`/`m2`/`m3` |
+| `commands[]` | 可复制 bash 块（来自 playbook 或 report-template） |
+| `forbidden[]` | 至少包含：禁止 Read 全量 MB JSON 进回复；禁止编造 ID/金额；禁止 batch 重新 `run`（仅 `resume`） |
+| `returnSchema` | 子会话**只**回传下列内容 |
+
+### returnSchema（子会话结束时的回复格式）
+
+```text
+exitCode: <number>
+manifestFile: <path or "">
+writtenFiles: [<path>, ...]
+outlineFiles: [<path>, ...]
+stderrTail: <last ~20 lines or "">
+summary: <1-3 句中文，无业务数字除非来自 manifest>
+```
+
+主 Agent **不得**要求子会话生成 xlsx 话术或向用户确认写操作。
+
+### Handoff 模板文件（复制进 Task prompt）
+
+| Playbook | 文件 |
+| -------- | ---- |
+| P6 OKKI | `{skillRoot}/snippets/handoff-p6-okki.md` |
+| P5 batch 后 | `{skillRoot}/snippets/handoff-p5-batch.md` |
+| P7 询盘 | `{skillRoot}/snippets/handoff-p7-inquiry.md` |
+
+> **路径说明**：`snippets/` 与 `SKILL.md`、`references/` 同级（skill 安装根目录）。主 Agent 派发 Task 前先 Read 对应 handoff 文件，替换占位符后写入子会话 prompt。
+
+---
+
+## 内置 subagent vs 自定义 Task prompt
+
+| 宿主能力 | 何时优先 |
+| -------- | -------- |
+| **Bash**（Cursor 内置） | 纯 `siluzan-tso` 命令序列、长输出隔离 |
+| **Explore** + `readonly` | 只读搜 reference / `rules/`，不改 snap |
+| **Task + 自写 prompt** | 需嵌入上表 `forbidden` 且 Bash 不够用 |
+
+不要求固定子 Agent 名称；在 prompt 中写清角色即可（例：「TSO 拉数子任务，仅执行下列命令」）。
+
+---
+
+## Playbook 编排（P5 / P6 / P7）
+
+### P6 · OKKI 周报
+
+**必读**：`report-templates/okki-weekly-google-client.md`、`core/playbooks.md` P6。
+
+1. 主 Agent：确认账户与日期区间。
+2. **决策**：拉数阶段若日志长 → Bash/Task + `handoff-p6-okki.md` §拉数；否则主会话执行模板 §拉数命令。
+3. **决策**：写 xlsx 阶段 → Task handoff（只读 `snapDir`，先 outline 后 JSON，见 `core/tips.md`）；或主会话若上下文充足。
+4. 主 Agent：合并交付话术 + 文件路径；金额与 ID 与 manifest 一致。
+
+### P5 · 多账户多维度
+
+**必读**：`analytics/google-analysis-batch.md`、`core/playbooks.md` P5。
+
+1. 主 Agent：确认区间与 `--sections`。
+2. **batch 本身**：主会话或**单次** Bash 执行 `google-analysis-batch run`（全量省略 `-a`）或 `resume` — **禁止** per-account 子会话调 API。
+3. 处理 stdout `kind=siluzan-tso-batch-summary` 与退出码；401 → 登录后 `resume`。
+4. **可选**：账户数多且需分账户聚合 → 并行 Task，handoff 见 `handoff-p5-batch.md` §聚合，只读 `results/<accountId>/`。
+5. 主 Agent：汇总报告；跨账户禁止心算。
+
+### P7 · Google 询盘分析
+
+**必读**：`report-templates/google-inquiry-analysis.md`、`core/playbooks.md` P7。
+
+1. 主 Agent：询盘资料落盘或流程 B 反问。
+2. **决策**：主 snap 拉数 + **并行** 3× Task 跑 `m1`/`m2`/`m3`（`handoff-p7-inquiry.md`），或主会话顺序执行若客户端不支持并行。
+3. **单实例**写 8 Sheet xlsx：主会话或一次 Task（读 `geo-continents.json` 运行时加载）。
+4. 主 Agent：交付；禁止扩展为 7 个月窗口。
+
+---
+
+## 客户端兼容说明
+
+| 客户端 | 行为 |
+| ------ | ---- |
+| **Cursor** | 主 Agent 通过 Task 或内置 Bash/Explore 委派；不依赖 skill 包内 `agents/` |
+| **无 subagent** | 忽略本节，全部在主会话完成，仍遵守 `--json-out` 与 outline 纪律 |
+| **Claude Code 等** | 若有子 Agent API，同样遵循 handoff + returnSchema |
+
+---
+
+## 反模式
+
+- 为每个 Playbook 建固定 `.cursor/agents/` 文件且与 skill 双源维护。
+- 子会话内 `Read` 多份 MB 级 `keywords-*.json` 并把内容贴回父会话。
+- 用多个子会话替代 `google-analysis-batch` 内置并发。
+- 子会话代替主 Agent 向用户确认 `--commit` 写操作。

package/dist/skill/report-templates/google-inquiry-analysis.md

@@ -54,6 +54,16 @@
 
 ---
 
+## Subagent 编排（可选）
+
+主 Agent 先 Read `references/core/subagent-orchestration.md` § P7：
+
+- **主 snap + 按月拉数**：可并行 3× Task（`snippets/handoff-p7-inquiry.md` 变体 m1/m2/m3），或主会话顺序执行。
+- **8 Sheet xlsx**：主 Agent 或单 Task 收尾；子会话禁止扩展 7 个月窗口、禁止编造询盘数据。
+- handoff 与 `returnSchema` 见 orchestration 文档。
+
+---
+
 ## 拉数（同一目录落盘）
 
 `./snap-inquiry` 为示例目录。设 `S` = 起始月 1 号、`E` = 分析月最后一天。

package/dist/skill/report-templates/okki-weekly-google-client.md

@@ -55,6 +55,19 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 ---
 
+## Subagent 编排（可选）
+
+宿主支持 Task / 子会话时，主 Agent 先 Read `references/core/subagent-orchestration.md` § P6，再决定是否委派：
+
+| 阶段 | 建议 | handoff |
+| ---- | ---- | ------- |
+| 拉数（本节命令） | 主会话或 Bash/Task | `snippets/handoff-p6-okki.md` §阶段 A |
+| 写 xlsx + 话术 | 主 Agent 或单 Task | 同文件 §阶段 B |
+
+子会话只回传 manifest/exitCode/产出路径；**禁止**把 JSON 全文贴回主对话。写操作确认仍由主 Agent 负责。
+
+---
+
 ## xlsx 版式规范
 
 工作簿 → Sheet 名（须完全一致）→ 版式。**不**单独建「广告系列」Sheet（系列表在 `账户报告` 内）。状态枚举若为英文须转中文。

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.23-beta.2'
+$PKG_VERSION = '1.1.24-beta.2'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.23-beta.2"
+readonly PKG_VERSION="1.1.24-beta.2"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/dist/skill/snippets/handoff-p5-batch.md

@@ -0,0 +1,45 @@
+# Handoff · P5 多账户 batch（供 Task / Bash 子会话）
+
+## 阶段 A · batch 执行（通常由主会话或单次 Bash 完成，非 per-account）
+
+主 Agent **应**在主会话或**一次** Bash 子会话执行，不要用多个子会话替代 CLI 并发：
+
+```bash
+# 全量：省略 -a
+siluzan-tso google-analysis-batch run \
+  --start <S> --end <D> \
+  --sections campaigns,geographic,keywords \
+  --account-concurrency 4 --section-concurrency 6 \
+  --min-spend 1 --keyword-limit 1000 \
+  --json-out ./snap-p5
+
+# 中断后续跑（禁止重新 run）
+siluzan-tso google-analysis-batch resume --json-out ./snap-p5 --run-id <runId>
+```
+
+**forbidden**: 先 `list-accounts` 再拼全量 ID 到 `-a`；禁止子会话对每个账户单独 `google-analysis`。
+
+**returnSchema**: stdout 单行 JSON 摘要、`runId`、exitCode；勿贴 `results/` 下全文 JSON。
+
+---
+
+## 阶段 B · 按账户聚合（可选，可并行多个 Task）
+
+**前提**: batch 已成功或部分成功（exitCode 0 或 2），路径已知：
+
+`snapDir`: `./snap-p5`  
+`runId`: `<runId>`  
+`accountId`: `<单个 mediaCustomerId>`
+
+**forbidden**:
+
+- 禁止 `google-analysis-batch run` 重新跑
+- 禁止 Read 整文件 JSON 进回复；脚本读盘
+
+**任务**:
+
+1. 只处理 `{snapDir}/{runId}/results/{accountId}/` 下文件。
+2. 先读各 `*.outline.txt`，再脚本读 `*.json` 聚合。
+3. 产出该账户报告片段或中间 CSV/JSON（路径回传）。
+
+**returnSchema**: 产出路径 + 该账户汇总摘要（数字须可追溯至 JSON 路径）。

package/dist/skill/snippets/handoff-p6-okki.md

@@ -0,0 +1,51 @@
+# Handoff · P6 OKKI 周报（供 Task / Bash 子会话）
+
+> 主 Agent 派发前已确认 `mediaCustomerId`、`--start`、`--end`。将下列占位符替换为实值。
+
+## 角色
+
+你是 siluzan-tso **拉数**子任务（或 **写 xlsx** 子任务，见阶段）。只执行指定命令或脚本，不向用户对话。
+
+## 阶段 A · 拉数（委派本阶段时使用）
+
+**snapDir**: `./snap-okki`（或主 Agent 指定路径）
+
+**forbidden**:
+
+- 禁止在回复中粘贴完整 JSON 内容
+- 禁止编造 mediaCustomerId
+- 禁止写 xlsx、禁止写操作类 CLI
+
+**commands**（在同一 snapDir 依次执行）:
+
+```bash
+mkdir -p ./snap-okki
+
+siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-okki
+
+siluzan-tso stats -m Google -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-okki
+
+siluzan-tso balance -m Google -a <mediaCustomerId> --json-out ./snap-okki
+
+siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-okki \
+  --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched
+```
+
+**returnSchema**: 仅回传 exitCode、manifestFile、writtenFiles、outlineFiles、stderrTail、summary（无编造数字）。
+
+## 阶段 B · 写 xlsx（委派本阶段时使用）
+
+**snapDir**: 同上（拉数已完成）
+
+**forbidden**:
+
+- 禁止在脚本中写死业务数字；数值只来自落盘 JSON
+- 禁止跳过 outline；先读 `*.outline.txt` 再读 JSON
+
+**任务**:
+
+1. Read `report-templates/okki-weekly-google-client.md` 中 xlsx 版式（若子会话可 Read skill 内路径）。
+2. 编写并执行 Node/Python 脚本，产出 `.xlsx` + 客户话术。
+3. 设备/国家 Sheet 必须用 `campaign-device` / `campaign-geo-matched` 落盘文件。
+
+**returnSchema**: 产出文件路径列表 + 脚本 exitCode；勿贴 xlsx 二进制内容。

package/dist/skill/snippets/handoff-p7-inquiry.md

@@ -0,0 +1,43 @@
+# Handoff · P7 Google 询盘分析（供 Task / Bash 子会话）
+
+> 主 Agent 已确认 3 个月窗口与 `mediaCustomerId`。询盘数据已在 `./snap-inquiry/inquiries.json`（流程 A/B 完成后）。
+
+## 变体 · 主 snap 拉数（单次）
+
+**snapDir**: `./snap-inquiry`
+
+```bash
+siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-inquiry
+siluzan-tso google-analysis -a <mediaCustomerId> \
+  --start <S> --end <D> \
+  --sections campaigns,keywords,search-terms,campaign-geo \
+  --json-out ./snap-inquiry
+```
+
+**forbidden**: 禁止编造询盘行；禁止 7 个月窗口。
+
+**returnSchema**: exitCode、writtenFiles、outlineFiles、stderrTail、summary。
+
+---
+
+## 变体 · 月度 m1 / m2 / m3（可并行 3 个子会话）
+
+| 子任务 | snapDir | 命令 |
+| ------ | ------- | ---- |
+| m1 | `./snap-inquiry/m1` | `google-analysis -a <id> --start <M1S> --end <M1E> --sections campaigns,geographic --json-out ./snap-inquiry/m1` |
+| m2 | `./snap-inquiry/m2` | 同上，M2 日期 |
+| m3 | `./snap-inquiry/m3` | 同上，M3 日期 |
+
+**forbidden**: 禁止用 `daily-metrics` 填 Sheet 4 上区；禁止主会话 Read 全量 JSON。
+
+**returnSchema**: 各目录 manifest + exitCode。
+
+---
+
+## 变体 · 写 8 Sheet xlsx（单次，主 Agent 或一个 Task）
+
+**snapDir**: `./snap-inquiry`（含 m1/m2/m3 子目录）
+
+**任务**: 读 `report-templates/google-inquiry-analysis.md` 版式；脚本读 JSON + `references/analytics/geo-continents.json`；产出 xlsx。
+
+**returnSchema**: xlsx 路径 + exitCode；勿贴表内全部单元格。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.23-beta.2",
+  "version": "1.1.24-beta.2",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",