mcpField
A
afa-tt

afa-tt

github.com/afadtcマーケティング・グロース17768 回インストール3 週間前に更新
リポジトリ

afa-tt について

ブランドの広告運用チーム向けのTikTok Ads最適化スキルです。アカウント設計、クリエイティブ戦略、成果診断、TikTok Shop、予算拡大を扱い、市場や季節、素材の状態に応じて提案を調整します。

主な機能

  1. 01TikTok Adsアカウント設計
  2. 02クリエイティブ戦略と素材テスト
  3. 03CPA・ROAS・配信状況の診断
  4. 04TikTok Shopとアフィリエイト施策
  5. 05予算拡大とロールバック計画

活用シーン

  1. 01新ブランドのTikTok Ads設計
  2. 02高CPAや低ROASの原因調査
  3. 03TikTok Shopやアフィリエイト施策の立案

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/afadtc/afa-dtc-skills --skill afa-tt

インストール後、Claude Code で/afa-ttを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
account-setup-sop.md
affiliate-playbook.md
anti-patterns.md
benchmark-data.md
core-frameworks.md
creative-templates.md
diagnostic-rules.md
scaling-sop.md
tiktok-shop-playbook.md
work-modes-and-templates.md

詳細

TikTok 广告优化引擎

Supervisor: afa-paid · 版本:v2.6

1. Context Matrix (上下文矩阵)

在执行任何任务前,必须加载以下 Brand Brain 文件:

  • Requires: products.md, audience.md
  • Optional: learnings.jsonl, creative-kit.md, offers.md, store.md
  • Never: 竞品 TikTok 广告后台数据、未经授权的 Pixel 数据
1.1 Shared Inherited Context(共享继承上下文)

本 Worker 不是独立入口。执行前必须承接 Hub / Supervisor 已编译的共享上下文,不得把上游已确认的问题重新问一遍,也不得在用户可见层暴露内部路由代号。

字段来源用法
main_questionHub / Supervisor当前轮必须优先解决的主问题;输出不得偏航到次要问题。
goalHub / Supervisor当前任务的目标定义;用于约束 TikTok 投放诊断、优化与交付边界。
deferred_goalsHub / Supervisor暂不在本轮处理的次级目标;只可在 WHAT'S NEXT 中自然承接,不可抢答。
evidence_stateHub / Supervisor证据充分度判断;低证据时先给保守可执行版,再标注待验证项。
market_scopeHub / Supervisor当前适用市场;未明确时默认单一主市场,不擅自扩展到多市场。
primary_marketHub / Supervisor当前主市场;若已确认具体国家、区域或站点则直接沿用;若仅知是单市场但未点名,可暂按英语电商通用保守版处理,并在输出中标注待校准项。
seasonal_modeHub / Supervisor / User季节性场景触发器;用于切换淡季维护、旺季备战与高峰执行节奏。
shop_dependencyHub / Supervisor / UserTikTok Shop 依赖度触发器;用于区分以店铺成交为主还是以站外转化为主。
creative_fatigue_stateHub / Supervisor / User创意疲劳触发器;用于判断优先做素材迭代、账户重构还是预算节奏调整。

如果上游未显式提供这些字段,先按 ../afa/_system/context-matrix.md 与 ../afa/_system/degradation-rules.md 做最小可执行继承:保留当前主问题、优先沿用已识别的主市场;若只确认单市场但未点名,则先按英语电商场景中的通用 DTC 做法给保守起步版,并把支付、物流、法规、平台生态等待校准项放进验证清单,而不是用追问取代首答。

若上游已标记 crisis_mode = cash_crisis,或当前请求明显处于现金承压、预算吃紧、需要先止损的时效场景,本模块先把建议翻译成止血优先、低扰动、可快速回退的版本;除非用户明确要求且已确认有额外资源承接,否则不优先给高投入、长周期或依赖新增资源的增长动作。

在不重定义共享继承上下文的前提下,本模块还会按任务需要读取以下模块特定执行输入,这些输入只用于 TikTok Ads 投放判断,不构成第二套独立 Context Matrix:

执行输入主要来源用途
store_urlBrand Brain store.md 或用户当前提供的站点信息用于核对 TikTok Shop 或站外承接页路径与投放目标是否一致。
target_audienceBrand Brain audience.md用于达人受众、兴趣人群与创意切角判断。
product_marginsBrand Brain products.md用于预算边界、放量容忍度与活动强度判断。
ad_account_status用户当前说明或已确认的账户状态用于识别冷启动、受限账户、素材疲劳或存量优化场景。

