siluzan-tso-cli 1.1.28-beta.3 → 1.1.28-beta.5

package/README.md

@@ -31,7 +31,7 @@
 
 ### 报告模板外部资源
 
-HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`fonts.googleapis.com`。渲染报告时浏览器会发出对应网络请求。
+HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.js`；其余样式/脚本可能引用 `cdn.tailwindcss.com`、`cdnjs.cloudflare.com`、`fonts.googleapis.com` 等。
 
 ## 1. 环境
 
@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.28-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.28-beta.5），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -121873,7 +121873,9 @@ async function runWebsiteDiagnosisRender(opts) {
 `);
   console.log(`   \u8FD0\u884C\u65F6\u811A\u672C\uFF1A${runtimeOut}
 `);
-  console.log("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u56FE\u8868\u4E0E\u5B8C\u6574\u7AE0\u8282\uFF08\u9700\u8054\u7F51\u52A0\u8F7D ECharts CDN\uFF09\u3002\n");
+  console.log(
+    "\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u56FE\u8868\u4E0E\u5B8C\u6574\u7AE0\u8282\uFF08ECharts\uFF1Astaticpn.siluzan.com/homeCDN/echarts.js\uFF09\u3002\n"
+  );
 }
 
 // src/commands/website-diagnosis/register.ts

package/dist/skill/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: siluzan-tso
-description: Operates Siluzan TSO ad accounts via siluzan-tso-cli (Google/Bing/Yandex/TikTok/Kwai/MetaAd). Tasks (accounts) list, balance, stats, spend, active-bills, history, balance-scan P2, accounts-digest P3, share/unshare, delink, OAuth, MCC/BC/BM bind-unbind, email invite, TikTok close, suspend withdraw; (open-account) apply on 6 media; (Google Ads) campaign/adgroup/ad/keyword CRUD, extensions, geo, PMax, search campaign-plan validate/create, batch async create; (analytics) google-analysis, google-analysis-batch P5, facebook-analysis P4-FB, website-diagnosis P8, market-analysis P9, ads diagnosis; (reports) P1 profile, P4 period, P6 OKKI weekly, P7 inquiry; (tools) keyword suggest, RAG query, TSO report list/create/push, AI optimize records, forewarning rules, TikTok/Meta leads, transfer/invoice/invoice-info, audit restore. Use when user mentions ad accounts, balance, spend, campaigns, keywords, open account, MCC/BC, reports, diagnosis, market analysis, invoicing, or TSO. Re-read references/core/agent-conventions.md each new task.
+description: 通过 siluzan-tso-cli 操作丝路赞 TSO 广告账户（Google/Bing/Yandex/TikTok/Kwai/MetaAd）。（账户）列表、余额、统计、消耗、激活账单、历史、余额扫描 P2、账户摘要 P3、共享/取消共享、解绑、OAuth、MCC/BC/BM 绑定解绑、邮件邀请、TikTok 关闭、暂停撤回；（开户）六大媒体申请；（Google Ads）系列/广告组/广告/关键词 CRUD、附加信息、地理位置、PMax、搜索投放方案校验/创建、批量异步创建；（分析）google-analysis、google-analysis-batch P5、facebook-analysis P4-FB、网站诊断 P8、市场分析 P9、广告诊断；P1 账户画像、P4 周期报告、P6 OKKI 周报、P7 询盘分析；Google关键词推荐、RAG 检索、TSO 报告列表/创建/推送、智能预警、TikTok/Meta 线索、转账/发票/发票资料、审计恢复。当用户提及广告账户、余额、消耗、投放、关键词、开户、MCC/BC、报告、诊断、市场分析、开票或 TSO 时使用。
 license: MIT
-compatibility: Requires Node.js 18+, siluzan-tso-cli installed, authenticated via send-login-code + login or config set
+compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
 metadata:
   requires: nodejs,siluzan-tso-cli
 allowed-tools: Bash(siluzan-tso:*) Read Write
@@ -44,13 +44,14 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 
 ---
 
-## 可执行的操作范围
 
