help

/digital-marketing-pro:help

显示 Digital Marketing Pro 用户指南，其中包含从磁盘读取的实时插件状态（版本、Agent／技能／命令／脚本数量、连接器数量、运行环境），而不是硬编码的值；还包含入门步骤、使用示例和故障排查。

关键：切勿硬编码版本、数量或连接器数

过去，此插件曾将版本和数量以字面值写入此技能正文，例如硬编码的版本号、固定的斜杠命令数量、固定的集成数量。这些值在每次发布后都会与实际安装状态不一致，导致插件向用户报告错误信息。

务必从 scripts/plugin-metadata.py 读取实时值。切勿凭记忆或从此技能正文中引用版本号、技能数量、Agent 数量、命令数量或连接器数量。

行为

步骤 1 — 获取实时插件元数据

每次调用此技能时（无论是否带参数），都要首先运行：

python "${CLAUDE_PLUGIN_ROOT}/scripts/plugin-metadata.py" --section all-with-environment

此命令会返回 JSON，其中包含：

• version — { version, name, required_min_version, ... }
• assets — { agents, skills_total, commands, scripts, reference_docs }
• connectors — { available_http, available_npx, available_total, active_count, active_names, cowork_compatible_count }
• skills — { skill_dir, slash_command, description } 数组
• commands — { command_file, slash_command, description } 数组
• environment — 运行环境检测结果（本地 Claude Code 或 Cowork 沙盒；如果文件系统写入无法同步到用户主机，则会发出警告）

将此 JSON 中的值填入帮助内容中所有涉及数量、版本或斜杠命令列表的位置。切勿编造或引用其他来源的数字。

步骤 2 — 默认渲染（无参数）

使用实时数据生成清晰的概览。建议格式（将所有 <...> 替换为 JSON 中的值）：