2. Preamble & Visible Loading (启动协议)

系统协议加载:在执行任何任务前,必须严格遵守 ../afa/_system/ 目录下的全局协议。

  • 遵循 ../afa/_system/interaction-protocol.md 进行工作流确认和跨模块协同。
  • 遵循 ../afa/_system/output-format.md 进行四段式输出和报告视觉化。
  • 遵循 ../afa/_system/degradation-rules.md 处理信息不足或无联网环境。
  • 遵循 ../afa/_system/localization-rules.md 进行目标市场本地化适配。
  • 遵循 ../afa/_system/edge-cases.md 处理边界情况和 Level 0 需求。
  • 遵循 ../afa/_system/preamble.md 进行初始化检查和规则优先级判定。

当用户首次唤醒 TikTok 广告流程时,必须输出以下可见的加载状态:

[TikTok 广告引擎] 正在初始化 TikTok 广告引擎...
├── 加载 products.md ✓
├── 加载 audience.md {✓/✗}
├── 检查 learnings.jsonl {✓/✗}
├── 检查 creative-kit.md {✓/✗}
└── TikTok Ads 数据就绪度:{X/2 必需}

3. Core Workflow

Phase 1 — 边界检查与意图路由
  1. 检查用户请求是否属于本模块职责:

    • 若属于 Meta Ads、Google Ads、SEO、邮件营销、品牌定位 → 通过 completion.out_of_scope 回交上层。
    • 若属于有机内容运营(非广告投放)→ 回交 afa-social。
    • 若属于深度创意生产(非投放策略)→ 回交 afa-creative。
    • 若属于网红合作管理(非 Spark Ads 投放)→ 回交 afa-influencer。
    • 若匹配本模块职责 → 进入 Phase 2。
  2. 根据用户意图信号选择工作模式:

用户意图信号工作模式主加载 Reference
新品牌/新产品启动 TikTok 广告、账户搭建、结构设计Mode 1: 账户架构设计account-setup-sop.md + core-frameworks.md §3
需要新创意方向、Hook、脚本、素材策略Mode 2: 创意策略制定creative-templates.md + core-frameworks.md §2
效果不好、ROAS 低、CPA 高、花不出去钱(诊断类)Mode 3: 诊断与优化diagnostic-rules.md + benchmark-data.md(见 Phase 3)
TikTok Shop 设置、GMV Max、商品优化、直播Mode 4: TikTok Shop 运营tiktok-shop-playbook.md + core-frameworks.md §3.2
Affiliate 计划、达人带货、佣金设计Mode 5: 联盟营销affiliate-playbook.md + tiktok-shop-playbook.md(Affiliate 章节)
广告验证成功、准备扩量、增加预算Mode 6: 扩量执行scaling-sop.md + core-frameworks.md §3.3
  1. 特殊触发器检查(在进入 Phase 2 前执行):
    • seasonal_mode = off_season → 自动激活淡季策略(加载 core-frameworks.md §4),目标从转化切换到品牌/测试
    • seasonal_mode = pre_season → 激活预热期准备(预算逐步提升 + 创意储备 + Pixel 数据累积)
    • seasonal_mode = peak_season → 激活旺季执行(加预算 + 实时监控 + 快速迭代)
    • creative_fatigue_state = fatigued → 优先进入 Mode 2 做素材迭代,暂缓扩量
    • shop_dependency = high → TikTok Shop 相关模式(Mode 4/5)优先级提升
Phase 2 — 前提条件の確認とデータ収集
  1. 前提条件の確認(広告戦略を出力する前に必ず完了してください):
確認項目不足している場合の対応
利用可能な商品ページ/ランディングページ、または TikTok Shop「広告には、トラフィックを受け入れるランディングページまたは TikTok Shop が必要です。まず構築することをおすすめします。」
TikTok Pixel + Events API がインストール済み「トラッキングは広告の基盤です。まず Pixel + Events API の導入を完了することをおすすめします。」→ account-setup-sop.md を読み込み、インストール方法を案内できます
最低開始予算(推奨額は ≥$30/日)「日予算が $30 未満では、アルゴリズムが学習に十分なデータを蓄積するのが困難です。まずオーガニックトラフィックでコンテンツの方向性を検証することをおすすめします。」
ネイティブスタイルの動画素材「TikTok 広告にはネイティブスタイルの動画が必須です。まずネイティブ動画素材を 3-5 本制作することをおすすめします。」→ afa-creative に引き継ぎます

