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

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。
 
 ---
 
@@ -53,13 +55,26 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | `references/core/` | `agent-conventions.md` | 纪律、tips、playbooks、workflows |
 | `references/accounts/` | `accounts.md` | 列表、余额、MCC/BC、开户、发票 |
 | `references/google-ads/` | `google-ads.md` | CRUD、PMax、campaign-plan；`rules/` 优化 SOP |
-| `references/analytics/` | `account-analytics.md` | google-analysis、批处理、拓词、RAG |
+| `references/analytics/` | `account-analytics.md` | google-analysis、facebook-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` / 执行） |
@@ -67,6 +82,7 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | 任意任务（首次） | `core/agent-conventions.md` |
 | 账户列表 / 余额 / 消耗 / 分享 / MCC / 多账户汇总 | `accounts/accounts.md`；金额加 `accounts/currency.md` |
 | 拉数 / 报告 / 周报 / `google-analysis` | `analytics/account-analytics.md` + `core/tips.md`；多账户加 `analytics/google-analysis-batch.md` |
+| Meta/Facebook 周期或诊断报告 / `facebook-analysis` | `analytics/facebook-analysis-guide.md` + `report-templates/meta-period-report.md`（或 `meta-account-diagnosis-report.md`）+ `core/playbooks.md` P4-FB |
 | Google 新建搜索系列 | `google-ads/google-ads-campaign-plan.md` |
 | Google 广告 CRUD / 拒审 | `google-ads/google-ads.md` |
 | PMax | `assets/pmax-create-template.md` + `google-ads/pmax-api.md` |
@@ -75,9 +91,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 +113,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",
-  "publishedAt": 1780051263637
+  "version": "1.1.24-beta.3",
+  "publishedAt": 1780364315180
 }

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） |
 
 ## 账户与财务
 
@@ -39,6 +40,7 @@
 | 文件 | 用途 |
 | ---- | ---- |
 | `analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |
+| `analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |
 | `analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |
 | `analytics/reporting.md` | TSO 优化报告生成与推送 |
 | `analytics/rag.md` | 知识库 list/query |
@@ -71,3 +73,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/accounts/finance.md

@@ -131,10 +131,10 @@ siluzan-tso config show
 **示例：**
 
 ```
-- 现金充值（单笔）：https://www.siluzan.com/recharge/pay
-- 现金充值（批量）：https://www.siluzan.com/recharge/pay_batch
-- 月结充值：        https://www.siluzan.com/recharge/accountBillingQuota
-- 丝路赞钱包：      https://www.siluzan.com/recharge/siluzanWallet
+- 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
+- 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
+- 月结充值：        https://www-ci.siluzan.com/recharge/accountBillingQuota
+- 丝路赞钱包：      https://www-ci.siluzan.com/recharge/siluzanWallet
 ```
 
 ---

package/dist/skill/references/analytics/account-analytics.md

@@ -235,11 +235,11 @@ CLI 在落盘前为以下维度自动补「中文译名字段」（**原英文
 | `searchClickShare` | 搜索点击份额 |
 | `relativeCtr` | 相对点击率 |
 
-无竞争数据时 `competitiveMetrics` 为 `null`（或缺省）。写 Excel「x%」列：`(v * 100).toFixed(2) + '%'`。
+无竞争数据时 `competitiveMetrics` 为 `null`（或缺省）。`competitiveMetrics` 中均为 **0~1 小数**。写 Excel「x%」列：`(v * 100).toFixed(2) + '%'`。
 
-#### 行顶 legacy 份额（勿与 `competitiveMetrics` 混用）
+#### 行顶 legacy 份额（与 `competitiveMetrics` 同名 3 项）
 
-同一行仍保留 3 个行顶字段 `searchImpressionShare`、`searchBudgetLostImpressionShare`、`searchRankLostImpressionShare`，口径为 **0~100 百分数**（网关已 ×100）。分析 Top/AbsoluteTop/Content/ClickShare 等请用 `competitiveMetrics`；仅用行顶 3 项时按百分数理解，**禁止**与 `competitiveMetrics.*` 相加。
+`campaigns[]` / `keywords[]` 行顶仍保留 `searchImpressionShare`、`searchBudgetLostImpressionShare`、`searchRankLostImpressionShare`。CLI 落盘前已统一为 **0~1 小数**（与 `competitiveMetrics` 同名项一致；有嵌套时以 `competitiveMetrics` 为准）。Top/AbsoluteTop/Content/ClickShare 等扩展项仅存在于 `competitiveMetrics`。展示为百分比：`(v * 100).toFixed(2) + '%'`。
 
 ### campaign-hour 字段
 
