快速入门

在上传第一个技能之前，请完成本文中的前提条件。

前提条件

在将技能上传到 TikTok for Business Developers 门户网站之前，你需要： 1. 创建 TikTok for Business 账号。这将为你开通 TikTok for Business 生态的访问权限。 2. 注册成为开发者。这将解锁 "我的技能" 模块和技能上传功能。

注意
如果你之前已经使用过任意 TikTok API for Business 接口，则上述两个前置条件已满足，可直接开始准备技能文件。

准备符合要求的技能文件

在上传技能之前，请确保你的技能文件符合平台的格式和结构要求。

结构规范的文件不仅能更快通过审核，也能为使用你的指令的智能体带来更优体验。

文件要求

|类别 {25%}|要求 {75%}|
|---|---|
|格式|必须为一个 `.zip` 压缩包，且其中同时包含 `SKILL.md` 和 `README.md` 两个文件（区分大小写）。<br><br>`SKILL.md` 必须直接放在压缩包根目录。|
|大小|最大文件大小：50 MB（压缩后）。|
|命名|仅可使用小写字母、数字和连字符。不支持使用空格、大写字母或特殊字符。<br><br>名称必须具有描述性，并以动作导向表达，例如 `launch-app-campaign`。避免使用 `skill1` 这类泛化名称。<br><br>.zip 命名格式： `Company name-skill goals-Version number`（仅英文）。后续更新时，仅修改版本号。示例：`a3-company-budget-optimization-skill-v1`<br><br>`SKILL.md` 文件 YAML frontmatter 中的 `name` 字段需和在开发者门户网站上传技能表单中填写的 Skill Name 保持一致。|
|Frontmatter|必须是有效的 YAML 格式（使用 `---` 分隔），并包含 `name` 与 `description` 字段。<br><br>其后必须紧跟 Markdown 正文。|
|描述|清楚说明技能功能及适用场景。<br><br>以主要使用场景开头。<br><br>建议长度：1,536 个字符。|
|正文|提供清晰、可执行的智能体指令。<br><br>建议长度： 15,000 到 20,000 个字符之间。<br><br>较长的参考材料请放入 `reference/` 目录中。|

压缩包结构

你的技能必须打包为 .zip 压缩包，并遵循面向 AI 智能体使用场景的结构化格式。请按如下方式组织你的压缩包：

(code curl http)
launch-app-campaign/
├── SKILL.md              # Main skill file (required)
├── README.md             # Documentation for human users (required)
├── reference/            # Supporting reference files (optional)
│   ├── optimization-rules.md
│   ├── benchmarks.json
│   └── templates/
│       └── report-template.md
├── scripts/              # Optional automation scripts (optional)
│   └── data-processing.py
└── config.json           # Optional configuration schema (optional)
(/code)

组件说明： - SKILL.md：包含 YAML frontmatter（如名称、描述、版本、作者和权限等元数据）以及引导 AI 智能体完成工作流程的详细指令。 - README.md：面向人类用户的文档，用于说明该技能的功能、前置条件以及使用方法。与 SKILL.md 文件一样，该文件必须直接放置在压缩包的根目录下（区分大小写）。 - reference/：智能体在执行过程中可查阅的补充文档，例如优化规则、基准数据或报告模板。 - scripts/：智能体可调用的可执行脚本，用于数据处理、API 调用或其他自动化任务。 - config.json：定义可配置参数的数据结构，允许广告主在不修改核心指令的情况下自定义技能行为。

SKILL.md 示例

下面是一个结构良好的 SKILL.md 文件示例，展示了合法的 YAML frontmatter，以及包含清晰可执行指令的 Markdown 正文：

(code curl http)
---
name: "campaign-performance-optimizer"        # Skill name (required), must match the Skill Name field used when uploading the skill.
description: "Use this Skill when you need to evaluate campaign performance and take optimization actions. It analyzes performance data, identifies underperforming ad groups, and generates actionable recommendations."
version: "1.0.0"
author: "Developer Company Name"
use_case: "Ads Management"
permissions:
  - campaign_management
  - reporting_analytics
---

# Campaign Performance Optimizer

## Description
This Skill helps you monitor and optimize TikTok ad campaign performance. Provide a date range and target CPA, and the Skill will identify underperforming ad groups and suggest specific optimization actions.

## Process
1. Pull campaign performance data for the specified date range
2. Identify ad groups where CPA exceeds target by 20%+
3. Generate optimization recommendations
...
(/code)

编写有效的 description

description 字段是最重要的字段。智能体会用它来判断该技能是否相关。编写时应同时表达两层信息：一是技能本身的能力，二是用户可能会使用的自然语言表达方式。

推荐示例：

(code curl http)
description: Launches a TikTok catalog ads campaign end to end. Use when the user wants product sales, catalog remarketing, or to promote a product feed.
(/code)

待改进的示例（过于模糊，难以稳定匹配）：

(code curl http)
description: Helps with ads.
(/code)

编写有效的正文

• 写清楚要做什么，避免大段描述冗长的过程或背景原因。正文一旦加载就会保留在上下文中，因此每一行都会成为持续成本。
• 将 SKILL.md 控制在 15,000–20,000 个字符以内。将较长的参考材料移到支持文件中。
• 对任何写操作或花费预算操作前，都要加入明确的确认步骤。
• 指定你期望的精确输出格式（如表格、JSON、摘要），以确保结果一致。
• 处理空结果和错误场景（如果没有返回数据，请明确说明）。

README.md 要求

每个技能包都必须包含一个 README.md 文件，用于说明该技能的实际使用方式。

必需元素

|元素{30%}|说明{70%}|
|---|---|
|项目名和一句话摘要|说明它是什么，以及解决什么问题。|
|快速开始|最简单的安装与运行示例。|
|目标平台|是否有平台使用限制（如有请标明）。<br><br>目标平台包括：ChatGPT，Claude，Gemini 等。|
|前置条件 / 依赖|运行环境、权限要求、依赖项，以及是否使用了 TikTok for Business MCP 服务器之外的任何 MCP 或智能体（如有请标明使用方式）。|
|配置说明|说明有哪些可配置项，以及默认值是什么。|

推荐元素

|元素{30%}|说明{70%}|
|---|---|
|常见错误与处理|遇到问题怎么自查。|
|限制与注意事项|边界场景与已知问题。|
|联系方式|由谁维护，以及如何反馈问题。|

后续步骤

文件准备就绪后，可继续上传并发布技能。