promo-reviewer

宣传文案审核技能

交互式审核并润色专辑 promo/ 文件中的社交媒体文案。逐条查看帖子，选择批准或修改，并将润色后的结果写回文件。

用途

在宣传模板填入各平台文案后，此技能可在发布前提供结构化审核。系统会展示每条帖子及其字符数、话题标签数和平台限制合规情况。用户可选择操作（批准、修改、缩短、增强表达等），润色后的文案会写回文件。

适用场景

• /bitwize-music:promo-writer 生成初版文案后
• 填写 promo/ 模板后（手动填写或在发布准备期间填写）
• 发布前——对社交媒体文案进行最后一轮润色
• 用户说“审核宣传文案”或“润色 [专辑] 的 Twitter 帖子”
• 已有宣传文案但尚未审核时

工作流中的位置

Promo Videos (optional) → [Promo Writer] (or manual) → **[Promo Review]** → Release

位于填写宣传模板之后、release-director 之前。

支持文件

• platform-rules.md — 各平台的字符限制、话题标签规则和语气指南

---

工作流

1. 确定专辑

根据参数确定专辑：

使用 MCP find_album，并传入 $ARGUMENTS 中的专辑名称。如果未指定专辑，则通过 get_session 检查最近的专辑上下文。

定位宣传目录：

{content_root}/artists/{artist}/albums/{genre}/{album}/promo/

检查现有哪些宣传文件及其内容：