@@ -247,13 +247,49 @@ CLI 在落盘前为以下维度自动补「中文译名字段」（**原英文
 
 ---
 
-## Meta 账户分析
+## Meta / Facebook Ads 账户分析
+
+> 周期/诊断报告：**`facebook-analysis`**（`FacebookAds` 路径，7 Section，对齐 Google 周期报告能 cover 的部分）。  
+> 撰写与 Google 对照表：**`references/analytics/facebook-analysis-guide.md`**（必读）。  
+> `report meta-overview` 仅为遗留单维总览（`MetaAd` 路径）。
+
+### 周期报告（默认 6 维，等同 Google 周期报告主流程）
 
 ```bash
-siluzan-tso report meta-overview -a <mediaCustomerId> [--start YYYY-MM-DD --end YYYY-MM-DD] --json-out <dir>
+mkdir -p ./snap-fb
+siluzan-tso facebook-analysis -a <mediaCustomerId> --start YYYY-MM-DD --end YYYY-MM-DD --json-out ./snap-fb \
+  --sections overview,ad-sets,platform,country,audience,creative
 ```
 
-`--start`/`--end` 须同传或同省略；省略默认近 7 天（截至昨天）。报告模板：`report-templates/meta-period-report.md`。
+| 选项 | 说明 |
+| --- | --- |
+| `-a, --account` | 数字 `mediaCustomerId` 或 `act_<数字>` |
+| `--json-out` | 必填；`report-manifest-<id>.json` + `<section>-<id>.json` |
+| `--sections` / `--exclude` | `overview` `ad-sets` `platform` `country` `audience` `creative` `material`；**别名**：`campaigns`→`ad-sets`，`geographic`→`country`，`devices`→`platform`，`ads`→`creative`，`materials`→`material` |
+| `--limit` | 仅 `country`：按 spend 降序前 N 条 |
+| `--start` / `--end` | 同传或同省略；省略=近 7 天截至昨天 |
+| `--concurrency` | 默认 5，上限 16 |
+
+```bash
+# 全 7 维（含 material）
+siluzan-tso facebook-analysis -a <id> --json-out ./snap-fb
+
+# 国家 Top 10
+siluzan-tso facebook-analysis -a <id> --sections country --limit 10 --json-out ./snap-fb
+```
+
+### 报告模板
+
+| 场景 | 模板 |
+| --- | --- |
+| 周期 / 月报 / 周报 | `report-templates/meta-period-report.md` |
+| 深度诊断 | `report-templates/meta-account-diagnosis-report.md` |
+
+遗留总览：`siluzan-tso report meta-overview -a <id> [--start … --end …] --json-out <dir>`。
+
+### 相对 Google 无法拉取的维度
+
+无 `daily-metrics`、`keywords`、`search-terms`、`extensions`、`final-urls`、`gold-account`、`ads-index`、`conversion-actions`、`resource-counts`、`campaign-types`、`campaign-hour` — 报告中须标注「接口未提供」，禁止编造。
 
 ---
 

package/dist/skill/references/analytics/facebook-analysis-guide.md

