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

package/README.md

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

package/dist/index.js

@@ -122757,6 +122757,411 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
   };
 }
 
+// src/commands/facebook-analysis/report-content.ts
+var RECOMMENDATION_TITLES = ["\u7B80\u5316\u8868\u5355\u95EE\u9898", "\u533A\u57DF\u8C03\u6574", "\u9884\u7B97\u91CD\u6784", "\u7D20\u6750\u5EFA\u8BAE"];
+var LIFECYCLE_PHASES = ["test-market", "find-winner", "scale"];
+function textLen(value) {
+  return typeof value === "string" ? value.trim().length : 0;
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function asRecord6(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function pushMissing(missing, id, chapter, dimension, hint) {
+  missing.push({ id, chapter, dimension, hint });
+}
+function countAdSetsWithSpend(tables) {
+  const rows = asArray(tables?.adSets);
+  return rows.filter((row) => {
+    const r = asRecord6(row);
+    const spend = r?.spend;
+    return isFiniteNumber(spend) && spend > 0;
+  }).length;
+}
+function chartLabels(chart) {
+  const c = asRecord6(chart);
+  return asArray(c?.labels).length;
+}
+function validateMetaPeriodReportContent(data) {
+  const missing = [];
+  const meta = asRecord6(data.meta) ?? {};
+  const kpis = asRecord6(data.kpis) ?? {};
+  const narrative = asRecord6(data.narrative) ?? {};
+  const tables = asRecord6(data.tables);
+  const charts = asRecord6(data.charts);
+  const sections = asRecord6(data.sections);
+  const health = asRecord6(data.healthDiagnosis);
+  const priorityPlan = asRecord6(data.priorityPlan);
+  const actionChecklist = asRecord6(data.actionChecklist);
+  const adSetsWithSpend = countAdSetsWithSpend(tables ?? void 0);
+  const regionalNarratives = asArray(narrative.regional).length;
+  const recommendations = asArray(narrative.recommendations);
+  const supplementary = asArray(data.supplementaryRecommendations);
+  const executiveSummary = asArray(data.executiveSummary);
+  const fourQuestions = asArray(health?.fourQuestions);
+  const scorecard = asArray(health?.scorecard);
+  const abTests = asArray(data.abTests);
+  if (!textLen(meta.accountName) && !textLen(meta.accountId)) {
+    pushMissing(
+      missing,
+      "meta-account",
+      "\u5143\u4FE1\u606F",
+      "\u8D26\u6237\u540D\u79F0\u6216 ID",
+      "meta.accountName \u6216 meta.accountId \u81F3\u5C11\u4E00\u9879\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 overview"
+    );
+  }
+  if (!textLen(meta.periodLabel) && !(textLen(meta.startDate) && textLen(meta.endDate))) {
+    pushMissing(
+      missing,
+      "meta-period",
+      "\u5143\u4FE1\u606F",
+      "\u62A5\u544A\u5468\u671F",
+      "meta.periodLabel \u6216 meta.startDate + meta.endDate"
+    );
+  }
+  for (const key of ["spend", "results", "costPerResult", "reach", "impressions", "frequency"]) {
+    if (!isFiniteNumber(kpis[key])) {
+      pushMissing(
+        missing,
+        `kpi-${key}`,
+        "KPI",
+        `\u8D26\u6237\u7EA7 ${key}`,
+        "kpis \u987B\u542B\u6709\u6548\u6570\u503C\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 overview"
+      );
+    }
+  }
+  if (chartLabels(charts?.platform) < 1) {
+    pushMissing(missing, "chart-platform", "\u6570\u636E\u56FE\u8868", "\u5E73\u53F0 CPL \u56FE", "charts.platform.labels \u81F3\u5C11 1 \u9879");
+  }
+  if (chartLabels(charts?.country) < 1) {
+    pushMissing(missing, "chart-country", "\u6570\u636E\u56FE\u8868", "\u56FD\u5BB6 CPL \u56FE", "charts.country.labels \u81F3\u5C11 1 \u9879");
+  }
+  if (chartLabels(charts?.audience) < 1) {
+    pushMissing(missing, "chart-audience", "\u6570\u636E\u56FE\u8868", "\u53D7\u4F17 CPL \u56FE", "charts.audience.labels \u81F3\u5C11 1 \u9879");
+  }
+  const funnel = asRecord6(charts?.funnel);
+  if (!isFiniteNumber(funnel?.reach)) {
+    pushMissing(missing, "chart-funnel", "\u6570\u636E\u56FE\u8868", "\u6F0F\u6597\u56FE reach", "charts.funnel.reach \u987B\u4E3A\u6709\u6548\u6570\u503C");
+  }
+  if (adSetsWithSpend < 1) {
+    pushMissing(
+      missing,
+      "table-adsets",
+      "\u6570\u636E\u8868\u683C",
+      "\u5E7F\u544A\u7EC4\u8868",
+      "tables.adSets \u81F3\u5C11 1 \u884C\u82B1\u8D39>0\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 ad-sets"
+    );
+  }
+  if (asArray(tables?.audienceTop).length < 1) {
+    pushMissing(missing, "table-audience-top", "\u6570\u636E\u8868\u683C", "\u53D7\u4F17 Top", "tables.audienceTop \u81F3\u5C11 1 \u884C");
+  }
+  if (asArray(tables?.audienceBottom).length < 1) {
+    pushMissing(
+      missing,
+      "table-audience-bottom",
+      "\u6570\u636E\u8868\u683C",
+      "\u53D7\u4F17 Bottom",
+      "tables.audienceBottom \u81F3\u5C11 1 \u884C"
+    );
+  }
+  if (textLen(narrative.overall) < 120) {
+    pushMissing(
+      missing,
+      "narrative-overall",
+      "\u603B\u6570\u636E\u53D9\u4E8B",
+      "narrative.overall",
+      "\u2265120 \u5B57\uFF0C\u542B\u82B1\u8D39/\u7EBF\u7D22/CPL/\u8986\u76D6/\u5C55\u793A/\u9891\u6B21\u7B49\u81F3\u5C11 5 \u9879\u6570\u5B57"
+    );
+  }
+  if (adSetsWithSpend > 0 && regionalNarratives < adSetsWithSpend) {
+    pushMissing(
+      missing,
+      "narrative-regional",
+      "\u603B\u6570\u636E\u53D9\u4E8B",
+      "narrative.regional",
+      `\u6BCF\u4E2A\u82B1\u8D39>0 \u7684\u5E7F\u544A\u7EC4\u5404 1 \u6BB5\uFF08\u5F53\u524D ${regionalNarratives}/${adSetsWithSpend}\uFF09`
+    );
+  } else if (regionalNarratives < 1) {
+    pushMissing(
+      missing,
+      "narrative-regional",
+      "\u603B\u6570\u636E\u53D9\u4E8B",
+      "narrative.regional",
+      "\u81F3\u5C11 1 \u6BB5\u533A\u57DF/\u5E7F\u544A\u7EC4\u5206\u6790\uFF0C\u6BCF\u6BB5 \u226580 \u5B57"
+    );
+  } else {
+    for (let i = 0; i < regionalNarratives; i++) {
+      const row = asRecord6(asArray(narrative.regional)[i]);
+      if (textLen(row?.text) < 80) {
+        pushMissing(
+          missing,
+          `narrative-regional-${i}`,
+          "\u603B\u6570\u636E\u53D9\u4E8B",
+          `narrative.regional[${i}]`,
+          "\u6BCF\u6BB5 \u226580 \u5B57\uFF0C\u542B\u7EC4\u540D\u3001\u82B1\u8D39\u3001CPL\u3001\u9891\u6B21"
+        );
+      }
+    }
+  }
+  if (textLen(narrative.country) < 80) {
+    pushMissing(
+      missing,
+      "narrative-country",
+      "\u603B\u6570\u636E\u53D9\u4E8B",
+      "narrative.country",
+      "\u226580 \u5B57\uFF0C\u542B CPL \u6700\u4F4E/\u6700\u9AD8\u56FD\u5BB6\u53CA\u5177\u4F53\u6570\u5B57"
+    );
+  }
+  if (recommendations.length !== 4) {
+    pushMissing(
+      missing,
+      "narrative-recommendations-count",
+      "\u4F18\u5316\u5EFA\u8BAE",
+      "narrative.recommendations",
+      "\u5FC5\u987B\u6070\u597D 4 \u6761\uFF08\u7B80\u5316\u8868\u5355/\u533A\u57DF\u8C03\u6574/\u9884\u7B97\u91CD\u6784/\u7D20\u6750\u5EFA\u8BAE\uFF09"
+    );
+  } else {
+    const titles = recommendations.map((r) => asRecord6(r)?.title);
+    for (const title of RECOMMENDATION_TITLES) {
+      if (!titles.includes(title)) {
+        pushMissing(
+          missing,
+          `narrative-rec-title-${title}`,
+          "\u4F18\u5316\u5EFA\u8BAE",
+          `\u56FA\u5B9A\u6807\u9898\u300C${title}\u300D`,
+          "4 \u6761 title \u987B\u4E0E\u89C4\u5219\u679A\u4E3E\u5B8C\u5168\u4E00\u81F4"
+        );
+      }
+    }
+    for (let i = 0; i < recommendations.length; i++) {
+      const rec = asRecord6(recommendations[i]);
+      if (textLen(rec?.content) < 150) {
+        pushMissing(
+          missing,
+          `narrative-rec-content-${i}`,
+          "\u4F18\u5316\u5EFA\u8BAE",
+          `recommendations[${i}].content`,
+          "\u6BCF\u6761 \u2265150 \u5B57\uFF0C\u5F15\u7528\u5F53\u6B21 CPL/\u56FD\u5BB6/\u7EC4\u540D\u7B49\u6570\u5B57"
+        );
+      }
+    }
+  }
+  if (supplementary.length < 7) {
+    pushMissing(
+      missing,
+      "supplementary-count",
+      "\u8865\u5145\u5EFA\u8BAE",
+      "supplementaryRecommendations",
+      "\u5FC5\u987B 7 \u7EF4\u6E05\u5355\u9F50\u5168\uFF08\u9884\u7B97/\u5E73\u53F0/\u5730\u57DF/\u53D7\u4F17/\u521B\u610F/\u9891\u6B21/\u63A5\u53E3\u9650\u5236\uFF09"
+    );
+  } else {
+    for (let i = 0; i < supplementary.length; i++) {
+      const row = asRecord6(supplementary[i]);
+      if (!textLen(row?.dimension) || !textLen(row?.issue)) {
+        pushMissing(
+          missing,
+          `supplementary-fields-${i}`,
+          "\u8865\u5145\u5EFA\u8BAE",
+          `supplementaryRecommendations[${i}]`,
+          "\u987B\u542B dimension\u3001issue\u3001suggestion"
+        );
+      }
+      if (textLen(row?.suggestion) < 60) {
+        pushMissing(
+          missing,
+          `supplementary-suggestion-${i}`,
+          "\u8865\u5145\u5EFA\u8BAE",
+          `supplementaryRecommendations[${i}].suggestion`,
+          "\u6BCF\u6761 suggestion \u226560 \u5B57\u4E14\u542B\u81F3\u5C11 1 \u4E2A\u5F53\u6B21\u6570\u5B57\u6216\u540D\u79F0"
+        );
+      }
+    }
+  }
+  for (const level of ["high", "medium", "low"]) {
+    const items = asArray(priorityPlan?.[level]).filter((s) => textLen(s) >= 40);
+    if (items.length < 2) {
+      pushMissing(
+        missing,
+        `priority-${level}`,
+        "\u4F18\u5148\u7EA7\u8BA1\u5212",
+        `priorityPlan.${level}`,
+        "\u9AD8/\u4E2D/\u4F4E\u5404 \u22652 \u6761\uFF0C\u6BCF\u6761 \u226540 \u5B57"
+      );
+    }
+  }
+  const summaryOk = executiveSummary.filter((p) => textLen(p) >= 80);
+  if (summaryOk.length < 3) {
+    pushMissing(
+      missing,
+      "executive-summary",
+      "\u6267\u884C\u6458\u8981",
+      "executiveSummary",
+      "3\uFF5E5 \u6BB5\uFF0C\u6BCF\u6BB5 \u226580 \u5B57\uFF0C\u89E3\u91CA\u300C\u4E3A\u4EC0\u4E48\u300D"
+    );
+  }
+  if (!LIFECYCLE_PHASES.includes(health?.lifecyclePhase)) {
+    pushMissing(
+      missing,
+      "health-phase",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.lifecyclePhase",
+      "\u987B\u4E3A test-market / find-winner / scale"
+    );
+  }
+  if (textLen(health?.lifecycleVerdict) < 60) {
+    pushMissing(
+      missing,
+      "health-verdict",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.lifecycleVerdict",
+      "\u226560 \u5B57\uFF0C\u7ED3\u5408\u603B\u82B1\u8D39\u4E0E\u7EF4\u5EA6\u5206\u6563\u5EA6"
+    );
+  }
+  if (fourQuestions.length !== 4) {
+    pushMissing(
+      missing,
+      "health-four-questions",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.fourQuestions",
+      "\u6070\u597D 4 \u5F20\u56DB\u95EE\u5361\u7247"
+    );
+  } else {
+    for (let i = 0; i < fourQuestions.length; i++) {
+      const q = asRecord6(fourQuestions[i]);
+      const evidence = asArray(q?.evidence).filter((e) => textLen(e) > 0);
+      if (evidence.length < 2) {
+        pushMissing(
+          missing,
+          `health-evidence-${i}`,
+          "\u5065\u5EB7\u8BCA\u65AD",
+          `fourQuestions[${i}].evidence`,
+          "\u6BCF\u6761 evidence \u22652 \u6761\u4E14\u542B\u6570\u5B57"
+        );
+      }
+      if (textLen(q?.action) < 40) {
+        pushMissing(
+          missing,
+          `health-action-${i}`,
+          "\u5065\u5EB7\u8BCA\u65AD",
+          `fourQuestions[${i}].action`,
+          "action \u226540 \u5B57"
+        );
+      }
+    }
+  }
+  if (scorecard.length < 6) {
+    pushMissing(
+      missing,
+      "health-scorecard",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.scorecard",
+      "\u7EA2\u7EFF\u706F\u8868 \u22656 \u884C\uFF08\u5E73\u53F0/\u56FD\u5BB6/\u5E7F\u544A\u7EC4/\u53D7\u4F17\u7B49\uFF09"
+    );
+  }
+  for (const key of ["platform", "country", "adSets"]) {
+    const insight = textLen(asRecord6(sections?.[key])?.insight);
+    if (insight < 200) {
+      pushMissing(
+        missing,
+        `sections-${key}`,
+        "\u6DF1\u5EA6\u89E3\u8BFB",
+        `sections.${key}.insight`,
+        "\u2265200 \u5B57\uFF0C\u5F15\u7528\u5F53\u6B21\u5E73\u53F0/\u56FD\u5BB6/\u5E7F\u544A\u7EC4\u6570\u636E"
+      );
+    }
+  }
+  const audience = asRecord6(sections?.audience);
+  if (asArray(audience?.goldenProfile).filter((s) => textLen(s) > 0).length < 3) {
+    pushMissing(
+      missing,
+      "sections-audience-golden",
+      "\u6DF1\u5EA6\u89E3\u8BFB",
+      "sections.audience.goldenProfile",
+      "\u22653 \u6761\u9EC4\u91D1\u53D7\u4F17\u753B\u50CF"
+    );
+  }
+  if (asArray(audience?.antiProfile).filter((s) => textLen(s) > 0).length < 2) {
+    pushMissing(
+      missing,
+      "sections-audience-anti",
+      "\u6DF1\u5EA6\u89E3\u8BFB",
+      "sections.audience.antiProfile",
+      "\u22652 \u6761\u53CD\u753B\u50CF"
+    );
+  }
+  if (textLen(audience?.insight) < 150) {
+    pushMissing(
+      missing,
+      "sections-audience-insight",
+      "\u6DF1\u5EA6\u89E3\u8BFB",
+      "sections.audience.insight",
+      "\u2265150 \u5B57"
+    );
+  }
+  const landingRows = asArray(asRecord6(sections?.landingPage)?.rows);
+  if (landingRows.length < 3) {
+    pushMissing(
+      missing,
+      "sections-landing",
+      "\u843D\u5730\u9875\u5206\u6790",
+      "sections.landingPage.rows",
+      "\u22653 \u884C\uFF08\u5FC3\u7406\u963B\u788D/\u6570\u636E\u4FE1\u53F7/\u63A8\u6F14/\u4F18\u5148\u7EA7\uFF09"
+    );
+  }
+  if (abTests.length < 3) {
+    pushMissing(
+      missing,
+      "ab-tests",
+      "A/B \u5B9E\u9A8C",
+      "abTests",
+      "\u22653 \u4E2A\u5B9E\u9A8C\uFF08\u53D8\u91CF\u3001\u5047\u8BBE\u3001\u6210\u529F\u6807\u51C6\uFF09"
+    );
+  }
+  const today = asArray(actionChecklist?.today).filter((s) => textLen(s) > 0);
+  const thisWeek = asArray(actionChecklist?.thisWeek).filter((s) => textLen(s) > 0);
+  const thisMonth = asArray(actionChecklist?.thisMonth).filter((s) => textLen(s) > 0);
+  if (today.length < 2 || thisWeek.length < 3 || thisMonth.length < 3) {
+    pushMissing(
+      missing,
+      "action-checklist",
+      "\u53EF\u6267\u884C\u6E05\u5355",
+      "actionChecklist",
+      "today \u22652\u3001thisWeek \u22653\u3001thisMonth \u22653 \u6761\u53EF\u6267\u884C\u9879"
+    );
+  }
+  return {
+    ok: missing.length === 0,
+    missing,
+    stats: {
+      recommendationCount: recommendations.length,
+      supplementaryCount: supplementary.length,
+      fourQuestionsCount: fourQuestions.length,
+      scorecardRows: scorecard.length,
+      regionalNarratives,
+      adSetsWithSpend
+    }
+  };
+}
+function formatMetaPeriodReportErrors(result) {
+  if (result.ok) return "";
+  const lines = result.missing.map((m) => `  - [${m.chapter}] ${m.dimension}\uFF1A${m.hint}`);
+  return [
+    `\u62A5\u544A JSON \u7F3A\u5C11 ${result.missing.length} \u9879\u5FC5\u542B\u5185\u5BB9\uFF08\u5BF9\u9F50 meta-period-report-rules.md\uFF09\uFF1A`,
+    ...lines,
+    "",
+    "\u8BF7 Read assets/meta-period-report-rules.md\uFF0C\u8865\u5168 meta-period-report.json \u540E\u91CD\u65B0\u6267\u884C render\u3002",
+    "\u6570\u636E\u7C7B\u5B57\u6BB5\u53EF\u5148 facebook-analysis --json-out\uFF0Crender \u65F6\u52A0 --snapshot-dir \u81EA\u52A8\u5408\u5E76 KPI/\u56FE\u8868/\u8868\u683C\u3002"
+  ].join("\n");
+}
+
 // src/commands/facebook-analysis/render-report.ts
 var TEMPLATE_BASENAMES2 = {
   html: "meta-period-report.html",
@@ -122789,7 +123194,7 @@ async function readJsonFile2(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord6(value) {
+function asRecord7(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -122804,10 +123209,22 @@ function injectReportData2(html, payload) {
 }
 async function runFacebookAnalysisRender(opts) {
   const dataPath = path24.resolve(opts.dataFile);
-  let data = asRecord6(await readJsonFile2(dataPath));
+  let data = asRecord7(await readJsonFile2(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeFacebookSnapshotIntoReport(data, path24.resolve(opts.snapshotDir));
   }
+  const contentCheck = validateMetaPeriodReportContent(data);
+  if (!contentCheck.ok) {
+    console.error(`
+\u274C ${formatMetaPeriodReportErrors(contentCheck)}
+`);
+    const { stats: stats2 } = contentCheck;
+    console.error(
+      `   \u7EDF\u8BA1\uFF1A\u5EFA\u8BAE ${stats2.recommendationCount}/4\uFF5C\u8865\u5145 ${stats2.supplementaryCount}/7\uFF5C\u56DB\u95EE ${stats2.fourQuestionsCount}/4\uFF5C\u7EA2\u7EFF\u706F ${stats2.scorecardRows}/6\uFF5C\u533A\u57DF\u53D9\u4E8B ${stats2.regionalNarratives}/${stats2.adSetsWithSpend}
+`
+    );
+    process.exit(1);
+  }
   const templatePath = metaPeriodReportTemplatePath();
   let html;
   try {
@@ -122833,9 +123250,14 @@ async function runFacebookAnalysisRender(opts) {
     runtimeCopied = true;
   } catch {
   }
+  const { stats } = contentCheck;
   console.log(`
 \u2705 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
 `);
+  console.log(
+    `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u5EFA\u8BAE ${stats.recommendationCount}\uFF5C\u8865\u5145 ${stats.supplementaryCount}\uFF5C\u56DB\u95EE ${stats.fourQuestionsCount}\uFF5C\u7EA2\u7EFF\u706F ${stats.scorecardRows}
+`
+  );
   if (runtimeCopied) {
     console.log(`   \u8FD0\u884C\u65F6\u811A\u672C\uFF1A${runtimeOut}
 `);
@@ -122997,7 +123419,7 @@ function registerFacebookAnalysisCommands(program2) {
   );
   root.addCommand(registerBatchCommand(sectionHelp), { isDefault: true });
   root.command("render").description(
-    "\u6839\u636E Agent \u64B0\u5199\u7684\u62A5\u544A JSON \u751F\u6210 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u7EC8\u7A3F\uFF08meta-period-report.html\uFF09"
+    "\u6839\u636E Agent \u64B0\u5199\u7684\u62A5\u544A JSON \u751F\u6210 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u7EC8\u7A3F\uFF08\u6821\u9A8C\u5FC5\u542B\u5B57\u6BB5\uFF0C\u7F3A\u9879\u62D2\u7EDD\u6E32\u67D3\uFF09"
   ).requiredOption("--data <file>", "Agent \u4EA7\u51FA\u7684 meta-period-report.json").option(
     "--snapshot-dir <dir>",
     "\u53EF\u9009\uFF1Afacebook-analysis --json-out \u76EE\u5F55\uFF0C\u81EA\u52A8\u5408\u5E76 KPI / \u56FE\u8868 / \u8868\u683C"

package/dist/skill/AGENTS.md

@@ -4,9 +4,12 @@
 
 ## 启动顺序
 
-1. Read `SKILL.md`（路由 + 任务→文档表）
+1. Read `SKILL.md`（单一路由表：意图 → 工作流 → 必读文档）
 2. **每个新任务** Read `references/core/agent-conventions.md`
-3. 按任务表 Read 对应域文档后再执行 `siluzan-tso …`
+3. 按路由表 Read「必读文档」与对应工作流卡片，再执行 `siluzan-tso …`：
+   - 分析/报告类线性步骤 → `references/core/playbooks.md`（P1–P9）
+   - 操作/管理类线性步骤 → `references/core/workflows.md`（W1–W12）
+   - 命令参数/字段口径 → 各域 `references/*.md`
 4. **P5 / P6 / P7** 或长 CLI 输出：可选 Read `references/core/subagent-orchestration.md`（主 Agent 自行决定是否委派 subagent）
 
 ## 文档域（gstack-style domains）
@@ -21,11 +24,17 @@
 | **Operations** | `references/operations/` | 预警、线索、优化记录、宿主编排自动化 |
 | **Templates** | `assets/`、`report-templates/` | JSON 契约、报告纲要 |
 
-## Playbook（标准动作）
+## 工作流目录
+
+| 类别 | 文档 | 编号 |
+| --- | --- | --- |
+| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9 |
+| 操作 / 管理类 | `references/core/workflows.md` | W1–W12 |
+
+专用报告模板（被工作流卡片引用）：
 
 | ID | 文档 |
 | --- | --- |
-| P1–P9 | `references/core/playbooks.md` |
 | 网站诊断 | `report-templates/website-diagnosis-report.md` |
 | 战略市场分析 | `report-templates/market-analysis-report.md` |
 | OKKI 周报 | `report-templates/okki-weekly-google-client.md` |