在专辑目录中搜索 promo/*.md。逐个检查文件是否包含已填写的内容（而不只是模板占位符）。如果文件中包含超出模板标记的文本，则视为“已填写”——检查代码块中的内容是否不只是 [placeholder text]。

报告状态：

## Promo Copy Status

| Platform | File | Status |
|----------|------|--------|
| Campaign | campaign.md | Populated |
| Twitter/X | twitter.md | Populated |
| Instagram | instagram.md | Template only |
| TikTok | tiktok.md | Not found |
| Facebook | facebook.md | Populated |
| YouTube | youtube.md | Template only |

3 of 6 platforms have copy ready for review.

如果没有已填写的宣传文件：

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

2. 选择平台

如果参数中指定了平台，则只审核该平台。

否则，询问：

Which platforms to review?

[A] All populated platforms (campaign, twitter, facebook)
[1] Campaign strategy
[2] Twitter/X posts
[3] Facebook posts

仅将已填写的平台列为带编号的选项。

3. 解析章节

针对每个选定平台的文件：

1. 使用 Read 工具读取整个文件
2. 按标题边界拆分——## 和 ### 标题用于划分章节
3. 提取代码块——``` 围栏内的内容即为实际帖子文案
4. 识别可审核章节——包含非占位符文本代码块的章节
5. 统计每条帖子的指标：
   • 字符数（所有平台的话题标签均计入限制）
   • 话题标签数
   • 行数
   • 平台限制合规情况（参见 platform-rules.md）
6. 检测串文——如果代码块中包含编号推文（1/、2/、3/），则拆分为单条推文，并分别审核、统计字符数

4. 逐条审核循环

针对每个可审核章节，展示帖子及其上下文：

## Twitter/X — Track 01: Track Title
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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

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

1. 生成修改后的版本
2. 展示该版本及更新后的指标
3. 提供后续选项：

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

5. Campaign.md 特殊处理

Campaign 文件包含策略表格和消息文案，而非代码块帖子。调整审核方式：

• 逐个展示各章节（概览、关键信息、日程等），作为可审核单元
• 将“增强表达”替换为 “[M] 强化信息传达”——精简策略性措辞
• 跳过字符限制——Campaign 文档不受平台限制
• 重点关注：清晰度、与专辑主题的一致性、可执行的日程条目、元数据字段是否完整

6. 写回文件

审核完某个平台的所有章节后：

1. 重建文件，将已批准或修改的内容放回原位
2. 使用 Edit 工具，将修改应用到宣传文件
3. 确认写入：

Updated twitter.md — 4 posts revised, 2 approved as-is, 1 skipped

只有至少有一个章节经过修改时才写回。如果所有章节均按原样批准或跳过，则跳过写入步骤。

7. 进度跟踪

切换平台时，显示持续更新的汇总：

## Review Progress

| Platform | Approved | Revised | Skipped | Limit Issues |
|----------|----------|---------|---------|--------------|
| Twitter  | 4        | 2       | 1       | 0            |
| Facebook | —        | —       | —       | —            |

Next: Facebook (5 sections to review)
Continue? [Y/n]

8. 会话摘要

审核完所有平台后：

## Promo Review Complete

| Platform | Approved | Revised | Skipped |
|----------|----------|---------|---------|
| Campaign | 3        | 1       | 0       |
| Twitter  | 4        | 2       | 1       |
| Facebook | 3        | 2       | 0       |
| **Total** | **10** | **5** | **1** |

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>

---

修改指南

修改帖子时，请遵循以下原则：

精简（S）

• 删除填充词（“really”“very”“just”）
• 尽可能合并句子
• 优先突出吸引力——开头先呈现最引人注目的内容
• 遵守平台限制（参见 platform-rules.md）

加强表达（P）

• 使用更有力的动词和更生动的语言
• 增添紧迫感或好奇心
• 以吸引人的内容开头，而非描述
• 保留核心信息——只是让表达更有冲击力

添加话题标签（H）

• 根据音乐类型、专辑主题和平台惯例，建议 3-5 个相关话题标签
• 提供选项，由用户决定使用哪些
• 遵循平台专属的话题标签惯例（参见 platform-rules.md）
• 话题标签数量不得超过平台上限

改写语气（T）

• 改写前先询问用户希望采用的语气
• 常见语气：轻松、专业、热情、神秘、叙事、紧迫
• 保留事实内容——只调整表达方式和风格
• 让语气符合平台预期

加强信息传达（M）——仅限 Campaign

• 精炼策略性语言
• 让关键信息更令人难忘、更值得引用
• 确保日程条目具体且可执行
• 核实信息传达与专辑主题一致

---

平台专属审核重点

Twitter/X

• 每条帖子少于 280 个字符（硬性限制）
• 串文中的每条推文都应独立成篇，同时彼此关联
• 最多使用 1-2 个话题标签（更多会显得像垃圾信息）
• 发布内容中应包含流媒体链接

Instagram

• 配文可以很长（2,200 个字符），但“更多”按钮前只显示开头 125 个字符
• 第一行就要吸引人——这是人们唯一能看到的内容
• 将话题标签作为末尾的独立区块
• 最适合使用 15-20 个话题标签（最多 30 个）

TikTok

• 最好少于 150 个字符（无需点击即可显示）
• 最多 4,000 个字符，但越短越好
• 使用 3-5 个话题标签；适用时加入热门标签
• 语气轻松、真实

Facebook

• 较长的叙事内容效果不错
• “查看更多”前显示开头 2-3 行
• 使用 3-5 个话题标签（这个平台对话题标签的依赖度较低）
• 添加行动号召

YouTube

• 说明支持时间戳、鸣谢和链接
• 折叠视图中显示开头 2-3 行
• 包含流媒体链接、社交链接和鸣谢
• 使用 3-5 个话题标签（显示在标题上方）

---

请记住

1. 开始处理时阅读 platform-rules.md，了解当前限制
2. 每次只呈现一条帖子——不要批量审核
3. 每条帖子都展示指标——字符数、话题标签数、是否符合限制
4. 绝不自动批准——每条帖子都必须由用户审核
5. 只写回有修改的文件——不要触碰未修改的文件
6. 跟踪进度——汇报各平台之间的累计数量
7. Campaign 有所不同——它是策略文档，不是社交帖子
8. 保留用户的表达风格——修改应当提升，而非取代用户的风格
9. 标出超限内容——突出显示超过平台字符数限制的帖子
10. 检测占位符——标出仍需补充实际内容的 [placeholder] 文本