sino-bc-cli 1.0.0-beta.0

package/dist/skill-manifest.json

@@ -0,0 +1,336 @@
+{
+  "formatVersion": 1,
+  "skillFormat": 3,
+  "packageName": "sino-bc-cli",
+  "version": "1.0.0-beta.0",
+  "skills": [
+    {
+      "name": "sino-bc-cli",
+      "description": "查找 BeyondClick API 能力或区分相近业务域时使用；也用于 CLI 环境检查、技能安装与刷新。已核实目标 API Skill 时可直接读取该 Skill。",
+      "role": "navigation",
+      "layer": "root",
+      "sourcePath": "skills/sino-bc-cli",
+      "entryPath": "skills/sino-bc-cli/SKILL.md",
+      "files": {
+        "SKILL.md": "b3eaeb206e150edf885a7f4f8bd1453be11c5bf7d0e81177477842f38dcb4b1b",
+        "references/domain-index/module-8534789.md": "44afc5c053796bd2f266ad1847ae2bbda0cbeff2346c1848dc268d62de05fee5",
+        "references/domain-index/module-8551546.md": "d66ad239715fb4a9d8a6ed28ac99ae9fc03cf19c4177f53c71a8065d9a85bfe1",
+        "references/domain-index/module-8562638.md": "1ff991cdbf67835b413f53affe2696b6300583c8cd9e8d43ff029a1abcada329",
+        "references/domain-index/module-8566367.md": "adc8cb895c7f4de7984017ad8a5d188b1041851dbb5d85bcaab29ca963a2708d",
+        "references/domain-index/module-8581524.md": "94f7ef014e3cabc6c4b760617b8bd447553c2e950419fd553b9e4ba226d08b84",
+        "references/domain-index/module-8601540.md": "b08f04b0c592ccdcda675bb294ac887b7e10cb06acdb31242b098d836162f569",
+        "references/domain-index/module-8614891.md": "95ff3046cd7d703b5b663db8556c075e15919102c0988bc28868ed6fe2e2f8ed",
+        "references/domain-index/module-8621792.md": "2a06147ab91319b7bf81aa78e9b09d7804104fe08d8e267ee7b90259a84bc1ad"
+      }
+    },
+    {
+      "name": "sino-bc-shared",
+      "description": "sino-bc-cli 的共用执行规则；API 调用前读取，按条件处理主体绑定、写入确认、 鉴权恢复，以及配置、输出和技能安装维护。",
+      "role": "shared",
+      "layer": "default",
+      "sourcePath": "skills/default/sino-bc-shared",
+      "entryPath": "skills/sino-bc-shared/SKILL.md",
+      "files": {
+        "SKILL.md": "6163bcaee7b3567b822e350baf9bd446c22ce9ff9664c0f1576f677f8ae81f3f",
+        "references/auth-recovery.md": "b4ff0d29c2928f5512a91ceef47a06cce5fe09420bbecd7240aea413262f3b5f",
+        "references/config-and-env.md": "76a641572c3b5e0a135c474690799152d94600d1a2a84d5ae20e312fc0d58311",
+        "references/output-contract.md": "6b4f841d98e112889b0c2769b52997316c682b073ef5c36984d03f1e11091819",
+        "references/skill-lifecycle.md": "aea58a214d3a9a7e7a858fe2502e2794b3417d1e27405e8f8ab1a93d6c0b1c20",
+        "references/tenant-context.md": "54c706295ac117d8c99949465c3654f002652a68562235b969bfd448477c0218",
+        "references/write-approval.md": "aa0994cbb8cf9f58b21beae30abe17ff1efd1970efe745555a11f327ce0cc305"
+      }
+    },
+    {
+      "name": "sino-bc-auth",
+      "description": "查询或操作 BeyondClick 身份令牌与浏览器授权（auth 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-auth",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-auth/SKILL.md",
+      "files": {
+        "SKILL.md": "64b4c0511ecd6753a46184535d78fb21abed8c5cc652eabf47570ce24386128d"
+      }
+    },
+    {
+      "name": "sino-bc-bill",
+      "description": "查询或操作 BeyondClick 财务对账单查询（bill 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-bill",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-bill/SKILL.md",
+      "files": {
+        "SKILL.md": "e99ad5f1f609b3d08fe442577e8e38480ea2211bfa07a883afad902cb785ef9a"
+      }
+    },
+    {
+      "name": "sino-bc-biz-line",
+      "description": "查询或操作 BeyondClick 业务线、已有周策略、投放品类、策略标签、关联项目。完整的策略生成并导出 Excel 任务使用 biz-line-strategy-generate。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-biz-line",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-biz-line/SKILL.md",
+      "files": {
+        "SKILL.md": "80653d249159d8d6b69850dc3c1ad49268acb71b28f5b1466ffdb4d2c45b366c",
+        "references/common-mistakes.md": "3b8a4fbe77618e5564a7ac7800f54f8787f15e3c05a318c609df7055b0ab3d51",
+        "references/enums.md": "5746d8b0475cd7e6af0b0a0648ef2e090b1751aade03e4e5cf0cce99c4c1661f"
+      }
+    },
+    {
+      "name": "sino-bc-biz-line-ai-strategy",
+      "description": "查询或操作 BeyondClick AI 策略保存、历史记录、使用日志与正式策略快照（biz-line-ai-strategy 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-biz-line-ai-strategy",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-biz-line-ai-strategy/SKILL.md",
+      "files": {
+        "SKILL.md": "a0ee8f22280f846665fb0b4351965e8114cbb5d0817c03f656faacf04b4283e0"
+      }
+    },
+    {
+      "name": "sino-bc-biz-line-metrics",
+      "description": "查询或操作 BeyondClick 广告策略维度与成效数据（biz-line-metrics 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-biz-line-metrics",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-biz-line-metrics/SKILL.md",
+      "files": {
+        "SKILL.md": "85940ea23b616b06b712ed4e22dd767c52edbb468159d9c9ef16bb914c7d19e5"
+      }
+    },
+    {
+      "name": "sino-bc-common-file",
+      "description": "查询或操作 BeyondClick 通用文件上传与按 storageKey 取下载链接（common-file 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-common-file",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-common-file/SKILL.md",
+      "files": {
+        "SKILL.md": "8c6913c6e39e8d415c251d3941d57e48ad036ba21bf19a939dd663ea89014c7b"
+      }
+    },
+    {
+      "name": "sino-bc-dashboard",
+      "description": "查询或操作 BeyondClick 营销协同看板：预算分布、项目分布与关键项目时间轴（dashboard 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-dashboard",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-dashboard/SKILL.md",
+      "files": {
+        "SKILL.md": "3dc0fbcf42701c8a016f6b322a1e90346bd5991ff214e9451d8371a55f71618f"
+      }
+    },
+    {
+      "name": "sino-bc-dict",
+      "description": "查询或操作 BeyondClick 营销协同通用字典：按用途查询场景与按场景查询条目（dict 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-dict",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-dict/SKILL.md",
+      "files": {
+        "SKILL.md": "8c5515f7349e12943507c666c56734162d88f10229585a5d74c28953dac4f37f"
+      }
+    },
+    {
+      "name": "sino-bc-document",
+      "description": "查询或操作 BeyondClick 营销协同文档中心、文件上传与对象存储记录（document 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-document",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-document/SKILL.md",
+      "files": {
+        "SKILL.md": "41ea332a2e7961d1b3014da803d93b057a1a990862e5c4d3454ac729724badf4"
+      }
+    },
+    {
+      "name": "sino-bc-im",
+      "description": "查询或操作 BeyondClick 营销协同飞书群消息（im 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-im",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-im/SKILL.md",
+      "files": {
+        "SKILL.md": "a242e8023b58dfbd9e497302c0e0e0a5cc0d04e3c98c59f2c22da8e83b100fa8"
+      }
+    },
+    {
+      "name": "sino-bc-invoice",
+      "description": "查询或操作 BeyondClick 发票结算单与发票文件下载（invoice 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-invoice",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-invoice/SKILL.md",
+      "files": {
+        "SKILL.md": "67552bc0e86538c97cc853b720a9b190476c70ddc817ed76aa6a8ec660d251ad"
+      }
+    },
+    {
+      "name": "sino-bc-media",
+      "description": "查询或操作 BeyondClick 广告投放媒体：投放渠道等媒体字典（media 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-media",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-media/SKILL.md",
+      "files": {
+        "SKILL.md": "28629567232007ebae1ae059902f011c796bfb18a21fc22bdf0e39c0f683ccce"
+      }
+    },
+    {
+      "name": "sino-bc-organization",
+      "description": "查询或操作 BeyondClick 组织架构、团队成员与当前用户（organization 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-organization",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-organization/SKILL.md",
+      "files": {
+        "SKILL.md": "d0b3b5abb6b6bd65ef6a3580c1b435b9ec06e442a61ec12ee40c48b9bbe796ad"
+      }
+    },
+    {
+      "name": "sino-bc-project",
+      "description": "查询或操作 BeyondClick 营销协同项目生命周期、成员、阶段、项目文档、投放阶段Tab及群关系（project 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-project",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-project/SKILL.md",
+      "files": {
+        "SKILL.md": "0926f7ac9ee664ea4abe3dd48e9771c5ca78a0d3537328578d3a6d23ec038d9b"
+      }
+    },
+    {
+      "name": "sino-bc-project-analysis",
+      "description": "查询或操作 BeyondClick 优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出（project-analysis 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-project-analysis",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-project-analysis/SKILL.md",
+      "files": {
+        "SKILL.md": "6008b4bc8d6bf20bf1c5bc26212bd36fab39694ff4a75a2c045e6466e8156ffa",
+        "references/analysis-workflow.md": "c718e826210d713511a130ff90bff002f34c390fc22c6e7015f70b8f9c96dd86",
+        "references/filters-and-metrics.md": "2d29cb95e92c1793cd949b738529ec8e7e7e2f94f26e6ca284d76efa59ace597"
+      }
+    },
+    {
+      "name": "sino-bc-quota",
+      "description": "查询或操作 BeyondClick 后付额度查询（quota 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-quota",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-quota/SKILL.md",
+      "files": {
+        "SKILL.md": "598dc0626f92069c5de9de0025fe9822837a6eaf0f99e2a75ccb5745219ac896"
+      }
+    },
+    {
+      "name": "sino-bc-reconciliation",
+      "description": "查询或操作 BeyondClick 月度对账文件与邮件记录（reconciliation 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-reconciliation",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-reconciliation/SKILL.md",
+      "files": {
+        "SKILL.md": "0057ce7259af96469076a674d832c63c8c7d0ecb7db30f4f60980af39bc5ce0d"
+      }
+    },
+    {
+      "name": "sino-bc-report",
+      "description": "查询或操作 BeyondClick 营销协同Campaign归集、投放阶段指标、花费、KPI与维度下钻（report 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-report",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-report/SKILL.md",
+      "files": {
+        "SKILL.md": "acc85cc8cc916d650dc416e1e05bb7e4ad89a3587bc75ab0c7b090f4b8ca580f"
+      }
+    },
+    {
+      "name": "sino-bc-sso-team-group",
+      "description": "查询或操作 BeyondClick 优化组别选项、组长、成员与行业信息（sso-team-group 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-sso-team-group",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-sso-team-group/SKILL.md",
+      "files": {
+        "SKILL.md": "1642554c99dea33c49dbe2369df0ab4dc2c49d13ce8d1681baf5af9b48420404"
+      }
+    },
+    {
+      "name": "sino-bc-task",
+      "description": "查询或操作 BeyondClick 营销协同任务：交付闭环与操作日志（task 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-task",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-task/SKILL.md",
+      "files": {
+        "SKILL.md": "58485480af067728f1cb68664cee7a2212a154935e3cbe9e8fd67bfc805687a8",
+        "references/state-machine.md": "3b6421012992906fddb3107a8fe3559f1f642f699dfa7c614f237027ec81107f"
+      }
+    },
+    {
+      "name": "sino-bc-tenant",
+      "description": "查询或操作 BeyondClick 签约主体（tenant 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-tenant",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-tenant/SKILL.md",
+      "files": {
+        "SKILL.md": "f10479f7b5e3902705d0af759a4e63e1f3278e1a0ead74c105297dd06686994a"
+      }
+    },
+    {
+      "name": "sino-bc-user",
+      "description": "按 userId 或姓名查询 BeyondClick SSO 用户资料、列表及签约主体用户资料；签约主体用户使用 body corporationId。当前组织登录态查询使用 organization。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-user",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-user/SKILL.md",
+      "files": {
+        "SKILL.md": "dd1e7ddce8dddffc54f68851e64c44473b4a9f0c687246a94696fe08b28218a6"
+      }
+    },
+    {
+      "name": "sino-bc-wallet",
+      "description": "查询或操作 BeyondClick 预付钱包、充值与流水查询（wallet 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-wallet",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-wallet/SKILL.md",
+      "files": {
+        "SKILL.md": "75fc6be7941924efa1a23c83537a13e5ebca3282e9984c407c33715266fe5ba2"
+      }
+    },
+    {
+      "name": "biz-line-strategy-generate",
+      "description": "Use when 用户要为 BeyondClick 业务线生成投放策略（预算/广告产品/受众/素材四大策略及效果 learning）、导出 Excel 或将生成结果写入数据库。典型说法：\"帮我生成第一页的业务线策略\"、\"把前 10 个业务线生成策略并入库\"、\"给名称为 xxx 的业务线生成策略\"。默认交付桌面 Excel；明确要求入库时上传 Excel 并保存 AI 策略。不负责单条接口的原始查询（走 sino-bc-biz-line）。",
+      "role": "expert",
+      "layer": "custom",
+      "sourcePath": "skills/custom/biz-line-strategy-generate",
+      "entryPath": "skills/biz-line-strategy-generate/SKILL.md",
+      "files": {
+        "SKILL.md": "d7e961b2e2df03b40099a9f7467d1016f2a31fb0c3bbb5bfba1c1bc9cd301072",
+        "references/ai-strategy-prompt.md": "f7529bbed0638de4d69fe440803bb2421cd681b528dd83665973b0557c66cde0",
+        "references/api-flow.md": "c98ffddc9f5a9022cfd2f4f9046670e1c7ff2f4292ebe47c5ca8d5d17a71e243",
+        "references/four-strategies.md": "3bf1cf21a378dd292068abe3fc5d041df17b11f01714eece441a41f8315c07d3",
+        "references/metrics.md": "6580dd77493599b33f31b5769f0933274636b382b5d156e0b2caca1201e29f89",
+        "references/output-excel.md": "df362020644ffe3b553c22358c434b7a8f61efc4079bf7c162ee136f16afa24a",
+        "references/runtime.md": "74245409a2a429ff9efe177fcfa5b3660bf88a6a3863e1f630e96c4eca613079",
+        "references/spec.md": "bc10054168404e079bb874df31ffebcd8a86372c63b925997d57e72a2699f273",
+        "scripts/ai_strategy.py": "6f6e9c570e68de47ede283083cb7a66b59751aaa19e88fa1dd206fe793b31eb6",
+        "scripts/build_report.py": "3eae8c91a980cd9bdc2edd02ad304aada07b9047c90e1162114afdec0534acdc",
+        "scripts/cleanup.py": "eb1e1c338d543070623c39fa82c6908e53f30787cdb26cfdd238dca9a794b965",
+        "scripts/cli_json.py": "98163f916427254f7a6826000a047271f02729172b1b9783cbfa09105c37fae3",
+        "scripts/fetch_data.py": "6167313eed1fa4efa57fbdffc4cfd22e4898f049e9563b5dcb655da2ecacc5ec",
+        "scripts/run_workflow.py": "cbebfa51ab59903b0307d3df5fe6217546eb7eab6bb6b036a4b4b369422eb02f",
+        "scripts/strategy_output.py": "0c2bff83bf638b0a30fb22f99efc4e94774dc70fb3bbdea442dfa97964f1a215",
+        "scripts/submit_tags.py": "f2ccb631a9b55d8f41420d10d978811e90792eff8815e2ba58bfcb40cc3cf53f",
+        "scripts/summarize.py": "879ad9c9f6b5f78e6b05f4c8137d8e7207eb9926b024173d792b844e06eef942",
+        "scripts/test_ai_strategy.py": "a1849975a07540dda84f23af0f784ff0041239b7fc0fc98658d7765190958b33",
+        "scripts/test_cli_json.py": "06282041b783280bb4e877f37fdf09b93e2f075ed103ac409374fcd2f5837d8e",
+        "scripts/test_database_output.py": "a61aefe8685b9e24e3a25e72b7d7150c34953b04486cad58b79f7b2c04977cd3",
+        "scripts/test_pipeline.py": "aa20204f76d89c847c0e7f6a0670eb09cda02b6e4b18a1901623fe436ab17bbc",
+        "scripts/test_strategy_rules.py": "775cddbc6aa5190d23d780aceeec595eb8c35b6850484c7ab9d6dec9a862f0fe",
+        "scripts/test_tag_submission.py": "18535ace32138c3c90b98ca429c5b4dd7d8320bd9c61b864b1ba96991a377252",
+        "scripts/test_workflow.py": "05e39b53830bd49a382f9534dc3f68faa3e93d8e29acab9bf3f354b86b8cb3f4"
+      }
+    }
+  ]
+}

