sop-library

/digital-marketing-pro:sop-library

スクリプトの場所。 ホストで ${CLAUDE_PLUGIN_ROOT} が設定されていない場合、スクリプトは skills/ と同じ階層にあるこのプラグインの scripts/ フォルダーにあります。Python 3.10 以降で実行してください。python が見つからない場合（macOS、多くの Linux システム）は、python3 を使用してください。

目的

代理店の標準業務手順書（SOP）ライブラリを管理します。テンプレートから 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 のいずれか
• ブランドのスラッグ（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 を読み込み、アクティブなスラッグを確認してから、~/.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 を作成します。以下を含めます。
   • 目的の説明と適用範囲の定義
   • 前提条件と必要なプラットフォームアクセス権
   • 各手順の担当者と所要時間を含む番号付きの手順
   • 合格／不合格の基準を備えた、主要なチェックポイントでの品質確認
   • エスカレーション経路を含む承認要件
   • 該当する場合は、完了基準とロールバック手順
   • バージョン 1.0 として ~/.claude-marketing/sops/{category}/{sop-slug}.json に保存
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 つ以上の手順、各手順の担当者、少なくとも 1 つの承認ゲート、完了基準、推定所要時間の合計）が含まれていることを確認します。保存する前に、不足項目があれば通知します。
10. 競合を確認する：割り当てまたは更新の際に、同じブランドおよびカテゴリに割り当て済みの既存 SOP と競合しないことを確認します。重複する手順、矛盾する要件、冗長な手順があれば通知します。
11. コンプライアンス傾向を作成する：コンプライアンス確認では、現在のコンプライアンス率を過去の確認結果と比較し、遵守状況が改善または低下している傾向を特定します。コンプライアンス率が低下しているブランドには、管理者の注意が必要であることを通知します。
12. 結果を報告する：アクションの結果を確認内容とともに提示し、警告（未割り当ての SOP、コンプライアンス違反、検出された競合、不完全なセクション）と推奨される次のステップを示します。

出力

アクションごとの出力：

• For CREATE：すべてのセクション（目的、範囲、前提条件、役割と所要時間を含む番号付き手順、品質ゲート、承認要件、完了基準、ロールバック手順）を含む完全な SOP ドキュメント、保存確認（ファイルパスとバージョン番号を含む）、実行時間の合計見積もり、ブランドへの割り当てを促すプロンプト
• For LIST：カテゴリ別に整理された SOP ライブラリの表（名前、カテゴリ、バージョン、優先度、手順数、所要時間、最終更新日、割り当て済みブランド数、確認済みの場合はコンプライアンス率の集計値）。カテゴリ別およびライブラリ全体の統計サマリー
• For ASSIGN：割り当て確認（ブランド名、SOP 名、有効日、適用したブランド固有の上書き設定、上書き設定を含む合計手順数を含む）、次回の実行サイクル後にコンプライアンスチェックを実施するよう促すリマインダー
• For CHECK-COMPLIANCE：コンプライアンスレポート（手順ごとの合格／不合格／スキップのステータス、全体のコンプライアンス率、実行エビデンスと修正ガイダンスを含む具体的な失敗の詳細、前回のチェックとの傾向（改善／安定／悪化）、繰り返し発生する失敗のパターン分析、優先順位を付けた是正措置）
• For UPDATE：差分サマリー（変更内容と変更前／変更後）、新しいバージョン番号、作成者とメモを含むバージョン履歴エントリー、再レビュー対象としてフラグ付けされた影響を受けるブランドの一覧、コンプライアンスチェックの再実行に関する推奨事項を含む更新済み SOP
• For VIEW：すべての手順とメタデータを含む SOP 全体の表示、ブランドごとのコンプライアンス状況を含む割り当て済みブランドの一覧、変更メモを含む完全なバージョン履歴、コンプライアンス指標の集計、ブランドごとの最終コンプライアンスチェック日

使用するエージェント

• agency-operations — カテゴリテンプレートからの SOP 作成、コンプライアンス追跡ロジック、バージョン管理とアーカイブ管理、割り当てワークフロー、競合の検出、傾向分析、ライブラリの整理
• memory-manager — SOP ファイルの保存と取得、バージョン履歴の永続化、ブランドと SOP の関連付け管理、アーカイブの保守、コンプライアンスデータのアーカイブ