-| 级别 | 示例 |
-| ---- | ---- |
-| **只读** | 账户列表、余额、消耗、报告、预警记录、Google Ads 查询 |
-| **写入**（需用户确认） | 创建/修改广告、开户申请、预警规则、报告推送 |
-| **破坏性**（确认 + `--commit`） | 账户解绑/关闭、MCC/BC 解绑、删除预警/报告/广告、发票申请 |
+## 基本使用
+
+siluzan-tso-cli只是报名, 安装后可执行的命令是 siluzan-tso 
+
+```bash
+siluzan-tso -h // 查看帮助
+```
 
 ---
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.28-beta.3",
-  "publishedAt": 1780909080666
+  "version": "1.1.28-beta.5",
+  "publishedAt": 1780990385456
 }

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

@@ -142,7 +142,7 @@ siluzan-tso facebook-analysis render \
 ```
 
 - `--snapshot-dir`：与拉数 `--json-out` 同目录；CLI 自动合并 KPI、平台/国家/受众图表、广告组与受众表格。
-- 模板：`report-templates/meta-period-report.html` + `meta-period-report.runtime.js`（Chart.js CDN）。
+- 模板：`report-templates/meta-period-report.html` 。
 - JSON 字段说明：见 `report-templates/meta-period-report.md` § Agent JSON 结构。
 
 ---

package/dist/skill/references/core/cli-enums.md

@@ -1,5 +1,3 @@
-<!-- 本文件由 `pnpm --filter siluzan-tso-cli run gen:cli-enums` 自动生成，勿手改。源码：src/cli-enums/registry.ts -->
-
 # CLI 枚举速查
 
 > **Agent**：不确定 `--sections`、`-m`、`--operator` 等合法值时，**Read 本文件**（按章节）或执行：

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

@@ -159,7 +159,7 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 
 ## 国家 → 大洲映射
 
-- **数据源**：`references/analytics/geo-continents.json`（中文国家名 → 7 大洲，覆盖 200+ 主权国家 + 港澳台/巴勒斯坦/马恩岛/波多黎各等领土，由 `tso-cli/scripts/generate-geo-dictionaries.mjs` 与 `geo-en2zh.json` 同步生成；新增国家请加 `ISO_TO_CONTINENT` 映射后跑 `pnpm --filter siluzan-tso-cli run geo:generate`，**不要**手改 JSON）。
+- **数据源**：`references/analytics/geo-continents.json`
 - **默认 7 桶**：`亚洲` / `中东` / `欧洲` / `北美` / `南美` / `非洲` / `大洋洲`。
 - **运营常用 5 桶合并**（与样表 Sheet 3 一致）：`<重点国>` / `中东` / `非洲` / `欧美` / `亚洲(除重点国)`。**由脚本在写表前做二次合并**，伪代码：
 

package/dist/skill/report-templates/meta-period-report.html

@@ -4,7 +4,8 @@
 <meta charset="UTF-8"/>
 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
 <title>Meta / Facebook 周期分析报告</title>
-<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.1/dist/chart.umd.min.js"></script>
+
+<script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
 <style>
 :root{--bg:#0f1419;--card:#1a2332;--text:#e7ecf3;--muted:#8b9cb3;--green:#22c55e;--yellow:#eab308;--red:#ef4444;--accent:#3b82f6;--border:#2d3a4f}
 *{box-sizing:border-box}
@@ -617,13 +618,27 @@ ${renderChecklist(data.actionChecklist)}
   }
 
   function boot() {
-    if (window.__META_PERIOD_REPORT__) {
+    var data = window.__META_PERIOD_REPORT__;
+    if (!data) return;
+    function run() {
       if (document.readyState === "loading") {
-        document.addEventListener("DOMContentLoaded", () => renderReport(window.__META_PERIOD_REPORT__));
+        document.addEventListener("DOMContentLoaded", function () {
+          renderReport(data);
+        });
       } else {
-        renderReport(window.__META_PERIOD_REPORT__);
+        renderReport(data);
       }
     }
+    if (typeof window.__loadChartJs === "function") {
+      window.__loadChartJs(function (err) {
+        if (err) {
+          console.warn("[meta-period-report]", err.message);
+        }
+        run();
+      });
+    } else {
+      run();
+    }
   }
 
   boot();

package/dist/skill/report-templates/report-template-academic.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   风格：专业学术（论文式层级、衬线标题、低饱和配色、弱装饰、表格偏「期刊」）
   与 report-template.html 区块结构、data-section-id 一致，可互换填充数据。
@@ -46,7 +46,7 @@
       crossorigin="anonymous"
       referrerpolicy="no-referrer"
     />
-    <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+    <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
     <style>
       @media print {
         body {

package/dist/skill/report-templates/report-template-dark.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   风格：演示 / 深色屏显（会议室投屏、深色控制台并列）
   与 report-template.html 的 data-section-id 一致。另见 README 中其它模板。
@@ -30,7 +30,7 @@
       crossorigin="anonymous"
       referrerpolicy="no-referrer"
     />
-    <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+    <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
     <style>
       @media print {
         body {

package/dist/skill/report-templates/report-template-formal.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   风格：正式文件 / 公文式（红头线、居中标题、黑框表格、中文序号「一、二、」、少彩色装饰）
   与 report-template.html 区块结构、data-section-id 一致，可互换填充数据。
@@ -39,7 +39,7 @@
       crossorigin="anonymous"
       referrerpolicy="no-referrer"
     />
-    <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+    <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
     <style>
       @media print {
         body {

package/dist/skill/report-templates/report-template-mobile.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   风格：移动端优先（窄屏单列、大触控留白、表格横向滑动提示）
   与 report-template.html 的 data-section-id 一致；桌面端随 sm: 断点渐进为多列。
@@ -30,7 +30,7 @@
       crossorigin="anonymous"
       referrerpolicy="no-referrer"
     />
-    <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+    <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
     <style>
       @media print {
         body {

package/dist/skill/report-templates/report-template-onepager.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   风格：对客营销单页（Executive one-pager）
   首屏叙事 + 主 KPI + 主图；第 2–6 节默认折叠（<details>），展开后结构与 report-template.html 一致、data-section-id 不变。
@@ -29,7 +29,7 @@
       crossorigin="anonymous"
       referrerpolicy="no-referrer"
     />
-    <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+    <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
     <style>
       details > summary {
         list-style: none;

package/dist/skill/report-templates/report-template-print.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   风格：极简黑白 / 打印优先（灰阶、无阴影、无圆角装饰、状态不完全依赖色相）
   与 report-template.html 的 data-section-id 一致。打印时图表仍为灰度；正式印刷可导出 PDF 后转灰。
@@ -18,7 +18,7 @@
       crossorigin="anonymous"
       referrerpolicy="no-referrer"
     />
-    <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+    <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
     <style>
       /* 屏幕上也保持「纸面」灰阶；打印增强对比 */
       body {

package/dist/skill/report-templates/report-template.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   siluzan-ads 报告 HTML 样式参考（供 AI / 脚本生成成品 HTML 时对齐版式）
 
@@ -25,7 +25,7 @@
   技术栈（均支持 CDN，单文件可离线打开需网络加载资源）：
   - Tailwind CSS (cdn.tailwindcss.com)：布局、间距、响应式、打印友好浅色底
   - Font Awesome 6 (cdnjs.cloudflare.com)：列表与状态图标（类名稳定，便于 AI 输出）
-  - ECharts 5 (cdn.jsdelivr.net)：时序、构成、对比（与广告报表 JSON 数组结构天然契合）
+  - ECharts 5 (staticpn.siluzan.com/homeCDN/echarts.js)：时序、构成、对比（与广告报表 JSON 数组结构天然契合）
 
   ⚠ 外部网络声明：在浏览器中打开本 HTML 文件时，会向上述 CDN 域名发出网络请求加载样式/脚本。
   如需离线使用，请将对应资源下载到本地并替换下方 <script>/<link> 的 src/href。
@@ -76,7 +76,7 @@
       referrerpolicy="no-referrer"
     />
     <!-- ECharts 5：图表 -->
-    <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+    <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
     <style>
       /* 打印时尽量白底；与 Tailwind Play CDN 并存 */
       @media print {

package/dist/skill/report-templates/website-diagnosis-report.html

@@ -1,4 +1,4 @@
-<!doctype html>
+<!doctype html>
 <!--
   网站诊断报告 — 对齐 MarkAI WebsiteAnalysisReport/v3（ChatContent → WebsiteGuide）
 
@@ -19,7 +19,7 @@
       if (dark) document.documentElement.setAttribute("data-theme", "dark");
     })();
   </script>
-  <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
+  <script src="https://staticpn.siluzan.com/assets/slz/homeCDN/chart.umd.min.js"></script>
   <style>
     * {
       box-sizing: border-box;

package/dist/skill/report-templates/website-diagnosis-report.md

@@ -49,7 +49,7 @@ siluzan-tso website-diagnosis render --data ./diagnosis.json [--collect ./collec
 ## 样式与文件约定
 
 - 单文件 HTML，`lang` 与用户语言一致（默认 `zh-CN`）。
-- 可引用 CDN：Tailwind / ECharts（与 `report-template.html` 相同，见该文件头部说明）。
+- ECharts 统一引用：`https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.js`（与 `report-template.html` 相同）。
 - 落盘建议与 `--json-out` 同目录：`website-diagnosis-report.html`。
 - **推荐生成方式**：`siluzan-tso website-diagnosis render --data <diagnosis.json> [--collect <collect.json>]`
 - **禁止**只交付 Markdown 或纯 JSON 当作最终报告（JSON 可作为中间产物）。

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.28-beta.3'
+$PKG_VERSION = '1.1.28-beta.5'
 $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.28-beta.3"
+readonly PKG_VERSION="1.1.28-beta.5"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

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

package/dist/skill/docs/skill-guide.md

@@ -1,44 +0,0 @@
-# Siluzan TSO Skill — 人类导读
-
-Agent 运行时请用 `SKILL.md` + `AGENTS.md`；本文供维护者与产品经理深读。
-
-## 设计理念（对齐 gstack）
-
-1. **薄入口**：`SKILL.md` 仅路由，<150 行
-2. **域化 references**：`core/`、`accounts/`、`google-ads/`、`analytics/`、`operations/`
-3. **渐进披露**：Playbook、参数表、SOP 按需 Read，不塞进主文件
-4. **模板分离**：`assets/*.json` 契约 vs `report-templates/*.md` 内容纲要
-
-## 目录树
-
-```
-siluzan-ads/
-├── AGENTS.md              # Agent 域目录（类似 gstack AGENTS.md）
-├── SKILL.md               # 路由入口
-├── docs/skill-guide.md    # 本文件
-├── references/
-│   ├── core/              # 纪律、安装、playbooks
-│   ├── accounts/          # 账户、开户、财务
-│   ├── google-ads/        # CLI 命令 + rules/ SOP
-│   ├── analytics/         # 拉数、批处理、拓词
-│   └── operations/        # 预警、线索、自动化
-├── assets/                # JSON/MD 创建契约
-└── report-templates/      # 报告纲要 + HTML 样式
-```
-
-## 常见维护任务
-
-| 任务 | 改哪里 |
-| --- | --- |
-| 新 CLI 命令 | `src/commands/` + 对应 `references/<域>/` |
-| 新 Playbook | `references/core/playbooks.md` + `SKILL.md` 任务表 |
-| 环境 URL | `scripts/write-defaults.mjs` + `copy-skill-assets.mjs` |
-| 发布 Skill | `npm run build:prod` → `siluzan-tso init --force` |
-
-## 与 eval 的关系
-
-场景 JSON 中 `judgeReferencePaths` 须使用域路径，例如 `references/accounts/accounts.md`。改文档后运行：
-
-```bash
-pnpm --filter siluzan-tso-cli run eval:export-cases
-```

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

@@ -1,196 +0,0 @@
-# Agent SKILL 最佳实践（siluzan-tso 维护指南）
-
-本文档基于 [Agent Skills 开放规范](https://agentskills.io/specification) 与 [Cursor Skills 文档](https://cursor.com/docs/skills)，结合 siluzan-skill monorepo 的 TSO 实践，供维护 `tso-cli/assets/siluzan-ads/` 时对照。
-
----
-
-## 1. 协议要点（agentskills.io）
-
-### 1.1 目录结构
-
-```
-siluzan-tso/                    # 安装后目录名
-├── AGENTS.md                   # Agent 域目录（gstack 风格）
-├── SKILL.md.tmpl → SKILL.md    # 构建生成
-├── snippets/                   # 共享注入块
-├── docs/skill-guide.md         # 人类导读
-├── snippets/                   # agent-preamble、handoff-p5/p6/p7（构建时注入 SKILL 或随包复制）
-├── references/
-│   ├── core/                   # 纪律、安装、playbooks、subagent-orchestration
-│   ├── accounts/               # 账户、开户、财务
-│   ├── google-ads/             # CLI + rules/
-│   ├── analytics/              # 拉数、批处理、拓词
-│   └── operations/             # 预警、线索、自动化
-├── assets/
-└── report-templates/
-```
-
-源码位于 `tso-cli/assets/siluzan-ads/`，构建时 `copy-skill-assets.mjs` 替换占位符后写入 `dist/skill/`。
-
-### 1.2 SKILL.md  frontmatter
-
-| 字段 | 要求 | siluzan-tso 用法 |
-| ---- | ---- | ---------------- |
-| `name` | 小写+连字符，≤64 字，**须与安装目录名一致** | `siluzan-tso`（非 `siluzan-ads`） |
-| `description` | ≤1024 字，**第三人称**，含 WHAT + WHEN + 触发词 | 列出媒体、开户、Google Ads、报告、预警等 |
-| `license` | 可选 | `MIT` |
-| `compatibility` | 可选，≤500 字，环境依赖 | Node 18+、`siluzan-tso-cli`、鉴权 |
-| `metadata` | 可选键值 | `requires: nodejs,siluzan-tso-cli` |
-| `allowed-tools` | 可选（实验性） | `Bash(siluzan-tso:*) Read Write` |
-| `disable-model-invocation` | Cursor 扩展 | TSO 需自动激活，**不设** true |
-
-### 1.3 渐进式披露（三层加载）
-
-| 层级 | 内容 | Token 预算建议 |
-| ---- | ---- | -------------- |
-| L1 元数据 | `name` + `description` | ~100 tokens，启动时索引 |
-| L2 指令 | `SKILL.md` 正文 | <500 行，<5000 tokens，激活时加载 |
-| L3 资源 | `references/`、`assets/`、`report-templates/` | 任务相关时才 Read |
-
-**原则**：SKILL.md 只做路由与不可妥协的纪律；参数表、Playbook 步骤、优化 SOP 放 references。
-
-### 1.4 文件引用规则
-
-- 从 SKILL.md **只链接一层**（`references/foo.md`），避免 A→B→C 链式引用。
-- 路径用正斜杠，不用 Windows 反斜杠。
-- 占位符 `https://www-ci.siluzan.com`、`https://tso-api-ci.siluzan.com`、`npm install -g siluzan-tso-cli@beta` 由构建脚本替换，文档中禁止硬编码环境 URL。
-
----
-
-## 2. 内容编写原则
-
-### 2.1 简洁（Concise is Key）
-
-Agent 已具备通用能力。文档只写 **CLI 特有** 内容：字段口径、批量命令、门禁流程、与前端不一致处。
-
-❌ 解释「什么是 Google Ads」  
-✅ `budgetAmountYuan` 已是元，禁止再 ÷100
-
-### 2.2 单一术语
-
-全库统一：
-
-| 概念 | 统一用词 | 禁止混用 |
-| ---- | -------- | -------- |
-| 广告账户 ID | `mediaCustomerId` | customer id、账户号（无上下文时） |
-| 实体 ID | `entityId` | 内部 id |
-| 落盘 | `--json-out` | --json-out ./snap（已移除） |
-| 媒体 | `Google`、`TikTok`、`MetaAd`… | google、meta |
-
-### 2.3 默认 + 逃生口
-
-每个决策点给一个默认路径，例外单独一行：
-
-```markdown
-全量 Google 批处理：省略 `-a`（CLI 内部拉清单）。
-仅当用户明确给出 ID 子集时才传 `-a id1,id2,...`。
-```
-
-### 2.4 反馈环（Feedback Loop）
-
-写操作文档须含：**写命令 → 读命令复核 → 失败时查 reference**。
-
-破坏性操作统一：**用户确认 → `--commit` → 读命令验证**。
-
-### 2.5 禁止时间敏感表述
-
-不写「2025 年 8 月前用旧 API」。废弃内容放 `## 已废弃` 折叠或删除。
-
----
-
-## 3. siluzan-tso 文档分层
-
-| 文件 | 职责 |
-| ---- | ---- |
-| `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 参数） |
-| `assets/*.json` / `*.md` | 创建类 JSON 契约 |
-| `report-templates/*.md` | 报告内容纲要（优先于 HTML） |
-| `report-templates/*.html` | 视觉样式，**不含业务数据** |
-| `README.md` | 给「通过 URL 安装」的大模型说明（不进 dist 路由） |
-
-### 3.1 与 CLI 代码同步
-
-**代码变更 → 必须同步 Skill**（tutorial-10 #2）。新命令注册在 `_register.ts` / `index.ts` 后：
-
-1. 更新对应 `references/*.md`
-2. 更新 `SKILL.md` 路由表（若新功能域）
-3. 评估场景：`tso-cli/eval/scenarios/` + `pnpm --filter siluzan-tso-cli run eval:export-cases`
-
-### 3.2 灰度开关（tutorial-10 #11）
-
-| 状态 | CLI 注册 | SKILL 文档 | AI 可见 |
-| ---- | -------- | ---------- | ------- |
-| 内测 | 是 | 否 | 否 |
-| 公开 | 是 | 是 | 是 |
-
----
-
-## 4. description 写法模板
-
-```yaml
-description: >-
-  Operates Siluzan TSO ad accounts via siluzan-tso-cli: Google/Bing/Yandex/TikTok/Kwai/Meta
-  account management, Google Ads CRUD, analytics, optimization reports, forewarning, leads,
-  invoicing, and RAG knowledge lookup. Use when the user mentions ad accounts, balance, spend,
-  campaigns, keywords, PMax, open account, MCC/BC binding, or TSO reporting.
-  Each new task requires re-reading routed references per SKILL.md.
-```
-
-中文项目可保留中文 description，但仍须：**第三人称 + 能力列表 + 触发场景 + 重读纪律一句**。
-
----
-
-## 5. 体积与质量检查清单
-
-发布前逐项确认：
-
-### Frontmatter
-- [ ] `name` === 安装目录名 `siluzan-tso`
-- [ ] `description` 含 WHAT、WHEN、关键词
-- [ ] `compatibility` 列出 Node + CLI + 鉴权
-
-### SKILL.md
-- [ ] 正文 < 500 行
-- [ ] 无重复 parameters 表（细节在 references）
-- [ ] 路由表覆盖所有 `references/*.md` 入口
-- [ ] Playbook 仅索引，步骤在 `core/playbooks.md`
-
-### References
-- [ ] 每个 CLI 命令族有且仅有一个主 reference
-- [ ] 含 `--json-out` 示例（查询类）
-- [ ] 写命令含 `--commit` 与复核命令
-- [ ] 无断链（如 `accounts/open-account-by-media.md` 必须存在）
-
-### 构建
-- [ ] `pnpm run build:tso:test` 后 `dist/skill/SKILL.md` 占位符已替换
-- [ ] `_meta.json` 版本与 package.json 一致
-
----
-
-## 6. 反模式（Avoid）
-
-| 反模式 | 正确做法 |
-| ------ | -------- |
-| SKILL.md 内嵌 200 行 Playbook | 移至 `references/core/playbooks.md` |
-| Agent 用 `--json` 落大 JSON 到对话 | 一律 `--json-out` + 脚本读盘 |
-| 路由表缺文件 | 补文件或删链接 |
-| google-ads-rules 深链三层 | SKILL → `google-ads/rules/README.md` → 具体规则 |
-| HTML 模板假数据当示例 | 纲要 `.md` 定义维度，数据来自 CLI |
-| 凭记忆跨任务复用参数 | 每任务重读 `core/agent-conventions.md` § 加载纪律 |
-| 固定 `agents/` 与 skill 双源维护 | 用 `subagent-orchestration.md` + handoff snippets，主 Agent 自主决策 |
-
----
-
-## 7. 相关仓库文档
-
-- `.cursor/rules/tutorial-05-core/skill-authoring.mdc` — 项目内 Skill 结构速查
-- `.cursor/rules/tutorial-10-best-practices.mdc` — CLI + Skill 同步等 12 条
-- `cso-cli/assets/siluzan-cso/SKILL.md` — 姊妹包参考（命令索引表风格）
-- https://agentskills.io/specification — 开放规范原文