SuperAPI AI 工具集

status

营销与增长

查看项目

更新于 10-16 09:01

技能介绍

用途

/digital-marketing-pro:status 是 Digital Marketing Pro 的显式按需状态查看命令,用于打印当前活跃品牌的完整状态快照。它取代了早期在每次 Claude Code 会话启动时全局运行的 SessionStart 钩子(该钩子会在所有项目中触发,无论用户是否在做营销工作),提供更丰富、由用户主动请求的视图。

主要能力

状态快照包含 5 个分区:

  • Brand(品牌):名称、slug、行业(含是否受监管标记)、商业模式、语气维度、特征、渠道、语言、市场、竞争对手、主要目标、自动保存洞察开关。
  • Engagements(项目):该品牌的所有营销项目,含当前阶段、已完成/进行中/受阻数量、距上次更新的天数、待处理的重跑决策、带版本文档数量。
  • Recent Insights(最近洞察):最近 5 条捕获的洞察,含类型、摘要、距上次保存天数。
  • Recent Compliance Violations(最近合规违规):最近 5 条违规,含规则、类别、严重程度;以及最近 30 天总数。
  • Python Dependencies(Python 依赖):Python 版本、模式(knowledge-only / lite / full)、可用与缺失的包。

使用方式

脚本位于本插件的 scripts/ 文件夹中(与 skills/ 同级)。若宿主未设置 ${CLAUDE_PLUGIN_ROOT},请使用 Python 3.10 或更新版本运行,命令为 python,在 macOS 及许多 Linux 系统上找不到 python 时使用 python3。

子命令与模式:

  • 默认:/digital-marketing-pro:status —— 当前活跃品牌的完整快照,从 ~/.claude-marketing/brands/_active-brand.json 读取活跃 slug。
  • 指定品牌:/digital-marketing-pro:status --brand acme-corp —— 查看指定品牌快照(不改变活跃品牌指针)。
  • 精简单行:/digital-marketing-pro:status --quiet —— 输出形如 DMP STATUS | Acme Corp | engagements: 2 active / 3 total | deps: lite。
  • JSON 输出:/digital-marketing-pro:status --json —— 机器可读 JSON,供下游技能或脚本使用。
  • 单分区:/digital-marketing-pro:status --section brand(可选 engagements、insights、compliance、deps)—— 仅打印指定分区。

底层执行命令:

python "${CLAUDE_PLUGIN_ROOT}/scripts/dm-status.py" [--brand <slug>] [--json] [--quiet] [--section <name>]

技能本身是薄编排层,脚本完成主要工作。对于 JSON 输出,技能会解析并在响应中突出关键健康指标(例如超过 14 天未更新的项目,或有待处理重跑决策的项目)。

适用场景

  • 在营销工作会话中快速确认当前正在处理哪个品牌。
  • 查看各营销项目的进度与停滞情况。
  • 检查最近洞察与合规违规记录。
  • 通过 --json 输出供其他技能或脚本消费。
  • 通过 --section 只获取某一项状态。

限制

  • 只读操作,绝不修改品牌档案、项目状态或任何持久文件。
  • 不保存洞察、合规违规或任何数据。
  • 不触发评估脚本(请使用 /digital-marketing-pro:check)。
  • 不推进项目阶段(请使用 /digital-marketing-pro:engagement next)。
  • 不切换活跃品牌(请使用 /digital-marketing-pro:switch-brand)。
  • 若品牌档案缺失或损坏,脚本会在输出中报告具体错误,不会静默失败。
  • 当设置了 CLAUDE_PLUGIN_DATA 环境变量时,脚本从 $CLAUDE_PLUGIN_DATA/digital-marketing-pro/... 读取,而非 ~/.claude-marketing/...。
  • 脚本仅读取状态文件,不调用其他脚本,不发起网络请求。
  • 上下文效率方面:该技能较重,建议先 Grep 再 Read 引用文件,仅用 offset + limit 读取匹配范围;会话中重新调用时跳过已在上下文中的文件。

相关命令

  • /digital-marketing-pro:brand-setup —— 创建或更新品牌档案
  • /digital-marketing-pro:switch-brand —— 切换活跃品牌
  • /digital-marketing-pro:engagement status —— 项目专属深度状态
  • /digital-marketing-pro:check —— 内容发布前质量门禁
  • /digital-marketing-pro:integrations —— 连接器状态(与 status 不同)

相关参考:scripts/dm-status.py(底层脚本)、docs/getting-started.md(关于移除 SessionStart 钩子及 status 取代它的背景说明)。