Back to Details

promo-reviewer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Promo Reviewer Skill

Promo Reviewer Skill

Interactive review and polish of social media copy in album 
promo/
files. Walk through each post, approve or revise, and write polished results back to the file.
对专辑
promo/
文件中的社交媒体文案进行交互式审核与打磨。逐一查看每个帖子，选择批准或修改，并将打磨后的结果写回文件。

Purpose

用途

After promo templates are populated with platform-specific copy, this skill provides structured review before release. Each post is presented with character counts, hashtag counts, and platform limit compliance. The user chooses actions (approve, revise, shorten, punch up, etc.) and polished copy is written back.
当推广模板填充好各平台专属文案后，本Skill可在发布前提供结构化审核。每个帖子会附带字符数、话题标签数量以及平台合规性检查结果。用户可选择操作（批准、修改、精简、优化感染力等），打磨后的文案将被写回文件。

When to Use

使用时机

  • After 
    /bitwize-music:promo-writer
    generates initial copy
  • After populating promo/ templates (manually or during release prep)
  • Before release — final polish pass on social media copy
  • User says "review promo copy" or "polish the twitter posts for [album]"
  • When promo copy exists but hasn't been reviewed
  • 在
    /bitwize-music:promo-writer
    生成初始文案之后
  • 在填充promo/模板之后（手动填充或发布准备阶段）
  • 发布前——对社交媒体文案进行最终打磨
  • 用户提出“审核推广文案”或“打磨[专辑名]的Twitter帖子”等需求时
  • 已有推广文案但尚未审核时

Position in Workflow

在工作流中的位置

Promo Videos (optional) → [Promo Writer] (or manual) → **[Promo Review]** → Release
Between populating promo templates and release-director.
推广视频（可选）→ [推广文案撰写工具]（或手动）→ **[推广文案审核]** → 发布
位于填充推广模板和发布管理工具之间。

Supporting Files

支持文件

  • platform-rules.md — Per-platform character limits, hashtag rules, tone guidelines
  • platform-rules.md — 各平台的字符限制、话题标签规则、语气指南

Workflow

工作流程

1. Album Resolution

1. 专辑定位