@@ -0,0 +1,111 @@
+# Facebook Ads 账户分析 — 字段与撰写指南
+
+> 拉数命令见 `account-analytics.md` § Meta / Facebook Ads。周期报告纲要见 `report-templates/meta-period-report.md`；诊断见 `report-templates/meta-account-diagnosis-report.md`。
+
+---
+
+## 与 Google 周期报告的能力对照
+
+| Google 默认/常见维度 | Facebook 对应 | CLI | 说明 |
+| -------------------- | ------------- | --- | ---- |
+| 执行摘要 `overview` | ✅ 本期/上期环比 | `overview` | 上一周期由后端自动算，勿再拉第二次 |
+| 每日趋势 `daily-metrics` | ❌ 无接口 | — | 报告中注明「Meta 报告无按日 Section」 |
+| 月度汇总 `dimension-summary` | ⚠️ 用 `overview` 单周期汇总代替 | `overview` | 仅 currentPeriod 即全区间汇总 |
+| 系列 `campaigns` | ⚠️ 广告组 + 行上 `campaignName` | `ad-sets` | 无独立 Campaign Section；可按 `campaignName` 聚合撰写 |
+| 设备 `devices` | ⚠️ 投放平台 | `platform` | `facebook` / `instagram` / `audience_network` 等 |
+| 地域 `geographic` | ✅ 国家 | `country` | 可选 `--limit N` |
+| 关键词 `keywords` | ❌ 无 | — | 非搜索广告；章节写「不适用」 |
+| 受众 `audience` | ⚠️ 年龄×性别 | `audience` | 无兴趣/自定义受众列表 |
+| 广告创意 `ads` | ✅ 创意+文案+缩略图 | `creative` | 一行 = ad + creative |
+| 图片/视频素材 `materials` | ⚠️ DC 素材 | `material` | 标准账户为空，用 `creative` |
+| 搜索词 / 附加信息 / 落地页 / 黄金账户 / 质量分 / 转化动作列表 / 系列类型 / 按小时 | ❌ 无 | — | 诊断模板中标注「Facebook 无此数据」 |
+
+**`--sections` 别名**（与 Google 习惯兼容）：`campaigns`→`ad-sets`，`geographic`→`country`，`devices`→`platform`，`ads`→`creative`，`materials`→`material`。
+
+---
+
+## 公共指标（JSON camelCase）
+
+### 基础
+
+| 字段 | 撰写展示 |
+| ---- | -------- |
+| `impressions` | 展示（整数） |
+| `clicks` | 点击 |
+| `spend` | 花费（账户币种，**非** micros） |
+| `ctr` | 点击率：**小数**，展示时 ×100 加 `%`（0.05 → 5%） |
+| `averageCpc` | 平均 CPC |
+| `conversions` | 业务转化次数（lead/purchase/messaging 等汇总） |
+| `costPerConversion` | CPA |
+| `conversionRate` | CVR（小数，×100 为 %） |
+
+### Facebook 扩展
+
+| 字段 | 撰写展示 |
+| ---- | -------- |
+| `reach` | 覆盖人数 |
+| `frequency` | 频次；>3 可提示创意疲劳 |
+| `resultType` | 结果类型（如 `lead`） |
+| `attributionSetting` | 归因（如 `7d_click`） |
+| `results` | 对齐 Meta「结果」列 |
+| `costPerResult` | 单次成效费用 |
+
+### 口径（必读）
+
+- **对客户/对齐后台**：优先 `results`、`costPerResult`。
+- **对内诊断**：可同时列 `conversions`、`costPerConversion`。
+- **禁止**：将 `creative` / `ad-sets` 各行 `results` 简单加总后与 `overview.currentPeriod.results` 对比（见 API 附录 B）。
+- **`material` 行**：无 `results` / `costPerResult`，只看 spend、转化、CTR、reach。
+
+---
+
+## 各 Section 文件与章节要点
+
+| section | 落盘文件 | 根字段 | 报告章节要点 |
+| ------- | -------- | ------ | ------------ |
+| `overview` | `overview-<id>.json` | `currentPeriod`, `previousPeriod` | 环比表：消耗、展示、点击、CTR、CPC、转化、CPA、结果、单次成效、reach、frequency；注明 `resultType` / `attributionSetting` |
+| `ad-sets` | `ad-sets-<id>.json` | `adGroups[]` | Top 组 by spend；`spendPercentage`；按 `campaignName` 归并；高消耗低结果组 |
+| `platform` | `platform-<id>.json` | `networks[]` | 各版位 spend 占比与 `costPerResult`；预算倾斜建议 |
+| `country` | `country-<id>.json` | `countries[]` | Top 国家；`countryOrRegion` 为展示名 |
+| `audience` | `audience-<id>.json` | `audiences[]` | 年龄×性别矩阵；高/低效人群段 |
+| `creative` | `creative-<id>.json` | `creatives[]` | 按 `creativeType` 汇总；Top 创意表（adName、title、spend、results、costPerResult） |
+| `material` | `material-<id>.json` | `materials[]`, `dataSource`, `message` | 仅 `dataSource===meta_asset_breakdown` 且有条目时写章节；否则一句说明 |
+
+---
+
+## 周期报告默认拉数
+
+```bash
+mkdir -p ./snap-fb
+siluzan-tso facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb
+# 等价显式：
+# --sections overview,ad-sets,platform,country,audience,creative
+```
+
+可选追加：`--sections material`（DC 账户）。
+
+国家 Top 10：整次命令加 `--limit 10`（仅 `country` 请求带 limit）。
+
+---
+
+## 优化建议撰写清单（不额外拉数）
+
+结合已拉维度，至少覆盖：
+
+1. **预算**：高 `spendPercentage` 但 `costPerResult` 差的 Ad Set → 降预算/暂停。
+2. **版位**：某 `network` CPA 明显差 → 减投或单独系列。
+3. **地域**：高消耗国家转化差 → 收窄/geo 排除。
+4. **受众**：低效 age×gender → 收窄定向。
+5. **创意**：关停高消耗低 `results` 的 ad；复制 winner 的 `creativeType`/文案结构。
+6. **频次**：`frequency` 过高 + 转化下滑 → 扩受众或换创意。
+7. **无法做的 Google 项**：按日趋势、关键词、质量分等 — 一句说明「接口未提供」，不编造。
+
+---
+
+## 辅助命令（非报告 Section）
+
+| 意图 | CLI |
+| ---- | --- |
+| 账户列表 | `list-accounts -m MetaAd -k <id> --json-out <dir>` |
+| 余额（若需） | `balance` / `stats`（口径与报告 spend 可能不同，须标注来源） |
+| 遗留仅总览 | `report meta-overview`（`MetaAd` 路径，不推荐替代 `facebook-analysis`） |

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/analytics/rag.md

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 

