context-engine

上下文引擎 — 共享营销情报

脚本位置。 如果你的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 并列。请使用 Python 3.10 或更高版本运行：python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

何时使用此技能

• 用户正在为营销创建新品牌或项目
• 用户在不同品牌／客户之间切换（代理机构用例）
• 其他营销技能需要品牌背景、行业数据、合规规则或平台规范
• 用户询问行业基准、平台要求或法规合规事宜

所需上下文

此技能会加载和管理：

1. 品牌档案 — 品牌身份、语气、受众、竞争对手、目标（来自 ~/.claude-marketing/brands/）
2. 行业档案 — 各行业的基准、KPI、渠道效果（参见 industry-profiles.md）
3. 合规规则 — 地区隐私法和行业法规（参见 compliance-rules.md）
4. 平台规范 — 各平台的字符数限制、图片尺寸、算法信号（参见 platform-specs.md）
5. 评分标准 — 适用于所有内容类型的标准化评估标准（参见 scoring-rubrics.md）

品牌档案管理

加载品牌

1. 检查 ~/.claude-marketing/brands/_active-brand.json，确定当前启用的品牌
2. 如果存在启用的品牌，则加载 ~/.claude-marketing/brands/{slug}/profile.json
3. 如果没有启用的品牌，则提示："尚未配置启用的品牌。运行 /digital-marketing-pro:brand-setup 来创建一个，或告诉我你的品牌情况，我会帮你完成设置。"

品牌档案架构

{
  "brand_name": "",
  "brand_slug": "",
  "created_at": "",
  "updated_at": "",
  "schema_version": "1.0.0",
  "identity": {
    "tagline": "",
    "mission": "",
    "vision": "",
    "values": [],
    "unique_selling_proposition": "",
    "positioning_statement": "",
    "elevator_pitch": ""
  },
  "business_model": {
    "type": "",
    "revenue_model": "",
    "price_range": "",
    "sales_cycle_length": "",
    "average_deal_size": "",
    "customer_lifetime_value": ""
  },
  "industry": {
    "primary": "",
    "secondary": [],
    "regulated": false,
    "regulation_codes": [],
    "compliance_notes": ""
  },
  "target_markets": [],
  "brand_voice": {
    "formality": 5,
    "energy": 5,
    "humor": 3,
    "authority": 5,
    "personality_traits": [],
    "tone_keywords": [],
    "avoid_words": [],
    "prefer_words": [],
    "this_not_that": [],
    "sample_content": []
  },
  "channels": {
    "active": [],
    "primary": "",
    "handles": {}
  },
  "competitors": [],
  "goals": {
    "primary_objective": "",
    "kpis": [],
    "budget_range": "",
    "team_size": ""
  }
}

切换品牌

当用户说“切换到 [brand name]”时：

1. 运行：python "${CLAUDE_PLUGIN_ROOT}/scripts/setup.py" --switch-brand SLUG
2. 脚本会处理模糊匹配、验证，并更新 _active-brand.json
3. 确认：“已切换到 [brand_name]。所有营销输出现在都会使用此品牌的语气、合规规则和上下文。”

或者使用：/digital-marketing-pro:switch-brand

其他模块如何使用此技能

每个模块都应：

1. 在生成营销输出前，检查是否存在启用的品牌
2. 加载相关行业档案，获取基准和渠道建议
3. 根据品牌的 target_markets 和 industry.regulation_codes 自动应用合规规则
4. 创建特定平台的内容时参考平台规范
5. 评估或评分内容质量时使用评分标准
6. 使用自适应评分——运行 adaptive-scorer.py，在内容评分前获取品牌专属权重
7. 保存营销活动数据——使用 campaign-tracker.py 持久化计划、表现和洞察
8. 查看过往营销活动——在提出建议前，检查品牌历史记录中是否有类似营销活动

业务模式类型

以下类型会触发不同的漏斗模型、KPI 框架和渠道策略：

