用途
/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 取代它的背景说明)。