manage-campaign
在活动生命周期中检索和管理广告活动状态。在检查活动状态、通过ID检索活动数据、了解活动完成进度或确定活动工作流中的下一步时使用。在请求获取活动详情、检查活动状态、查看活动进度或检索存储的活动数据时触发。
📖 中文导读:在活动生命周期中检索和管理广告活动状态。在检查活动状态、通过ID检索活动数据、了解活动完成进度或确定活动工作流中的下一步时使用。在请求获取活动详情、检查活动状态、查看活动进度或检索存储的活动数据时触发。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: manage-campaign description: Retrieve and manage advertising campaign state throughout the campaign lifecycle. Use when checking campaign status, retrieving campaign data by ID, understanding campaign completion progress, or determining next steps in the campaign workflow. Triggers on requests to get campaign details, check campaign status, view campaign progress, or retrieve stored campaign data.
Manage Campaign
Overview
Retrieve and manage advertising campaign state. Campaigns progress through a defined workflow: parameters → research → ad copy → images → mixed media. This skill helps track progress and determine next steps.
When to Use This Skill
Use this skill when:
- Retrieving campaign data by ID
- Checking campaign completion status
- Determining next workflow step
- Viewing stored campaign parameters, research, or assets
- Understanding what components are complete or pending
Campaign Lifecycle
Campaigns follow this workflow:
1. parseAdRequirements → Creates campaign with parameters
2. conductAdResearch → Adds research report
3. generateAdCopy → Adds ad copy variations (A/B)
4. generateAdImages → Adds image variations (A/B)
5. generateMixedMedia → Creates final composite
Each step stores results in the campaign record.
Campaign Data Structure
A campaign contains:
| Field | Description | Set By |
|---|---|---|
| id | UUID identifier | parseAdRequirements |
| parameters | Campaign parameters (product, audience, platform, etc.) | parseAdRequirements |
| research | Research report with insights and recommendations | conductAdResearch |
| ad_copy | Two ad copy variations (A/B) | generateAdCopy |
| images | Two image variations (A/B) | generateAdImages |
| mixed_media | Final composite creative | generateMixedMedia |
| selected_ad_copy_variation | User's chosen copy (A or B) | User selection |
| selected_image_variation | User's chosen image (A or B) | User selection |
Completion Status
Check these flags to determine campaign progress:
- hasParameters: Campaign parameters are set
- hasResearch: Research report is complete
- hasAdCopy: Ad copy variations generated
- hasImages: Image variations generated
- hasMixedMedia: Final creative is ready
- hasSelectedAdCopy: User selected a copy variation
- hasSelectedImage: User selected an image variation
- isComplete: All components are present
Workflow Guidance
Determining Next Step
Based on completion status, recommend:
| Status | Next Action |
|---|---|
| No parameters | Call parseAdRequirements |
| Parameters only | Call conductAdResearch |
| Has research | Call generateAdCopy |
| Has ad copy | Call generateAdImages |
| Has images | User selects variations, then generateMixedMedia |
| Complete | Campaign ready for deployment |
Handling Missing Selections
Before generating mixed media:
- Check if ad copy variation is selected
- Check if image variation is selected
- If not selected, prompt user to choose A or B
Output Format
When reporting campaign status, return:
{
"campaign_id": "uuid",
"campaign_name": "name or null",
"status": "in_progress or complete",
"completion": {
"hasParameters": true,
"hasResearch": true,
"hasAdCopy": false,
"hasImages": false,
"hasMixedMedia": false,
"hasSelectedAdCopy": false,
"hasSelectedImage": false
},
"next_step": "generateAdCopy",
"next_step_description": "Generate ad copy variations based on research insights",
"created_at": "ISO timestamp",
"updated_at": "ISO timestamp"
}
Important Notes
- Campaign IDs are UUIDs - validate format before querying
- All campaign data is persisted in PostgreSQL
- Each workflow step updates the campaign record
- Missing components block downstream steps
- User selections are required before mixed media generation