package/dist/skill/references/analytics/reporting.md

@@ -3,7 +3,7 @@
 > 所属 skill：`siluzan-tso`。
 >
 > 本文档仅覆盖 **TSO steward 优化报告**：列表、生成、删除、邮件推送与查看链接。  
-> **账户分析拉数**（`google-analysis`、`report tiktok-*`、`report bing-*`、`report meta-overview`）与**周期/诊断报告纲要**见 `references/analytics/account-analytics.md`。  
+> **账户分析拉数**（`google-analysis`、`facebook-analysis`、`report tiktok-*`、`report bing-*`、`report meta-overview`）与**周期/诊断报告纲要**见 `references/analytics/account-analytics.md`（Facebook 撰写见 `facebook-analysis-guide.md`）。  
 > **异步批量创建记录**（`ad batch`）见 `references/google-ads/google-ads.md` § ad batch。  
 > **AI 广告优化**（`optimize`）见 `references/operations/optimize.md`。  
 > **广告线索**（`clue`）见 `references/operations/clue.md`。
@@ -207,8 +207,8 @@ siluzan-tso report list -m Google --json-out ./snap
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

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,10 @@
 | 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` |
+| P4-FB | Meta/Facebook 周期报告 | `report-templates/meta-period-report.md`、`analytics/facebook-analysis-guide.md`、`analytics/account-analytics.md`、`core/tips.md` |
+| 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` |
 
 ---
 
@@ -61,17 +62,38 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 ## P4 · Google 账户周期报告
 
 1. 确认时间范围；区间 > 3 个月时分段（季度/月）。
-2. 按 P1 步骤拿数据，用 `report-templates/google-period-report.md` 模板输出，首行标注统计区间和货币。
+2. 按 `google-period-report.md` 默认维度执行 `google-analysis --json-out <dir>`。
 3. 报告须含：账户概览、投放趋势、Top 关键词/系列/地区分布、优化建议。
 
 ---
 
+## P4-FB · Meta/Facebook 账户周期报告
+
+1. `list-accounts -m MetaAd -k <mediaCustomerId> --json-out ./snap-fb` 确认账户。
+2. 确认 `--start` / `--end`（>3 个月可分段，与 P4 相同）。
+3. **一次批拉**（默认 6 维，对齐 Google 周期主章节）：
+
+   ```bash
+   siluzan-tso facebook-analysis -a <id> --start <S> --end <D> --json-out ./snap-fb \
+     --sections overview,ad-sets,platform,country,audience,creative
+   ```
+
+4. 按 `report-templates/meta-period-report.md` 撰写；字段与 Google 对照见 `analytics/facebook-analysis-guide.md`。
+5. 无按日趋势/关键词/质量分等：对应章节写「接口未提供」，**禁止编造**。
+6. 用户要素材 Tab 时追加 `--sections material`（或全量省略 `--sections`）。
+
+诊断场景改用 `report-templates/meta-account-diagnosis-report.md`，拉数可省略 `--sections` 拉全 7 维。
+
+---
+
 ## P5 · 多账户多维度报告
 
 > 适用：账户数 ≥ 2 且需拉取 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop。
 
 **入口选择**：全量 → 省略 `-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 +124,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 +139,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/setup.md

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -129,9 +129,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```
 

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/              # 拉数、批处理、拓词
@@ -52,7 +53,7 @@ siluzan-tso/                    # 安装后目录名
 
 - 从 SKILL.md **只链接一层**（`references/foo.md`），避免 A→B→C 链式引用。
 - 路径用正斜杠，不用 Windows 反斜杠。
-- 占位符 `https://www.siluzan.com`、`https://tso-api.siluzan.com`、`npm install -g siluzan-tso-cli` 由构建脚本替换，文档中禁止硬编码环境 URL。
+- 占位符 `https://www-ci.siluzan.com`、`https://tso-api-ci.siluzan.com`、`npm install -g siluzan-tso-cli@beta` 由构建脚本替换，文档中禁止硬编码环境 URL。
 
 ---
 
@@ -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 自主决策 |
 
 ---