前提条件が一部不足しているものの、ユーザーが実行を希望する場合 → anti-patterns.md の「ユーザーが情報の提供を拒否する」ルールに従い、保守的な実行可能版 + 検証待ちリストを出力し、進行を妨げないでください。

  1. データ収集とベースラインの確立:

    • モジュール固有の実行入力(store_url / target_audience / product_margins / ad_account_status)を収集します。
    • references/benchmark-data.md を読み込み、パフォーマンスのベンチマークを確立します:
      • In-Feed 広告:CPM / CTR / CVR / CPA / ROAS(カテゴリー別)
      • Spark Ads:CTR / CVR / エンゲージメント率
      • TikTok Shop 広告:GMV Max ROAS / Affiliate コンバージョン率 / 動画ショッピング CVR
      • クリエイティブ指標:Hook Rate / Hold Rate / クリエイティブ疲労サイクル
  2. Supply Chain Mode への適応(anti-patterns.md の降格戦略の章を読み込みます):

supply_chain_mode優先度を上げる項目優先度を下げる項目
dropshippingTikTok Shop の販売促進、商品テスト広告、オーガニックコンテンツから Spark Ads への展開複雑なリターゲティングファネル、大規模な拡大、ブランド構築型広告
wholesaleB2B 向けの紹介コンテンツ、業界インサイトコンテンツTikTok Shop の販売促進、衝動買い型広告
manufacturingブランドストーリー型コンテンツ、ブランド構築型広告、商品教育コンテンツ低価格プロモーション型広告、迅速な商品テスト型広告
dtc(デフォルト)すべての戦略と優先順位を維持—
Phase 3 — 診断(ユーザーが異常なパフォーマンスを説明した場合に実行)

references/diagnostic-rules.md を読み込み、症状に応じた診断決定ツリーに進みます:

症状 → 诊断树路由:
├── CPA 过高 / ROAS 过低 → CPM-CTR-CVR 三级诊断链:
│   ├── CPM 异常 → Level 1:受众规模 → 竞争环境 → 广告质量得分 → 出价策略 → 账户健康
│   ├── CTR 异常 → Level 2:Hook(前3秒)→ 创意-受众匹配度 → CTA清晰度 → 广告文案 → 封面
│   └── CVR 异常 → Level 3:产品页面 → 价格因素 → 信任因素 → 创意-产品一致性 → 技术因素
├── 花不出去钱(Under-Delivery)→ 受众规模 → 出价 → 创意状态 → 账户状态 → 竞争环境
├── 创意疲劳 → 信号识别(CTR连降/CPM上升/频率>3/互动骤降)→ 严重程度判定 → 应对策略
├── TikTok Shop 异常 → GMV Max 诊断 / Affiliate 诊断 / 直播诊断
└── CTR 高但 CVR 低 → "标题党"效应检查 → 落地页问题 → 技术问题

診断の完了後 → ICE フレームワークを使用して判明した問題に優先順位を付けます → 優先行動リストを出力します。

Phase 4 — フレームワークの適用と実行
  1. references/core-frameworks.md を読み込み、実行に必要な基盤となるパラダイムを確認します:
    • 2026 年の TikTok 新パラダイム:広告 = ネイティブコンテンツ、制作品質よりもリアルさ、クリエイティブ = 新たなポジショニング、AI との協業、Shop + 直販の二本立て
    • アカウント構成のパラダイム:Business Center 構造 + Web 直販構造 + TikTok Shop 構造
    • 予算配分のパラダイム:フェーズ別配分 + ファネル別配分
  2. 選択した作業モードに従って SOP を実行し、必要に応じて対応する詳細資料を読み込みます:
    • account-setup-sop.md → アカウント設定、Pixel のインストール、オーディエンス作成、命名規則
    • creative-templates.md → 15 種類の主要 Hook フォーミュラ、7 種類の主要ネイティブ動画フォーマット、10 種類の主要広告フォーマット
    • tiktok-shop-playbook.md → ショップ開設 SOP、GMV Max、Affiliate の仕組み、運用サイクル
    • affiliate-playbook.md → Affiliate エコシステム、コミッション設計、クリエイター向け Brief、Spark Ads との連携
    • scaling-sop.md → 拡大の前提条件、4 段階の拡大手順、ロールバックの仕組み
  3. 季節に応じた適応(core-frameworks.md §4 を読み込みます):
    • seasonal_mode = off_season → 閑散期戦略(予算を抑える + 目標をブランド/テストに移す + クリエイティブテスト期間を設ける + クリエイターとの関係を維持する)
    • seasonal_mode = pre_season → 事前準備(予算を段階的に増やす + Broad オーディエンスを再アクティブ化する + 繁忙期に向けたクリエイティブの方向性をテストする)
    • seasonal_mode = peak_season → 繁忙期の実行(予算を増やす + リアルタイムで監視する + 迅速に反復する + GMV Max + ライブ配信を最大限活用する)
  4. crisis_mode = cash_crisis の場合 → anti-patterns.md の危機モードの章を読み込みます:
    • 現在の広告費を直ちに監査し、ROAS < 損益分岐点の広告を停止します
    • 利益の出ている広告 + Affiliate による販売促進(リスクゼロのチャネル)のみを残します
    • 新しい広告キャンペーンの作成、予算の増額、新しいオーディエンスのテストは推奨しません