package/dist/skills/biz-line-strategy-generate/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: biz-line-strategy-generate
+description: Use when 用户要为 BeyondClick 业务线生成投放策略（预算/广告产品/受众/素材四大策略及效果 learning）、导出 Excel 或将生成结果写入数据库。典型说法："帮我生成第一页的业务线策略"、"把前 10 个业务线生成策略并入库"、"给名称为 xxx 的业务线生成策略"。默认交付桌面 Excel；明确要求入库时上传 Excel 并保存 AI 策略。不负责单条接口的原始查询（走 sino-bc-biz-line）。
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+      - python3
+---
+
+# 业务线策略生成
+
+本技能随 CLI 安装，需要 Python 3。复用现有业务线、广告成效与 AI 策略接口，按固定分析规则和 Excel 模板生成四大策略与 learning，默认拉数和AI各最多3条、全流程合计最多6条滑动在途。每条独立导出一份 Excel（依次为 `策略`、`明细`、`AI策略` 三张表），校验成功后清理本次其他临时文件。AI 策略由执行本技能的 Agent 只读取独立提示词及本条明细-only 工作簿后撰写，脚本不代写投放分析。执行入口与参数见下方「Agent 流程」。
+
+输出默认 `excel`（桌面，可指定目录）。用户明确说“写入数据库/入库/保存到平台”时用 `database`：在临时目录生成 Excel，通用上传成功后删除本次 Excel，将 `storageKey` 与策略一起保存。不可生成时只保存具体状态和原因，不制造空 Excel。
+
+**开始前 MUST 先读 [`../sino-bc-shared/SKILL.md`](../sino-bc-shared/SKILL.md)**。业务线查询先读 [biz-line](../sino-bc-cli/domains/sino-bc-biz-line/SKILL.md)，维度与成效查询前读 [biz-line-metrics](../sino-bc-cli/domains/sino-bc-biz-line-metrics/SKILL.md)，数据库保存前读 [biz-line-ai-strategy](../sino-bc-cli/domains/sino-bc-biz-line-ai-strategy/SKILL.md)。
+
+口径来自 2026-09-17 策略优化沟通：主表以总结为主，新增/暂停各不超过5个时列出名称，全量明细进第二张表；learning 有上期按2%改善判断，无上期按目标阈值判断。
+
+## When to Use
+
+- 「生成业务线策略 / 投放策略 / 策略 learning」并要产出文件
+- 「第一页 / 前 N 个 / 名称为 xxx」；用户指定账号则覆盖接口账号
+
+不要用本技能处理：只查列表/详情/项目（走 `biz-line +list` 等）。
+
+## Agent 流程
+
+使用本技能目录的 **`scripts/run_workflow.py`**，不要临时重写拉数、分析或排版脚本。执行前定位技能的绝对路径；Python 只需标准库。首次使用读取 [`references/runtime.md`](references/runtime.md)。
+
+1. 第一步先查询业务线。用户给名称，传 `--name`；命中多个候选则返回歧义。用户给多个 ID，重复传 `--id`。用户要第一页/前 N 条，先用既有 `biz-line +list --data` 选出真实 ID，再在**一次入口调用**中传入。
+2. 入口默认**拉数最多3条、标签/AI及收尾最多3条、总在途最多6条**。任意一条完成拉数和固定分析就交接阶段名额并滑动补拉下一条，不等待另外两条。`--concurrency 1/2/3` 表示每阶段上限，总在途最多2/4/6，不能大于3。同一批次不要并排启动多个入口绕开限制；单条内部 CLI 请求和分页串行。分页回包只落到本次临时目录的 `*.pN.out.json`，由脚本写 `*.pages.json` 索引；**禁止**在对话里重写拉数脚本、把各页 `extend` 进内存或再拼一份 `merged.json`。分析按页迭代，不要把全表读进 list。
+3. 查询并唯一确定业务线后，先读取 `adCategoryIndustryIds`：这是所属行业 ID 列表，多个只取第一个，将该 ID 转成字符串作为 `filterCondition`，分别查询 `BUDGET_STRATEGY`（预算）、`MEDIA_STRATEGY`（广告产品）、`AUDIENCE_STRATEGY`（受众）。素材不查标签。标签在项目预检和广告取数前加载，同一批次按行业 ID 缓存三类完整字典，同行业（含并发）复用，不同行业分别查询；不硬编码三个行业的 ID、不跨任务缓存。移除人工 `--strategy-filter-condition` 参数。缺少有效首个行业 ID 时为不可重试配置失败：入库模式在真实业务线和合法周期下只保存一次 GENERATION_FAILED 及原因，本地模式只报告；字典为空或接口失败仍按原技术失败处理。不改取第二个行业、不编造标签。标签必须逐类分析该业务线实际策略正文与本行业候选标签的含义，不只比较固定动作词或同名。先选最贴切且有内容依据的标签，只有逐一评估后确无合适项才选“其他”；两次审核均失败时才自动用本场景真实“其他”兜底。Excel 展示名称，入库传对应 ID；兜底时若某场景没有“其他”，仅该策略标签为空，其正文和 learning 照常生成。
+4. 每条执行现拉 → 固定分析 → Agent 按内容选择标签 → 生成并校验双表草稿 → 另生成并校验只含 `明细` sheet 的 AI 输入 → Agent 按独立提示词生成 AI 策略 → 生成并回读校验三表最终 Excel。脚本每次出现 `tag_review_required` 时，Agent 必须立即按 `references/runtime.md` 的文件协议读取该次正文和候选标签，从本次候选选择 `choiceKey` 和理由，通过 `scripts/submit_tags.py` 回读请求、映射真实 ID 并提交后继续等待；这是内部分析，不需要用户逐条确认。回包被拒或等待超时仅重试标签选择，含首次最多 2 次、每次最多 7 分钟，不重新拉数或分析；各次路径和审核 ID 均不同。脚本出现 `ai_strategy_required` 时按同一参考文档处理本条 AI 请求；AI 阶段含首次最多 3 次，失败后本条整体失败，不重新拉数。分析阶段用可返回进度的 session 或不超过 5 秒的短等待及时接手事件，避免脚本空等；只保留总在途上限内的有限预取等待，不另建无界审核队列；取得AI名额才发审核请求，排队不计入7/15分钟超时。按执行机器当地日期计算：本期默认上周一至周日，上期默认上上周一至周日，不使用业务线返回的周期。每批开始时固定一次默认日期；用户指定哪一期就覆盖哪一期，未指定的仍按自然周计算。日期覆盖成对传 `--curr-start/--curr-end`、`--prev-start/--prev-end`。数据库模式只接受已结束的完整自然周，当前契约支持 2026-09-07 起。
+5. 默认发布桌面 Excel 后清理其他本次临时产物，返回 `output_path`。数据库模式不传 `--output-dir`，先回读最终 `AI策略` sheet 并预检四类正文、learning、效果和三类标签，再上传并删除本次 Excel，携带 `fileStorageKey` 保存，返回 `aiStrategyId`、`storageKey`。不要在脚本结束后手工重复上传或保存。
+6. 数据库模式分页获取全部关联项目，按 `lastWeekSpend` 预检：无项目→`NO_PROJECT`；全部明确为 0→立即保存 `NO_DELIVERY_DATA`；至少一项 >0 才继续。不要用 `isLast7DSpend`。未知/缺失值不当作 0。渠道只依据 `biz-line +project-list`（`/biz-line/project-list`）全部项目的 `adAccounts`，不使用项目分页的 `channelIdList`；全部广告账号只能属于 Facebook/Meta、Google、TikTok 中一个或多个，有其他或未知渠道→`UNSUPPORTED_CHANNEL`，不能静默丢弃。账号有 `channelId` 时通过 `media +channels` 解析，以 ID 为准，缺 ID 才用 `channelName`；全部账号为空→`NO_AD_ACCOUNT`；目标周期无消耗→`NO_DELIVERY_DATA`。显式账号覆盖不绕过此校验，本地导出同样校验关联账号渠道。
+7. 非 READY 写具体原因，处理异常写 `GENERATION_FAILED`；未知业务线/非法周期不能伪造写入。保存本身失败或结果未知时不重试、不补写失败状态，报告已有 key。清理失败报告残留；不交付已删除文件。不同业务线独立交付；某条失败先继续其他业务线，整轮全部结束后再统一重跑失败项，每条最多执行 3 次（含首次）。成功项及已保存的不可生成业务状态不重跑；保存结果未知、清理失败或已交付文件的条目停止并报告，避免重复写入或交付。重试规则见 `references/runtime.md`。
+
+```bash
+python3 -B <本技能绝对路径>/scripts/run_workflow.py --name "用户指定的业务线名称"
+python3 -B <本技能绝对路径>/scripts/run_workflow.py --id <真实ID1> --id <真实ID2> --concurrency 3 --output-mode database
+```
+
+`--output-dir` 指定最终目录，默认桌面；`--task-root` 指定持久工作根，默认启动 cwd，所有临时产物放在其 `strategy_task/启动日期/tmp/` 内，禁止使用系统 TEMP 或技能目录。用户明确指定账号时使用可重复的 `--account-fb/--account-gg/--account-tt`；这些覆盖参数用于本次调用全部业务线，账号范围不同须分别请求并遵守并发上限。
+
+不要人工改 payload 再二次导出，或导入另一工作簿库重排。固定分析与 learning 规则见 [`references/metrics.md`](references/metrics.md)；策略写法见 [`references/four-strategies.md`](references/four-strategies.md)。
+
+**标签提交有两层格式，不能混用**：AI 仅把 `choiceKey`、`reason` 交给 `scripts/submit_tags.py`；最终响应文件中的整数 `id`、`choiceKey`、`reason` 及顶层身份由脚本自动组装，禁止 AI 直接写 `response_path`。脚本报格式错误时按类别/下标/字段修正输入后重交，本次7分钟计时不重置；格式示例与规则见 [`runtime.md`](references/runtime.md)「Agent 按策略内容选择标签」。
+
+## 主表 vs 明细
+
+| 位置 | 写什么 |
+| --- | --- |
+| `策略` sheet（16 列，一业务线一行，不按文字长度拆行） | 预算/广告产品/受众正文前各放标签名称列；总结金额+占比、出价升/降数量与中位数、分布在、国家等设置新增/暂停分别不超过5个时列全名称，超过5个仅写数量；素材无标签 |
+| `明细` sheet（35 列） | 仅策略维度：明细数据、动作、渠道、id、名称、指标 sheet 的 29 个指标、补充；同一维度 ID 的按日基础值先合计，再算衍生指标 |
+| `AI策略` sheet（最后一张） | 一条业务线只占一行；速览与四大策略横向展示，预算、广告产品、受众策略前各有一列直接复制第一张表的对应标签，创意无标签。Learning 留在各策略正文内。Agent 只依据本条明细-only 工作簿和 [`AI 策略提示词`](references/ai-strategy-prompt.md) 撰写；前两表保持原内容；数据库 READY 正文、效果及 Learning 取本表，标签核对后传已审核 ID |
+
+各维度新增、暂停分别计数，1～5个列出完整名称，0个隐藏该动作，新增与暂停均为0则显示未出现变化，超过5个收起名称。广告组和广告按各动作跨渠道总数判断，超过5个展示“分布在”，不超过5个直接列名称。调价广告组正文不展示名称、分布或逐组调价值，只展示非零动作数量；完整调价明细在明细表。
+
+明细首列只写维度名称（预算、出价、广告目标、广告系列类型、成效目标、出价方式、国家、兴趣词包、受众类型、关键词、年龄、性别、广告组、广告、创意类型），不写周期覆盖、项目、`新增成效/`、`/分布` 或其他说明类型。出价保留上调/下调/期内变化但首末持平，其他维度仅新增、暂停、持续。`id` 写对应枚举原值或广告/广告组 ID。指标单元格是本期数值；可计算的上期值以 `（上期：数值）` 附后，缺值用 `-`；仅出价的补充列写调价起始值和末值。明细行不再拆成带 `[续 …]` 的动作。
+
+AI策略 sheet 与前两张表统一使用共享字符串（单元格 `t="s"` 引用 `xl/sharedStrings.xml`），不使用 `inlineStr`；普通文字直接存入字符串池，加粗文字作为共享字符串富文本保留，换行与正文完整回读，避免内嵌预览器只显示表头。
+
+## 用户指定核心指标
+
+用户为某业务线指定核心指标时，本次分析优先使用用户值；未指定仍读业务线 coreIndex。先查询真实业务线ID，再向统一入口传 `--core-index '123=CPI <= 6.5'`（123仅为格式示例，禁止当真实ID调用）。多条业务线分别重复传，未指定的业务线仍用自身字段。只覆盖本次分析，不写回业务线配置。覆盖指标不支持或无法解析时按对应原因待观察，不静默回退业务线字段。
+
+## 结论规则
+
+以下固定分析规则用于第一张 `策略` sheet；数据库正文和 Learning 改从最后一张 `AI策略` sheet 获取，AI 结论按独立提示词生成，脚本只拆分和编码。
+
+learning 只保留“结论”和“说明”两部分。KPI 原文仅内部参与判定。支持三个渠道成效接口全部 12 个基础指标，以及飞书「指标」sheet 列出的 17 个衍生指标，共 29 项；表外指标不作为核心指标。衍生指标只在本地按基础字段计算；字段、公式、中文别名、方向和阈值格式见 [`references/metrics.md`](references/metrics.md)。
+
+- 核心指标未填写：待观察，说明“核心指标为空”；不在支持范围：待观察，说明“核心指标不支持”；指标表达无法解析：待观察，说明“核心指标无法识别”。
+- 样本门槛只要求本期消耗大于0美元；预算看业务线总体，其他三类看各新增枚举。零消耗判待观察，说明“数据不足，暂无法判断”。不再限制有效投放天数或 CPI 安装量；核心指标本身不可计算时仍待观察。
+- 有实际上期记录且指标可比：改善达到2%（含2%）为有效，说明“策略有效”；未达到2%改善为无效，说明“需关停”。这一分支不要求阈值达标。
+- 无实际上期记录：有阈值且满足则有效，说明“核心指标达标”；有阈值但不满足则无效，说明“核心指标未达标”；无阈值则待观察，说明“数据不足，暂无法判断”。
+- 上期有记录但核心指标缺失/为0、或本期值不可计算：待观察，不转为无上期的阈值判断。
+
+预算 learning 保持业务线总体口径；广告产品、受众、素材仅以各自维度中新增枚举值对应的成效判断，不复用预算结论。同一维度跨渠道的全部新增枚举先合计基础指标，再计算一次核心指标并对比业务线上期总体；无上期总体记录才走阈值分支。有效维度的新增消耗占所有有新增维度的消耗严格超过70%才判整类有效，详细口径见 metrics.md。效果码有效=1、无效=2、待观察=3。说明中每个维度的 KPI 数据独占一行，展示核心指标绝对值、环比及可识别阈值，并附行动建议；不复制原始 KPI 长文本或逐个枚举明细。
+
+## 常见误区
+
+- 衍生指标不要传给 `indicators`，先查基础指标再本地算。
+- `country_code` 只能单独传或与 `calendar_date` 同传；国家用**投放报告实际国家**，不用设置项。
+- 除预算外，三大策略看新增值自身数据；0%↔0% 残留枚举不当暂停。
+- 环比方向：成本类下降为好。维度合计先求和再算比率。
+- 出价按广告组 + `calendar_date` 相邻天比对；主表输出升/降数量、幅度分布/中位数，不要默认罗列。
+- 分析单位是业务线，账号按 ID 去重。Excel 不输出项目 PM。
+- 组别用 `ssoTeamCodeName`，周期用本次解析并写入 `periods.json` 的范围；查询、Excel 和数据库保存保持一致。
+- 未绑定项目/账号不要编造。多项目仍一行，名称 `\n` 分隔。
+- 文案用中文/`display_*`；兴趣词包新增/暂停各不超过5个时列全名称，更多只写数量；关键词维度无论数量多少都只显示新增/暂停数量，不展开名称；完整成员始终进入明细。
+- 新增成效按维度、渠道、ID 汇总后保留在明细；learning 不显示逐枚举明细。所有展示的消耗占比须同时给出绝对金额及环比。
+- CLI 回包必须直写文件（`exec_cli_to_file`），`capture_output` 会在约 64KB 截断。每页是 `stem.pN.out.json`，拉数成功才写 `stem.pages.json`；不要写全表 `merged.json`，也不要手写翻页把结果攒在内存里。翻页上限用脚本 `PAGE_CAP=200`，不要手写较低页数就停。
+- 本地模式每条只留一份最终 Excel；数据库模式上传后不留本地 Excel。禁止按桌面 glob 删除。
+- 四类效果分别编码：1=有效、2=无效、3=待观察，与对应 learning 结论一致，不从任意正文子串猜效果。
+- 入库前先读 [`../sino-bc-cli/domains/sino-bc-common-file/SKILL.md`](../sino-bc-cli/domains/sino-bc-common-file/SKILL.md)。上传固定 `serviceName=sino-opti-hive`；写入 AI 策略，不修改正式周策略。普通 write 在用户明确指定数据库输出后执行，无须重复确认。
+
+## References
+
+- [`references/ai-strategy-prompt.md`](references/ai-strategy-prompt.md)：AI 策略 sheet 的独立提示词原文；后续调整文案仅编辑此文件。
+- [`references/spec.md`](references/spec.md)：本技能的行为与验收规格，统一在技能目录内维护。
+- [`references/api-flow.md`](references/api-flow.md)
+- [`references/four-strategies.md`](references/four-strategies.md)
+- [`references/metrics.md`](references/metrics.md)
+- [`references/output-excel.md`](references/output-excel.md)
+- [`references/runtime.md`](references/runtime.md)
+
+## 显式跳过项目消耗预检
+
+仅用户明确要求跳过项目上周消耗判断时传 `--skip-project-spend-check`，默认不启用。该参数只跳过 `lastWeekSpend` 的全零或无正消耗门槛；仍校验项目分页完整性、关联项目、渠道、账号、指定周期真实投放数据及标签。不得因用户指定了历史周期就自动跳过。
+
+关键词维度为名称展开规则的例外：策略正文无论新增/暂停数量多少（包括1～5个），始终只展示数量，不展示关键词名称或片段；完整关键词仍保留在明细 sheet。其他维度的五个阈值规则不变。
+
+
+## 样例总结与保存格式
+四类顶部总结分别遵循 references/four-strategies.md 中预算/广告产品/受众/素材的不同结构。Excel维度标题和渠道名原生加粗；枚举及数据换行，金额后接环比，隐藏100%→100%占比、零动作；两种动作均为0显示未出现变化。预算调价不列广告组名称。受众广告组新增/暂停分别展示本期/上期合计消耗及占对应渠道同期总消耗比例。数据库 READY 从最终 Excel 的 `AI策略` sheet 回读：四类正文剥离末尾 Learning，括号中的有效/无效/待观察映射 Effect 的 1/2/3，冒号后的非空全文写入 Learning 并保留内部换行；三类标签名称与本业务线已审核的名称/ID绑定核对后传原 ID 数组，创意无标签。第一张表仍保留完整结论与说明，AI表仍保留末段 Learning。
+
+策略展示统一规则：占比差值仍按本期占比减上期占比计算，显示为带符号的百分数（例如 -1.7%），不写“个百分点”。四类策略及总结仅展示本次实际广告账号所属渠道（用户指定账号时以覆盖后的账号为准）；无账号渠道不展示，有账号但零消耗的渠道不得因此隐藏。learning 的说明中，动作/原因与后续 KPI 数据之间换行；第一张表保留结论与说明；数据库仅保存 AI sheet 末段 Learning 冒号后的正文并保留内部换行。
+
+Excel 主表在项目名称后增加广告账号列（共16列）。列出业务线关联项目的全部广告账号，按 Meta、Google、TikTok 分组去重；渠道名原生加粗、单独一行，其下每个账号 ID 一行，下一个渠道另起行。无账号渠道省略；账号列表完整保留在同一单元格，不因用户覆盖分析账号而缩减。此字段仅供 Excel，不增加数据库入参。