Resolve the album from arguments:
Use MCP 
find_album
with the album name from 
$ARGUMENTS
. If no album specified, check 
get_session
for last album context.
Locate promo directory:
{content_root}/artists/{artist}/albums/{genre}/{album}/promo/
Check which promo files exist and have content:
Glob for 
promo/*.md
in the album directory. For each file, check if it contains populated content (not just template placeholders). A file is "populated" if it contains text beyond the template markers — look for content inside code blocks that isn't 
[placeholder text]
.
Report status:
undefined
通过参数确定专辑：
使用MCP的
find_album
工具，根据
$ARGUMENTS
中的专辑名称查找专辑。若未指定专辑，则检查
get_session
获取最近的专辑上下文。
定位推广目录：
{content_root}/artists/{artist}/albums/{genre}/{album}/promo/
检查存在且已填充内容的推广文件：
在专辑目录中匹配
promo/*.md
文件。对每个文件，检查是否已填充内容（而非仅模板占位符）。若文件包含模板标记之外的文本——即代码块内的内容不是
[placeholder text]
，则视为“已填充”。
报告状态：
undefined

Promo Copy Status

推广文案状态

PlatformFileStatus
Campaigncampaign.mdPopulated
Twitter/Xtwitter.mdPopulated
Instagraminstagram.mdTemplate only
TikToktiktok.mdNot found
Facebookfacebook.mdPopulated
YouTubeyoutube.mdTemplate only
3 of 6 platforms have copy ready for review.

If no promo files are populated:
No promo copy found to review.
Options:
  1. Generate promo copy: /bitwize-music:promo-writer <album-name>
  2. Populate promo templates manually (fill in promo/ files)
  3. Skip promo review and proceed to release
undefined
平台文件状态
推广活动campaign.md已填充
Twitter/Xtwitter.md已填充
Instagraminstagram.md仅模板
TikToktiktok.md未找到
Facebookfacebook.md已填充
YouTubeyoutube.md仅模板
6个平台中有3个的文案已准备好审核。

若没有已填充的推广文件：
未找到可审核的推广文案。
可选操作：
  1. 生成推广文案：/bitwize-music:promo-writer <专辑名称>
  2. 手动填充推广模板（填写promo/文件）
  3. 跳过推广审核，直接进入发布环节
undefined

2. Platform Selection

2. 平台选择

If platform specified in arguments, review only that platform.
Otherwise, ask:
Which platforms to review?

[A] All populated platforms (campaign, twitter, facebook)
[1] Campaign strategy
[2] Twitter/X posts
[3] Facebook posts
List only populated platforms as numbered options.
若参数中指定了平台，则仅审核该平台的文案。
否则，询问用户：
需要审核哪些平台的文案？

[A] 所有已填充的平台（推广活动、Twitter、Facebook）
[1] 推广活动策略
[2] Twitter/X帖子
[3] Facebook帖子
仅列出已填充平台作为编号选项。

3. Section Parsing

3. 内容分段解析

For each selected platform file:
  1. Read the full file using the Read tool
  2. Split at heading boundaries — 
    ##
    and 
    ###
    headings delineate sections
  3. Extract code blocks — content inside ``` fences is the actual post copy
  4. Identify reviewable sections — sections with code blocks containing non-placeholder text
  5. Count metrics for each post:
    • Character count (hashtags count toward the limit on all platforms)
    • Hashtag count
    • Line count
    • Platform limit compliance (from platform-rules.md)
  6. Thread detection — if a code block contains numbered tweets (1/, 2/, 3/), split into individual tweets and review each separately with per-tweet char counts
对每个选中的平台文件：
  1. 使用读取工具读取完整文件
  2. 按标题边界拆分 — 
    ##
    和
    ###
    标题用于划分章节
  3. 提取代码块 — ```围栏内的内容为实际帖子文案
  4. 识别可审核章节 — 包含非占位符文本代码块的章节
  5. 统计每个帖子的指标：
    • 字符数（所有平台的话题标签都计入限制）
    • 话题标签数量
    • 行数
    • 平台合规性（参考platform-rules.md）
  6. 线程检测 — 若代码块包含编号推文（1/, 2/, 3/），则拆分为独立推文，分别审核并统计每条推文的字符数

4. Per-Post Review Loop

4. 单帖审核循环

For each reviewable section, present the post with context:
undefined
对每个可审核章节，附带上下文展示帖子：
undefined

Twitter/X — Track 01: Track Title

Twitter/X — 曲目01：曲目名称

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Track one tells the story of [concept].
Listen now: [link]
#NewMusic #HipHop
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Chars: 87/280 | Hashtags: 2 | Status: Within limits ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Actions: [A] Approve — keep as-is [R] Revise — give feedback for rewrite [S] Shorten — make more concise [P] Punch up — make more engaging/attention-grabbing [H] Add hashtags — suggest relevant hashtags [T] Rewrite tone — specify tone (casual, professional, hype, etc.) [K] Skip — move to next without changes

**After any revision action (R, S, P, H, T):**

1. Generate the revised version
2. Present it with updated metrics
3. Offer follow-up:
Revised version: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[revised copy here]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Chars: 142/280 | Hashtags: 3 | Status: Within limits ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[A] Approve this version [R] Revise again — more feedback [D] Discard — revert to original
undefined
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第一首歌讲述了[主题]的故事。
立即收听：[链接]
#NewMusic #HipHop
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 字符数：87/280 | 话题标签：2 | 状态：符合限制 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
操作选项： [A] 批准 — 保持原样 [R] 修改 — 提供重写反馈 [S] 精简 — 让内容更简洁 [P] 优化感染力 — 让内容更具吸引力/抓眼球 [H] 添加话题标签 — 推荐相关话题标签 [T] 调整语气 — 指定语气（随意、专业、亢奋等） [K] 跳过 — 直接进入下一个，不做修改

**执行任何修改操作（R、S、P、H、T）后：**

1. 生成修改后的版本
2. 附带更新后的指标展示
3. 提供后续选项：
修改后的版本： ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[修改后的文案]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 字符数：142/280 | 话题标签：3 | 状态：符合限制 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[A] 批准此版本 [R] 再次修改 — 提供更多反馈 [D] 放弃 — 恢复为原始版本
undefined

5. Campaign.md Special Handling

5. Campaign.md 特殊处理

Campaign files contain strategy tables and messaging, not code-block posts. Adjust the review approach:
  • Present each section (Overview, Key Messages, Schedule, etc.) as a reviewable unit
  • Replace "Punch up" with "[M] Strengthen messaging" — tighten the strategic language
  • Skip character limits — campaign docs have no platform limits
  • Focus on: clarity, consistency with album themes, actionable schedule entries, complete metadata fields
推广活动文件包含策略表格和信息传递内容，而非代码块形式的帖子。需调整审核方式：
  • 逐个展示章节（概述、核心信息、日程安排等）作为可审核单元
  • 将“优化感染力”替换为“[M] 强化信息传递” — 精简策略性语言
  • 跳过字符限制检查 — 推广活动文档无平台限制
  • 审核重点：清晰度、与专辑主题的一致性、日程安排的可执行性、元数据字段的完整性

6. Write-Back

6. 写回文件

After all sections for a platform are reviewed:
  1. Reconstruct the file with approved/revised content in place
  2. Use the Edit tool to apply changes to the promo file
  3. Confirm write:
Updated twitter.md — 4 posts revised, 2 approved as-is, 1 skipped
Only write back if at least one section was revised. If all sections were approved as-is or skipped, skip the write step.
完成某个平台的所有章节审核后：
  1. 重构文件，将批准/修改后的内容替换进去
  2. 使用编辑工具将更改应用到推广文件
  3. 确认写入：
已更新twitter.md — 4个帖子被修改，2个帖子批准通过，1个帖子被跳过
仅当至少有一个章节被修改时才执行写回操作。若所有章节均被批准或跳过，则跳过写回步骤。

7. Progress Tracking

7. 进度跟踪

Between platforms, show a running summary:
undefined
在不同平台审核之间，展示实时进度汇总：
undefined

Review Progress

审核进度

PlatformApprovedRevisedSkippedLimit Issues
Twitter4210
Facebook————
Next: Facebook (5 sections to review) Continue? [Y/n]
undefined
平台已批准已修改已跳过合规问题
Twitter4210
Facebook————
下一个：Facebook（需审核5个章节） 继续？[Y/n]
undefined

8. Session Summary

8. 会话总结

After all platforms reviewed:
undefined
完成所有平台的审核后：
undefined

Promo Review Complete

推广审核完成

PlatformApprovedRevisedSkipped
Campaign310
Twitter421
Facebook320
Total1051
Char limit compliance: All posts within platform limits
Files updated:
  • promo/campaign.md (1 revision)
  • promo/twitter.md (2 revisions)
  • promo/facebook.md (2 revisions)
Next steps:
  1. Review any skipped posts if needed
  2. Add streaming links when available (replace [Streaming Link] placeholders)
  3. Ready for release: /bitwize-music:release-director <album>

---
平台已批准已修改已跳过
推广活动310
Twitter421
Facebook320
总计1051
字符限制合规性：所有帖子均符合平台限制
已更新文件：
  • promo/campaign.md（1处修改）
  • promo/twitter.md（2处修改）
  • promo/facebook.md（2处修改）
后续步骤：
  1. 若需要，审核已跳过的帖子
  2. 可用时添加流媒体链接（替换[Streaming Link]占位符）
  3. 准备发布：/bitwize-music:release-director <专辑名称>

---

Revision Guidelines

修改指南

When revising posts, follow these principles:
修改帖子时，请遵循以下原则：

Shorten (S)

精简（S）

  • Cut filler words ("really", "very", "just")
  • Combine sentences where possible
  • Prioritize the hook — lead with the most compelling element
  • Respect platform limits (see platform-rules.md)
  • 删除冗余词汇（“really”、“very”、“just”）
  • 尽可能合并句子
  • 优先保留钩子内容——以最具吸引力的元素开头
  • 遵守平台限制（参考platform-rules.md）

Punch Up (P)

优化感染力（P）

  • Stronger verbs, more vivid language
  • Add urgency or curiosity
  • Open with a hook, not a description
  • Keep the core message — just make it hit harder
  • 使用更有力的动词、更生动的语言
  • 添加紧迫感或好奇心
  • 以钩子开头，而非描述性内容
  • 保留核心信息——只是让它更有冲击力

Add Hashtags (H)

添加话题标签（H）

  • Suggest 3-5 relevant hashtags based on genre, album themes, platform norms
  • Present options — user picks which to include
  • Follow platform-specific hashtag conventions (see platform-rules.md)
  • Never exceed platform maximum
  • 根据流派、专辑主题、平台规范推荐3-5个相关话题标签
  • 提供选项——由用户选择添加哪些
  • 遵循平台专属的话题标签惯例（参考platform-rules.md）
  • 绝不超过平台上限

Rewrite Tone (T)

调整语气（T）

  • Ask user for target tone before rewriting
  • Common tones: casual, professional, hype, mysterious, storytelling, urgent
  • Preserve factual content — only change voice and style
  • Match tone to platform expectations
  • 重写前询问用户目标语气
  • 常见语气：随意、专业、亢奋、神秘、叙事、紧迫
  • 保留事实内容——仅改变语气和风格
  • 确保语气符合平台预期

Strengthen Messaging (M) — Campaign only

强化信息传递（M）—— 仅适用于推广活动文件

  • Tighten strategic language
  • Make key messages more memorable and quotable
  • Ensure schedule entries are specific and actionable
  • Verify consistency between messaging and album themes
  • 精简策略性语言
  • 让核心信息更易记、更具传播性
  • 确保日程安排条目具体且可执行
  • 验证信息传递与专辑主题的一致性

Platform-Specific Review Focus

平台专属审核重点

Twitter/X

Twitter/X

  • Every post under 280 chars (hard limit)
  • Thread tweets: each tweet standalone but connected
  • 1-2 hashtags max (more looks spammy)
  • Streaming link in release posts
  • 所有帖子不超过280字符（硬性限制）
  • 线程推文：每条推文独立但相互关联
  • 最多1-2个话题标签（过多会显得像垃圾信息）
  • 发布帖子中包含流媒体链接

Instagram

Instagram

  • Caption can be long (2,200 chars) but first 125 visible before "more"
  • Hook in first line — it's the only thing people see
  • Hashtags as separate block at end
  • 15-20 hashtags is optimal (30 max)
  • 标题可长达2200字符，但前125字符在“查看更多”前可见
  • 第一行设置钩子——这是用户唯一能直接看到的内容
  • 话题标签放在末尾单独区块
  • 最佳数量为15-20个（最多30个）

TikTok

TikTok

  • Under 150 chars ideal (visible without tap)
  • 4,000 char max but shorter is better
  • 3-5 hashtags, trending ones if applicable
  • Casual, authentic tone
  • 理想长度为150字符以内（无需点击即可查看全部）
  • 最大字符数为4000，但越短越好
  • 3-5个话题标签，可使用热门话题标签
  • 语气随意、真实

Facebook

Facebook

  • Longer storytelling works well
  • First 2-3 lines visible before "See more"
  • 3-5 hashtags (less hashtag-driven platform)
  • Include call to action
  • 较长的叙事内容效果较好
  • 前2-3行在“查看更多”前可见
  • 3-5个话题标签（该平台对话题标签依赖度较低）
  • 包含行动号召

YouTube

YouTube

  • Description supports timestamps, credits, links
  • First 2-3 lines visible in collapsed view
  • Include streaming links, social links, credits
  • 3-5 hashtags (shown above title)
  • 描述支持时间戳、制作人员信息、链接
  • 折叠视图下仅显示前2-3行
  • 包含流媒体链接、社交媒体链接、制作人员信息
  • 3-5个话题标签（显示在标题上方）

Remember

注意事项

  1. Read platform-rules.md at invocation start for current limits
  2. Present one post at a time — don't batch review
  3. Show metrics with every post — chars, hashtags, limit compliance
  4. Never auto-approve — every post gets user review
  5. Write back only changed files — don't touch files with no revisions
  6. Track progress — running counts between platforms
  7. Campaign is different — strategy doc, not social posts
  8. Preserve user voice — revisions should enhance, not replace the user's style
  9. Flag limit violations — highlight posts over platform char limits
  10. Placeholder detection — flag remaining 
    [placeholder]
    text that needs real content
  1. 调用时先阅读platform-rules.md，获取当前的平台限制
  2. 一次只展示一个帖子——不要批量审核
  3. 每个帖子都要展示指标——字符数、话题标签数量、合规性
  4. 绝不自动批准——每个帖子都需用户审核
  5. 仅写回有修改的文件——不要改动未修改的文件
  6. 跟踪进度——在不同平台审核之间展示实时统计
  7. 推广活动文件特殊处理——这是策略文档，而非社交帖子
  8. 保留用户语气——修改应是优化，而非替换用户的风格
  9. 标记违规内容——突出显示超过平台字符限制的帖子
  10. 检测占位符——标记需要替换为真实内容的
    [placeholder]
    文本