• B2B_SaaS — 以 MRR/ARR 为重点，产品驱动或销售驱动增长
• B2C_eCommerce — 以 ROAS 为重点，产品目录营销
• B2C_DTC — 面向消费者的品牌建设与效果营销
• B2B_Services — 思想领导力、较长的销售周期
• Local_Business — Google 商家资料、本地 SEO、评价
• Agency — 多客户管理、白标输出
• Creator — 个人品牌、受众拓展、变现
• Enterprise — ABM、采购委员会、复杂销售
• Non_Profit — 捐赠者获取、提升认知、倡导
• Marketplace — 双边获客、流动性、信任

品牌语气评分

品牌语气评分器（brand-voice-scorer.py）会自动规范化档案数据：

• 读取 brand_voice.formality（1-10 的整数刻度）→ 在内部转换为 0.0-1.0 的浮点数
• 将 brand_voice.prefer_words 映射为 preferred_words，将 brand_voice.avoid_words 映射为 avoided_words
• 同时支持完整档案架构（来自 brand-setup）和旧版直接架构

数据持久化

营销活动数据、效果快照和营销洞察会跨会话持久保存：

~/.claude-marketing/brands/{slug}/
├── campaigns/              # Campaign plans and post-mortems
│   ├── _index.json         # Campaign index for quick lookup
│   └── {id}.json           # Individual campaign data
├── performance/            # Performance snapshots over time
│   └── {campaign}-{date}.json
├── insights.json           # Marketing learnings (last 200)
├── content-library/        # Saved content pieces
└── voice-samples/          # Brand voice reference content

所有持久化操作都使用 campaign-tracker.py。

MCP 集成

配置 MCP 服务（位于 .mcp.json）后，模块可以获取真实数据：

• Google Analytics → 效果报告的实际流量／转化数据
• Google Search Console → SEO 审计的真实排名数据
• Google Ads / Meta → 付费广告的实时营销活动效果
• HubSpot → 漏斗分析的 CRM 数据
• Mailchimp → 邮件营销活动指标
• Google Sheets → 导出报告和日历

所有 MCP 服务都通过用户自己的 API 密钥连接到其账户。

参考文件

核心背景与规格

• industry-profiles.md — 20 多个行业概况，涵盖基准、渠道、合规要求和内容类型
• platform-specs.md — 社交媒体、电子邮件和广告平台规格
• platform-publishing-specs.md — 各平台的 API 级发布要求和内容格式（载荷、字段映射、验证）
• google-seo-reference.md — 简明的 Google SEO 快速参考（抓取／编入索引／呈现、展示位置、结构化数据状态、算法日期）
• schema-templates.json — 可直接使用的 JSON-LD 结构化数据模板，附有 Google 支持／弃用状态
• india-market-context.md — 印度区域市场背景：法规（DPDP）、平台和市场动态

方法论框架

• engagement-flow-methodology.md — 12 部分的顺序式客户合作方法论；每个命令、技能和 Agent 都会查阅
• four-core-documents-spec.md — 四份第 3 部分核心文档的完整规格（61 个步骤），构成战略主线
• decision-matrix-rerun.md — 第 5 部分客户验证后，哪些第 3／4 部分文档需要重新运行并生成 v2
• two-views-model.md — 让 v1（无偏见的研究）和 v2（经客户验证）视图分别针对不同问题保持权威性
• update-back-rule.md — 修正内容应写入源文档，而不只是发现错误的交付成果
• stone-vs-opinion.md — 对收集的事实进行置信度标记：可核实的 Stone 与客户的 Opinion
• living-instruction-file-spec.md — 每次客户合作所用的持续更新型项目说明文件规格（唯一事实来源）
• 30-60-90-framework.md — 默认的首季度阶段划分：基础建设／优化／扩展里程碑
• actionable-persona-format.md — 取代传记式叙述的六问式 Persona 格式
• b2b-decision-making-unit.md — 适用于每个 B2B Persona 的 B2B 采购委员会角色补充说明
• five-digital-markets.md — 五种数字市场类型的战略分类；市场类型决定渠道
• channel-families.md — 将第 9 部分的 17 个渠道按运营方式划分为七个渠道组
• in-market-out-market.md — 目标市场内受众（3–5%）与市场外受众（95–97%）之间的预算分配逻辑
• fixed-vs-variable-budget.md — 区分每月固定支出与基于数据的可变支出
• unit-economics-framework.md — 每项渠道和预算决策都要参照的 CAC/LTV 基础框架
• three-scenario-forecasting.md — 每项预测都以保守／预期／乐观三种情景呈现
• decision-framework.md — 多维度决策框架：为每个维度命名、赋予权重并评分
• competitor-3-question-output.md — 每份竞品分析都必须针对每个竞争对手回答的三个问题