package/dist/skills/biz-line-strategy-generate/references/ai-strategy-prompt.md

@@ -0,0 +1,50 @@
+你是一位跨境投放策略分析师。请根据 Excel 明细sheet生成本期策略复盘（只依赖明细sheet，不要带入其他上下文），严格按以下规则输出。
+
+【分析规则】
+
+1. 分四段：预算策略 / 广告产品策略 / 受众策略 / 创意策略。
+2. 每段结构：策略总结 + 关键数据（双口径：数量 + 消耗）+调整方向（一句话描述）。
+3. 主次按消耗影响排序；成对变化成对写；占比变动必须对照绝对额。
+4. 任何"集中 / 主力"判断必须同时给数量占比和消耗占比。
+5. 新增条目必须说明是否真的跑起来了（消耗金额）。
+6. 在受众和创意策略里面，兴趣词包和关键词都需要先归纳成人群 / 内容方向再举例。
+7. 每段 Learning 独立写：分析该调整动作是否有效，给出标签值：有效、无效、待观察；每段策略总结出一个标签值。learning 重点是体现哪些动作有效、哪些无效，优于平均值的动作即有效，反之无效。
+8. 数字必须带单位、基准、环比方向。
+9. 发现数据之间矛盾时显式标注，不要静默选择。
+10. 底线：砍重复，不砍信息。
+
+【排版规范】（纯文字版必须按此排版）
+
+1. 每段按下方模板依次使用四小节标题：策略总结：、关键数据：、调整方向：、Learning（有效/无效/待观察）：。标题名称固定，但不加【】；Learning 括号内只能填该段最终的一个标签。四个策略大标题仍分别独立成行使用【预算策略】【广告产品策略】【受众策略】【创意策略】。
+2. 数字统一格式，一眼可扫：消耗 $32,933.93（上期 $15,851.61，环比 +107.76%）；占比 69.1%（上期 55.0%，绝对额 +$17,082.32）；效率 CTR 4.20% → 5.46%。单位、基准、环比方向永远内嵌在句子里。
+3. 每个信息点独立成行（用短横线引导），保持完整句子，禁止电报体短语。
+4. 成对变化用箭头连写（如"Meta 用互动目标替换认知目标：$3,718.02 vs $2,548.24"），不拆成两句。
+5. 开头以“一页速览：”引导速览，正文再展开；行数按下方篇幅约束执行。
+6. 加粗只用于结论词（消耗主力 / 有效 / 无效）和关键数字。
+7. 禁止出现表格、图标、图表，只能用纯文字 + 短横线列表。
+
+【篇幅约束】（自包含，不依赖任何外部版本）
+
+- 全文约 1,300～1,700 字。
+- 开头「一页速览」不超过 2 行。
+- 四段（预算 / 广告产品 / 受众 / 创意）每段约 250～350 字。
+
+返回前按当前提示词自检：速览非空；四个策略大标题各出现一次且顺序正确；每段四小节齐全，使用模板中的冒号格式；每段以唯一的 Learning（最终标签）：非空说明结束。核对数字来自本次明细，缺少数据时说明缺口，不填示例数字。模板只规定格式，不预设策略结论。
+
+【格式示例】（预算策略段）
+
+【预算策略】
+
+策略总结：本期预算策略为「优质渠道加投 + 新渠道测试」，消耗重心向 Google 集中。
+
+关键数据：
+
+- 消耗主力 Google：数量 1/3 渠道（33.3%），消耗 $32,933.93、占比 69.1%（上期 55.0%，绝对额 +$17,082.32，环比 +107.76%）。
+- 收缩方 Meta：消耗 $12,489.21、占比 26.2%（上期 44.8%，绝对额 -$406.91，环比 -3.16%）。
+- 测试转放量 TikTok：消耗 $2,243.60、占比 4.7%（上期 0.2%，绝对额 +$2,175.95，环比 +3216.5%）。
+- 出价调整（Google 3 个广告组）：cpc_bid 由 $0.01 上调至 $0.30～$0.50（+0.29～+0.49）；调价后仅 PM-Generic 明显跑量（消耗 $2,550.89），另两组均不足 $20。
+- 效率变化：Google CTR 4.20% → 5.46%、CPC $0.16 → $0.13；TikTok CTR 0.16% → 0.84%、CPC $0.16 → $0.06；Meta CTR 0.32% → 0.77%、CPC $0.31 → $0.18。
+
+调整方向：继续加投 Google、保持 TikTok 放量，Meta 维持收缩不追加；重点观察出价上调后 PM-Generic 的跑量持续性。
+
+Learning（有效）：三渠道加投 / 放量 / 收缩均未牺牲效率，点击率、点击成本、互动规模同步改善，动作有效；出价上调仅单一广告组跑量且缺转化验证，单独标为待观察。