=== DIGITAL MARKETING PRO ===
Version: <version.version>
Agents: <assets.agents> | Skills: <assets.skills_total> | Commands: <assets.commands> | Scripts: <assets.scripts>
Connectors: <connectors.available_http> HTTP + <connectors.available_npx> npx available
  (<connectors.active_count> currently active in your .mcp.json)
  Cowork-compatible: <connectors.cowork_compatible_count> (HTTP only — npx connectors don't run in Cowork)
Environment: <environment.environment>
<if environment.cowork_warning is non-null, show it as a WARNING block>

Getting Started:
  1. /digital-marketing-pro:brand-setup       — Create your brand profile (start here)
  2. /digital-marketing-pro:import-guidelines  — Import voice guides, restrictions, templates
  3. /digital-marketing-pro:integrations       — See which connectors are active
  4. /digital-marketing-pro:connect <name>     — Set up a new connector
  5. Just ask!                                 — Describe what you need in natural language

步骤 3 — Cowork 警告（适用时）

如果 environment.cowork_warning 不为 null，请在概览块之后醒目地显示该警告，并说明品牌状态写入 ~/.claude-marketing/ 后会保存在沙盒内，不会持久保存到用户主机；建议使用 /digital-marketing-pro:cowork-setup，通过 Drive MCP 路由状态。

步骤 4 — 参数路由

参数	要渲染的内容
（无）	步骤 2 + 3 + 简短的“直接提问”提示
--commands	步骤 2 + 3 + JSON commands 数组中的所有命令（包含其 slash_command 和 description），可按类别分组
--skills	步骤 2 + 3 + JSON skills 数组中的所有技能（包含其 slash_command 和 description）
--connectors	步骤 2 + 3 + 提示：“如需查看连接器的可用／启用状态，请运行 /digital-marketing-pro:integrations”
--examples	步骤 2 + 3 + 示例提示词（见下文）
--troubleshoot	步骤 2 + 3 + 故障排查表（见下文）
--brand	步骤 2 + 3 + 当前品牌摘要（运行 /digital-marketing-pro:status --section brand）
--intent "<goal>"	意图路由（见步骤 4.5）——针对目标的技能链，而非列表

渲染技能／命令列表时，遍历 JSON 数组——不要粘贴手动维护的列表，也不要凭记忆给出总数。每行都以 slash_command 字段作为面向用户的标签，并以 description 字段作为说明。

渲染 --skills 时，还要读取 ${CLAUDE_PLUGIN_ROOT}/skills-index.json（由 scripts/build_skills_index.py 生成，并在每次发布时通过机器校验，确保与仓库一致），为每个技能标注其深度层级：[E] 执行实际脚本，[M] 通过质量机制衡量输出，[G] 提供结构化指导。在顶部只显示一次图例。层级是技能公开承诺的一部分——切勿猜测，务必从索引中读取。

步骤 4.5 — 意图路由（--intent "<goal>"，或任何关于“哪个技能”的自然语言提问）

150 多个按字母顺序排列的技能列表无法回答任何问题。当用户陈述目标（“从自然搜索获取更多潜在客户”“推出产品”“优化我们的广告支出”）时，将他们引导至一条技能链：

1. 读取 ${CLAUDE_PLUGIN_ROOT}/skills-index.json。根据每个条目的 description 匹配目标，并沿着 cross_refs 找出彼此衔接的技能。
2. 按优先级从高到低，最多呈现 3 条候选链。链是一个有序序列：入口技能 → 其工作成果所供给的技能（来自 cross_refs）→ 检查输出的关卡。为每个步骤标注其层级徽标，并用一行说明它为何位于链中。
3. 任何会生成可发布输出的链都必须以关卡结束（/digital-marketing-pro:check 或相关审核者）——绝不能让链停在未经关卡检查的步骤。
4. 如果目标不明确，只问 1 个澄清问题，而不是列出 3 条错误的链。
5. 如果没有匹配的技能，就直言说明，并指向 --skills——绝不捏造技能名称。

示例呈现格式（具体内容必须来自索引，而不是本文件）：

Goal: "more leads from organic"

Chain 1 (recommended):
  1. [E] /digital-marketing-pro:seo-audit        — find what blocks organic visibility
  2. [G] /digital-marketing-pro:content-strategy — turn gaps into a content plan
  3. [E] /digital-marketing-pro:lead-magnet-ideas — capture the traffic you win
  4. [M] /digital-marketing-pro:check            — gate before anything ships

步骤 5 — 示例提示词（--examples）

展示涵盖各类营销任务的真实示例提示词：

Getting Started:
  /digital-marketing-pro:brand-setup
  → Create your brand profile interactively (5 quick questions or 17 detailed)

Strategy:
  "Plan a product launch for our new cold brew line"
  → Activates the campaign orchestrator with your brand context

Content:
  "Write a 3-email welcome sequence for new subscribers"
  → Creates emails in your brand voice with compliance rules applied

SEO:
  /digital-marketing-pro:seo-audit https://example.com
  → Full technical + content + E-E-A-T audit with action items

Competitive:
  /digital-marketing-pro:competitor-analysis "Blue Bottle, Counter Culture, Stumptown"
  → Multi-dimensional analysis: content, SEO, ads, social, positioning

Analytics:
  /digital-marketing-pro:performance-report
  → KPI tracking, trend analysis, anomaly detection, recommendations

AI Visibility:
  /digital-marketing-pro:aeo-audit
  → Check how your brand appears in ChatGPT, Perplexity, Google AI Overviews

Full engagement:
  /digital-marketing-pro:engagement start acme-corp 2026-q2
  → Run the full 12-Part strategy methodology end to end

步骤 6 — 故障排除（--troubleshoot）

问题	解决方案
“No active brand” 消息	运行 /digital-marketing-pro:brand-setup 创建你的第一个品牌档案
Python 功能不可用	安装：pip install nltk textstat（精简模式），或安装完整的 requirements.txt
MCP 连接器无法工作	运行 /digital-marketing-pro:integrations 检查状态，运行 /digital-marketing-pro:connect <name> 进行设置
品牌语气似乎不对	运行 /digital-marketing-pro:brand-setup --full，完成详细的 17 个问题的品牌分析
命令无法识别	确认插件已安装：在 Cowork 中检查“Manage Plugin”，或运行 claude plugin list
文件在 Cowork 中无法持久保存	运行 /digital-marketing-pro:cowork-setup，通过 Drive MCP 路由品牌状态
长工作流中断	运行 /digital-marketing-pro:resume，从上一个检查点继续

步骤 7 — 文档参考

指南	内容
docs/getting-started.md	完整的设置指南及示例
docs/brand-guidelines.md	导入品牌语气指南、限制和模板
docs/integrations-guide.md	连接营销工具
docs/multi-brand-guide.md	代理机构工作流、品牌切换
docs/strategy-and-kpis.md	KPI 框架、报告仪表板
docs/architecture.md	技术深入介绍：模块、Agent
docs/claude-interfaces.md	Cowork 专属功能
CONNECTORS.md	按类别列出的可用连接器

输出格式规则

• 使用清晰易读的表格和代码块。保持简洁——这是快速参考，不是教程。
• 始终从 JSON 中引用 version 和计数，绝不要引用本文件正文中的内容。
• 遍历 JSON 的 skills / commands 数组生成相应列表——绝不要使用手动维护的列表。
• 如果 scripts/plugin-metadata.py 无法运行（例如 Python 不可用），则使用以下内容作为回退：“无法运行实时元数据脚本。插件版本位于 .claude-plugin/plugin.json；技能列表位于 skills/；命令列表位于 commands/。”回退内容中也不要捏造数字。

此技能明确避免的做法

• 引用本文件正文中的版本号
• 引用本文件正文中的任何计数（Agent 数量、技能数量、命令数量、集成数量）
• 手动列出斜杠命令——始终从 JSON 中提取
• 引用已重命名技能的过时信息（始终使用 JSON 中的名称）