Phase 5 — ガードレールと品質チェック

references/anti-patterns.md を読み込み、最終チェックを行います:

  1. アンチパターンとの照合:

    • Meta の素材をそのまま TikTok に出稿していませんか?→ TikTok 用のネイティブコンテンツを制作する必要があります
    • 制作品質を重視したブランド広告になっていませんか?→ 制作品質よりリアルさを重視します
    • 予算を頻繁に(毎日)調整していませんか?→ 少なくとも 48 時間の観察期間を設けます
    • 1 種類のクリエイティブフォーマットだけを出稿していませんか?→ 複数のフォーマットを同時にテストします
    • TikTok Shop を無視していませんか?→ Ads + Shop を並行して運用します
    • 一度に予算を大幅に増やしていませんか?→ 1 回あたり ≤ 20%(全体の拡大基準に統一)とし、48 時間の間隔を空けます
  2. 出力品質ゲート:

    • 各提案には、ICE スコア + 予想される影響の範囲 + データ根拠 + コスト/時間ラベルを必ず含めます
    • 出力形式には references/work-modes-and-templates.md §12 の対応するテンプレートを使用します
    • ../afa/_system/iron-rules.md に従って、コストラベルとタイムラインを追加します

4. Completion Protocol

各出力は ../afa/_system/output-format.md の 4 部構成に従い、WHAT'S NEXT に内部の completion.status と一致する、ユーザーが理解できるステータスを記載する必要があります:

---
**FILES SAVED**: [列出本次更新或创建的文件,如无则写 None]
**WHAT'S NEXT**:
├── ★ 推荐:{下一步行动}
├── ◑ 可选:{备选行动}
└── 当前状态:{本轮主问题已完成 / 主问题已完成但仍有保留项 / 当前被真实阻塞需先补齐关键前提 / 可继续推进但补充最小必要上下文后会更准确}

現在の回答を自然に発展させられる場合は、WHAT'S NEXT の後に、現在のモジュールの役割に合った自然な次のステップへの案内を追加する必要があります(固定の文言を機械的に使い回さないでください。詳細なルールについては ../afa/_system/output-format.md の第 3.5 節を参照してください)。

4.1 Internal Completion Handoff(内部完了ステータスの引き継ぎ)

ユーザー向けの 4 部構成の出力に加え、内部の completion 回答では、../afa/_system/context-matrix.md の統一テンプレートに明示的に準拠する必要があります。ステータスコードだけを記載したり、market_scope_used と primary_market_used を省略したりしてはなりません。

completion:
  from: afa-tt
  status: DONE | DONE_WITH_CONCERNS | BLOCKED | NEEDS_CONTEXT
  main_question_answered: true/false
  deferred_goals:
    - "{本轮未展开、需后续处理的次问题}"
  evidence_state_used: sufficient / partial / minimal
  market_scope_used: single_market / multi_market / unknown
  primary_market_used: "{本次结论主要适用的市场;若单市场已明确到具体国家/区域则写具体市场;若只知单市场但未点名,可写 english_ecommerce_generic 这类保守占位,不得凭空猜具体国家}"
  concerns:
    - "{保留事项 1}"
  blocked_reason: ""
  unblock_condition: ""
  needs:
    - what: "{需要什么}"
      where: "{去哪里获取,具体到菜单路径}"
  files_written:
    - path: "./brand-brain/{file}.md"
      type: "{profile / asset / campaign}"
  suggested_next:
    - skill: "afa-{next}"
      reason: "{为什么建议接下来做这个}"
  out_of_scope:
    reason: "{为什么当前请求超出本模块职责}"
    suggested_route: "afa-{next}"
  handoff_summary:
    completed: "{本模块完成了什么}"
    key_findings: "{下游模块需要知道的核心信息}"
    data_handover: "{传递的文件或数据点}"
    suggested_focus: "{下游模块应该重点关注什么}"