执行指南

• execution-workflows.md — 发布、发送和启动营销行动的标准操作流程
• seo-execution-guide.md — 通过 CMS API、搜索控制台操作、架构部署和排名监控执行 SEO
• geo-execution-guide.md — 生成式引擎优化：AI 可见度监控、实体和引用
• multilingual-execution-guide.md — 端到端多语言营销活动流程：翻译服务、RTL/Indic/CJK 和 SEO
• transcreation-framework.md — 创译、翻译与本地化的区别，以及流程和 QA 评分
• crm-integration-guide.md — CRM 连接模式、对象映射和数据同步（Salesforce、HubSpot 等）
• custom-mcp-guide.md — 如何在选择加入的连接器目录之外添加或构建 MCP 服务
• self-healing-ops-guide.md — 在安全防护机制内自动监控和纠正营销活动
• approval-framework.md — 风险分类，用于确定自动执行或需明确批准的流程
• agency-operations-guide.md — 多客户 SOP：入驻、客户组合健康状况、凭证隔离、白标服务
• team-roles-framework.md — 团队角色、权限、审批链和产能规划
• guidelines-framework.md — 品牌指南、限制条件和风格规则的结构及执行方式

合规与欧盟

• compliance-rules.md — 地区隐私法律（16 个司法管辖区）和行业法规（10 多个领域）
• eu-code-of-practice.md — 欧盟 AI 生成内容行为准则，以及《AI 法案》第 50 条对营销人员的义务

模板与评分标准

• scoring-rubrics.md — 内容质量、广告创意、电子邮件和落地页的评分标准
• eval-rubrics.md — eval-runner.py 使用的六个评估维度的详细评分标准
• eval-framework-guide.md — 自动化六维内容 QA 流程的架构和用法
• growth-plan-template.md — 面向客户的旗舰交付成果：第 8 部分《增长计划》模板
• yearly-planner-template.md — 第 8 部分十二个月运营日历模板
• monthly-report-template.md — 以决策为导向的月度客户报告结构
• reporting-cadence.md — 将指标审查频率（日→季度）与决策速度相匹配
• advanced-reporting-guide.md — PDF 报告生成、仪表板、归因、群组和差异报告

智能与记忆

• intelligence-layer.md — 自适应智能系统的工作原理（评分、学习、持久化）
• memory-architecture.md — 五层持久化品牌知识系统
• compound-intelligence-guide.md — 让每次决策都优于上一次的智能图谱
• creative-intelligence-guide.md — 创意疲劳预测、内容衰减和更新优先级排序
• market-intelligence-guide.md — 宏观信号检测：经济指标、市场时机、法规跟踪
• competitive-monitoring-guide.md — 持续检测竞争对手变化、社交聆听、声量份额
• narrative-warfare-guide.md — 叙事领地映射、反叙事和品类创建
• journey-growth-guide.md — 客户旅程状态机、增长循环、暗漏斗分析、旅程模拟
• marketing-science-guide.md — 因果推断、贝叶斯 MMM、增量效果和严谨的实验设计
• synthetic-audience-guide.md — 通过校准开展 AI 模拟受众研究、焦点小组和信息测试