sop-library

/digital-marketing-pro:sop-library

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

用途

管理代理机构的标准操作规程库。从模板创建 SOP，将其分配给特定品牌，根据近期执行情况跟踪合规性，并维护版本控制。SOP 定义了常见营销运营的强制步骤，确保所有客户合作项目的一致性、质量和问责制，无论执行工作的团队成员是谁。

所需输入

用户必须提供（或将收到提示提供）：

• 操作：以下选项之一：create、list、assign、check-compliance、update 或 view
• SOP 类别：运营领域——content-production、paid-media、reporting、crm、seo、social-media、email-marketing、client-management、onboarding 或 general
• 品牌 slug（用于 assign/check-compliance）：要分配 SOP 或检查其合规性的品牌——必须与 ~/.claude-marketing/brands/ 中配置的品牌一致
• SOP 名称（用于 create/update/view）：描述性规程名称（例如，“博客文章发布检查清单”“月度报告工作流”“付费搜索广告系列启动流程”）
• SOP 内容（用于 create/update）：规程步骤、检查清单、责任角色、审批要求和质量关卡；或者注明“from template”，以使用该类别的默认模板
• 版本说明（用于 update）：更改内容及原因——记录在版本历史日志中，供审计追踪和团队沟通
• 优先级（用于 create）：以下选项之一：
  • Critical：每次执行都必须遵守——合规失败会触发管理层警报
  • Standard：建议遵守，以确保团队成员之间的一致性
  • Advisory：最佳实践指南，不是强制要求——供参考和培训
• 品牌专属覆盖项（用于 assign）：针对该品牌的具体要求、行业法规或客户偏好，需要修改、跳过或添加的任何步骤
• 合规日期范围（用于 check-compliance）：检查执行情况是否符合 SOP 时的回溯范围——默认为最近 30 天

流程

1. 加载品牌背景：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前使用的 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景。另检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中的指南（如果存在），并加载其中的限制。检查 ~/.claude-marketing/sops/ 中的代理 SOP。如果不存在品牌，询问：“先设置品牌吗（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 检查 SOP 存储：读取 ~/.claude-marketing/sops/ 中的 SOP 库。每个 SOP 都存储为 JSON 文件，包含元数据（名称、类别、版本、优先级、创建日期、最后更新日期、作者、分配的品牌、步骤数组、检查清单和版本历史）
3. 对于 CREATE 操作：根据指定类别的模板生成新的 SOP。包括：
   • 目标说明和范围定义
   • 前提条件和所需的平台访问权限
   • 编号流程步骤，以及每个步骤的负责角色和预计耗时
   • 关键关卡的质量检查点，包含通过／失败标准
   • 审批要求和升级路径
   • 完成标准，以及适用时的回滚流程
   • 保存到 ~/.claude-marketing/sops/{category}/{sop-slug}.json，版本设为 1.0
4. 对于 LIST 操作：按类别列出库中的所有 SOP。显示名称、版本、优先级、最后更新日期、步骤数、预计总时长和分配数（使用此 SOP 的品牌数量）。标出未分配的 SOP，以及合规率低于 80% 的 SOP
5. 对于 ASSIGN 操作：通过在 ~/.claude-marketing/brands/{slug}/sops/{sop-slug}.json 创建引用，将指定的 SOP 关联到某个品牌。引用中应包含 SOP 引用、分配日期、分配者，以及对标准步骤的任何品牌专属覆盖或补充
6. 对于 CHECK-COMPLIANCE 操作：将品牌近期的执行记录（通过 python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history 获取）与已分配的 SOP 要求进行比较。根据执行证据，将每个 SOP 步骤判定为通过／失败／不适用／跳过。计算总体合规率，并识别反复出现的失败模式
7. 对于 UPDATE 操作：加载现有 SOP，创建带版本号的备份（在 ~/.claude-marketing/sops/_archive/ 中的文件名追加版本号），应用更新、递增版本号，在版本历史数组中记录变更说明和作者，并标记所有受影响的品牌，要求其重新审核
8. 对于 VIEW 操作：显示完整 SOP，包括所有步骤、检查清单、元数据、已分配品牌列表、完整版本历史，以及所有已分配品牌的总体合规状态摘要
9. 验证 SOP 完整性：对于创建和更新操作，确认 SOP 包含所有必需部分——目标、范围、至少 5 个流程步骤、每个步骤的负责角色、至少一个审批关卡、完成标准和预计总时长。保存前标记任何缺漏
10. 检查冲突：分配或更新时，确认 SOP 与该品牌在同一类别下已分配的 SOP 不冲突——标记重叠步骤、相互矛盾的要求或重复流程
11. 生成合规趋势：对于合规检查，将当前合规率与之前的检查结果进行比较，以识别依从性上升或下降的趋势——标记合规率下降、需要管理层关注的品牌
12. 报告结果：说明操作结果并予以确认，同时列出任何警告（未分配的 SOP、合规失败、检测到的冲突、不完整部分）和建议的后续步骤

输出

特定操作的输出：

• For CREATE：完整的 SOP 文档，包含所有章节（目标、范围、前置条件、带角色和时间估算的编号步骤、质量门槛、审批要求、完成标准、回滚流程）；保存确认信息，注明文件路径和版本号；预计总执行时间；以及分配给品牌的提示词
• For LIST：分类的 SOP 库表格，包含名称、类别、版本、优先级、步骤数、预计时长、最近更新时间、已分配品牌数，以及已检查时的总体合规率；各类别的汇总总数和整个库的统计数据
• For ASSIGN：分配确认信息，包含品牌名称、SOP 名称、生效日期、应用的品牌特定覆盖项、包含覆盖项在内的步骤总数，以及提醒在下一个执行周期后运行合规检查
• For CHECK-COMPLIANCE：合规报告，包含各步骤的通过／失败／跳过状态、总体合规百分比、附带执行证据和补救指南的具体失败详情、与上次检查相比的趋势（改善／稳定／下降）、重复失败的模式分析，以及按优先级排序的纠正措施
• For UPDATE：更新后的 SOP，包含差异摘要（变更内容及变更前后对比）、新版本号、附有作者和备注的版本历史条目、标记为需要重新审核的受影响品牌列表，以及重新运行合规检查的建议
• For VIEW：完整的 SOP 展示，包含所有步骤和元数据、已分配品牌列表及各品牌的合规状态、附有变更备注的完整版本历史、总体合规指标，以及各品牌最近一次合规检查日期

使用的 Agent

• agency-operations — 基于类别模板创建 SOP、合规跟踪逻辑、版本控制与归档管理、分配工作流、冲突检测、趋势分析和库管理
• memory-manager — SOP 文件存储与检索、版本历史持久化、品牌与 SOP 的关联管理、归档维护以及合规数据归档