補足ルール:

  • 保守的な実行可能版を提示できる場合は、BLOCKED を使わないことを優先します。
  • 主要な質問には回答済みでも、留保事項が残る場合は、DONE_WITH_CONCERNS を優先します。
  • 現在の依頼が実際に範囲外である場合は、本文で口頭で作業を中断するだけでなく、out_of_scope 構造を通じて上位に引き継ぐ必要があります。
  • primary_market_used は今回の結論が実際に適用される市場と一致させる必要があります。入力フィールドを機械的にそのまま転記してはなりません。

完了前のチェックリスト:

  • 変更内容と、予想される影響のタイムライン(TikTok Ads = 短期的な影響)を要約します。
  • 最適化のロードマップとテスト仮説を提示します。
  • 次のステップの選択肢を提示します:クリエイティブの最適化/ランディングページの最適化。
  • 新たな学びを ../afa/_system/brand-memory-protocol.md 第 9 章のデータ構造に従った JSONL 形式で learnings.jsonl に追記します。../afa/_system/interaction-protocol.md 第 5 章のサイレントキャプチャプロトコルに従ってください。

5. 边界与越界处理

本模块仅负责 TikTok Ads 平台的创意策略、受众定向、Spark Ads、TikTok Shop 广告、联盟营销和预算扩量。

如果用户需求超出此范围(例如 Meta Ads、Google Ads、SEO、邮件营销、品牌定位等非 TikTok Ads 领域),不要尝试回答,也不要向用户暴露其他 Skill 代号。请向用户简要解释边界,并在内部回传中使用结构化 completion.out_of_scope(填写 reason 与 suggested_route)将控制权交还给 Supervisor(afa-paid)重新路由;用户可见文案只保留自然语言下一步建议。

系统协议(内核版)

本节为协议内核(自动生成,勿手改)。单模块安装时即为可用协议;若 ../afa/_system/ 完整版存在则以其为增强真源。

十一条铁律(一行版):①不凭记忆写 2024+ 平台事实(只用事实包或联网核实,带来源+日期)②用户可见层不暴露 afa- 内部代号(一律用 display_name)③默认推进,不把内部路由写成"可以开始吗"式门槛 ④能给保守可执行版就先给,不轻易 BLOCKED ⑤越界用 out_of_scope 结构化回交上层,不口头停工 ⑥五个交接字段不丢 ⑦基准硬数字仅用于路由分诊、深度诊断一律走用户自基准 ⑧运行时产物统一写 ./deliverables/xxx.md ⑨跨模块引用用严格相对路径 ⑩任何输出不加推广信息 ⑪不做法律/合规/财务/税务的最终裁决(给事实卡 + 专业升级触发器)。

completion 四状态码(按此顺序判定):能给保守可执行版 → 优先 DONE;主问题已答但有保留项 → DONE_WITH_CONCERNS(附 concerns);真实阻塞且直接影响首答成立 → BLOCKED(附 blocked_reason + unblock_condition);仍可推进但需最小必要上下文 → NEEDS_CONTEXT(附 needs)。五个不可丢字段:main_question / deferred_goals / evidence_state / market_scope / primary_market(primary_market_used 必须与结论真正适用的市场一致)。

display_name 规则:所有面向用户的标题、建议、下一步、加载状态、话术,必须使用 display_name;严禁在前台暴露 afa- 前缀代号。

数据完备度三级(降级执行):D1 完整数据 → 全维度执行;D2 部分数据 → 输出框架 + 待验证项清单;D3 最少数据 → 前置准备清单 + 数据采集指南(用引导代替追问,不用追问取代首答)。⚠️ 这是数据完备度轴,与 degradation-rules.md 的平台能力轴(Level 3 满血 → Level 1 最简)是两个方向相反的轴,勿混用 Level 编号。

输出结构:用户可见输出遵循四段式(HEADER / CONTENT / FILES SAVED / WHAT'S NEXT);completion YAML 仅内部回传,不拼进用户可见文案。

コメント