mcpField
C
content-brief-generator

content-brief-generator

github.com/jamesrochabrun营销与增长221202 次安装41 周前更新
代码仓库

关于 content-brief-generator

content-brief-generator 是为写作者和内容团队创建结构化内容简报的技能。模板和指南涵盖受众、目标、SEO、内容要求及成效指标,适用于多种内容形式。

主要功能

  1. 01交互式生成内容简报
  2. 02多种内容类型的模板
  3. 03定义受众与业务目标
  4. 04SEO 关键词与搜索意图
  5. 05语气、结构和媒体要求
  6. 06简报完整性检查

适用场景

  1. 01规划博客文章或落地页
  2. 02明确技术文档的编写要求
  3. 03统一写作者对受众、语气和目标的理解
  4. 04设定内容成效指标

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jamesrochabrun/skills --skill content-brief-generator

安装后在 Claude Code 中输入/content-brief-generator确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
content_frameworks.md
seo_guidelines.md
tone_voice_guide.md
scripts/
generate_brief.sh
validate_brief.sh

详细介绍

内容简报生成器

一套全面的技能,用于创建详细的内容简报,指导写作者、确保内容一致,并使内容与业务目标保持一致。

此技能的作用

帮助你为以下内容创建专业的内容简报:

  • 博客文章和文章 - 思想领导力、教程、操作指南
  • 技术文档 - API 文档、指南、README 文件
  • 营销文案 - 着陆页、电子邮件营销活动、广告
  • 社交媒体内容 - 帖子、营销活动、话题串
  • 案例研究 - 客户成功故事
  • 白皮书和报告 - 深度研究内容
  • 产品描述 - 电商和产品页面
  • 视频脚本 - YouTube 视频、讲解视频、演示

内容简报为何重要

没有简报:

  • 预期和范围不明确
  • 需要多轮修改
  • 语气和信息不一致
  • 错失 SEO 机会
  • 浪费时间和资源

有了简报:

  • 方向和目标明确
  • 减少修改次数
  • 质量一致
  • 针对 SEO 优化的内容
  • 高效的工作流

内容简报的核心组成部分

1. 内容概述
  • 标题/暂定标题
  • 内容类型(博客、文档、着陆页等)
  • 目标受众
  • 主要目标(教育、转化、娱乐等)
  • 核心信息或要点
2. 受众与背景
  • 目标用户画像
  • 读者的知识水平
  • 痛点和需求
  • 他们所处的转化漏斗阶段
  • 他们将如何发现内容
3. 策略要素
  • 业务目标
  • SEO 关键词和搜索意图
  • 竞争格局
  • 成功指标
  • CTA 和转化目标
4. 内容要求
  • 语气和风格
  • 长度/字数
  • 结构和章节
  • 研究要求
  • 视觉/媒体需求
5. SEO 与分发
  • 主要和次要关键词
  • 搜索意图
  • 元描述
  • 内部/外部链接
  • 分发渠道

内容类型与模板

博客文章简报

适用场景: 思想领导力、教程、清单式文章、操作指南

关键要素:

  • 吸引人的开头和引言角度
  • 主要要点(通常为 3-7 个)
  • 需要包含的示例和数据
  • 行动号召
  • 内部链接策略
技术文档简报

适用场景: API 文档、指南、开发者文档

关键要素:

  • 技术准确性要求
  • 所需代码示例
  • 受众的技术水平
  • 前置条件
  • 相关文档
着陆页简报

适用场景: 产品页面、注册页面、营销活动页面

关键要素:

  • 价值主张
  • 优势与功能
  • 社会认同要求
  • 转化目标
  • A/B 测试计划
案例研究简报

适用场景: 客户成功故事、推荐证言

关键要素:

  • 客户背景
  • 问题/解决方案/结果框架
  • 指标和成果
  • 所需引言
  • 行业背景

内容结构框架

AIDA(注意、兴趣、欲望、行动)

最适合: 营销文案、销售页面

  1. 注意: 用标题吸引注意
  2. 兴趣: 通过优势激发兴趣
  3. 欲望: 用证据激发需求
  4. 行动: 通过明确的 CTA 促使行动
PAS(问题、激化、解决)

最适合: 博客文章、电子邮件营销活动

  1. 问题: 指出痛点
  2. 激化: 强调紧迫性
  3. 解决: 提出解决方案
倒金字塔结构

最适合: 新闻、技术文档

  1. 最重要的信息放在前面
  2. 补充细节
  3. 背景信息
故事弧

最适合: 案例研究、叙事内容

  1. 开端(人物/情境)
  2. 冲突(挑战)
  3. 解决(方案)
  4. 启示(经验)

SEO 整合

关键词策略
  • 主要关键词(1 个)
  • 次要关键词(2-3 个)
  • 长尾关键词变体(3-5 个)
  • LSI 关键词(相关词语)
搜索意图
  • 信息型: 了解某个主题
  • 导航型: 查找特定页面
  • 商业型: 比较选项
  • 交易型: 准备购买
页面 SEO
  • 标题标签(包含主要关键词)
  • 元描述(吸引人且包含关键词)
  • 标题(H1、H2、H3 中包含关键词)
  • 图片替代文本
  • 内部链接

语气与风格指南

语气范围
  • 正式 ↔ 随意
  • 严肃 ↔ 活泼
  • 尊重 ↔ 不拘礼节
  • 热情 ↔ 客观
风格特征

定义你的品牌风格:

  • 专业且平易近人(如 Stripe)
  • 技术性强但友好(如 Twilio)
  • 活泼大胆(如 Mailchimp)
  • 权威可信(如 HubSpot)
写作风格
  • 主动语态与被动语态
  • 人称(第一、第二、第三人称)
  • 句子长度
  • 段落结构
  • 术语使用

研究与来源

研究要求
  • 一手研究: 访谈、调查、原创数据
  • 二手研究: 行业报告、竞争对手分析
  • 专家引语: 主题专家访谈、第三方专家
  • 数据与统计信息: 可靠来源、最新数据
  • 示例: 真实案例、截图
引用标准
  • 链接至原始来源
  • 标注引语来源
  • 最新数据(1-2 年内)
  • 权威来源
  • 事实核查要求

视觉与媒体要求

图片
  • 主视觉图片规格
  • 内容中的图片(数量、类型)
  • 截图或示意图
  • 图表或信息图
  • 替代文本要求
视频/音频
  • 视频长度和格式
  • 是否需要屏幕录制
  • B-roll 要求
  • 音频质量标准
其他媒体
  • 代码片段
  • 可下载资源
  • 交互元素
  • 嵌入内容

工作流与流程

1. 创建简报(本技能)

使用 generate_brief.sh 创建全面的简报

2. 研究与大纲

作者进行研究并创建大纲

3. 初稿

作者根据简报要求撰写内容

4. 审阅与编辑

编辑根据简报要求进行审阅

5. SEO 优化

进行 SEO 审查与优化

6. 最终批准

利益相关方签字确认

7. 发布

发布并分发

8. 效果跟踪

监控简报中定义的指标

按内容类型划分的成功指标

博客文章
  • 自然流量
  • 页面停留时间(3 分钟以上)
  • 滚动深度
  • 社交分享
  • 反向链接
  • 潜在客户开发
技术文档
  • 页面浏览量
  • 页面停留时间
  • 搜索排名
  • 反馈评分
  • 支持工单减少量
落地页
  • 转化率
  • 跳出率
  • 页面停留时间
  • 点击率
  • 表单提交量
案例研究
  • 下载量
  • 生成的潜在客户
  • 对销售管道的影响
  • 分享率

常见的内容简报错误

❌ 避免以下做法

过于笼统: “写一篇关于我们产品的文章” → 没有明确的受众、目标或角度

没有研究: 缺少竞争对手分析和关键词研究 → 内容无法获得排名,也无法脱颖而出

风格不明确: “让内容更吸引人” → 不够具体,难以保持一致性

缺少 CTA: 没有为读者明确说明下一步 → 错失转化机会

忽略 SEO: 没有关键词策略 → 内容无法被发现

✅ 建议这样做

具体明确: “为初级开发者撰写一篇 1500 字的 JWT 身份验证教程,包含 Node.js 代码示例”

以研究为依据: “定位关键词 ‘JWT authentication tutorial’(每月搜索量 2.4K),与 Auth0 和 FreeCodeCamp 发布的现有文章竞争”

明确风格: “技术性强但平易近人——像资深开发者指导初级开发者一样进行讲解,使用示例,避免术语”

以行动为导向: “CTA:注册获取免费 API 密钥;次要 CTA:加入 Discord 社区”

针对 SEO 优化: “主要关键词:‘JWT authentication’;次要关键词:‘JSON web token Node.js’、‘secure API authentication’”

使用此技能

生成内容简报
./scripts/generate_brief.sh

交互式工作流将引导你完成以下步骤:

  1. 内容类型与受众
  2. 目标与目的
  3. SEO 要求
  4. 结构与要求
  5. 成功指标
验证简报
./scripts/validate_brief.sh path/to/brief.md

检查内容:

  • 必需章节是否齐全
  • 是否制定关键词策略
  • 是否指定目标受众
  • 是否包含成功指标
  • 完整度评分
访问模板
references/content_brief_template.md - Complete template
references/seo_guidelines.md - SEO best practices
references/content_frameworks.md - Structure frameworks
references/tone_voice_guide.md - Voice guidelines

内容简报清单

  • 标题清晰,并注明内容类型
  • 定义目标受众并提供人物角色详情
  • 明确主要目标和业务目标
  • 完成关键词研究
  • 确定搜索意图
  • 指定语气和风格
  • 字数目标
  • 列出结构和关键章节
  • 确定研究来源
  • 明确示例和数据要求
  • 指定视觉素材需求
  • 定义CTA
  • 制定成功指标
  • 分析竞争对手内容
  • 列出分发计划

快速入门示例

“创建博客文章简报”

系统会生成全面的简报,包含:

  • SEO 关键词策略
  • 受众定位
  • 结构建议
  • 成功指标
“编写 API 技术文档简报”

系统会创建技术简报,包含:

  • 技术要求
  • 代码示例规范
  • 受众技能水平
  • 文档标准
“生成落地页简报”

系统会构建以转化为重点的简报,包含:

  • 价值主张指导
  • CTA 策略
  • A/B 测试建议
  • 转化指标

最佳实践

1. 从研究开始
  • 分析排名靠前的内容
  • 了解搜索意图
  • 找出内容缺口
  • 了解竞争对手的做法
2. 明确具体要求
  • 确切的字数
  • 所需的具体示例
  • 清晰的语气指南
  • 明确的成功指标
3. 与策略保持一致
  • 与业务目标关联
  • 符合内容日历
  • 支持对应的营销漏斗阶段
  • 符合品牌风格
4. 确保可执行
  • 明确交付成果
  • 具体要求
  • 具体示例
  • 可衡量的结果
5. 迭代并改进
  • 跟踪表现
  • 根据结果更新
  • 随时间不断完善
  • 借鉴表现出色的内容

与其他工作流集成

内容日历

创建简报时会触发日历条目

SEO 工具

来自 SEMrush、Ahrefs 等工具的关键词

项目管理

简报转化为 Jira/Asana 任务

CMS

将简报导出到内容管理系统

分析

在仪表板中跟踪成功指标

针对不同写作者类型的建议

内容写作者
  • 关注受众和故事叙述
  • 强调研究要求
  • 明确品牌风格指南
技术写作者
  • 说明技术准确性要求
  • 定义受众的知识水平
  • 包含代码示例要求
文案写作者
  • 突出转化目标
  • 指定 A/B 测试需求
  • 明确 CTA 策略
内容营销人员
  • 关联营销漏斗阶段
  • 制定分发策略
  • 指定潜在客户开发目标

资源

包含所有参考资料:

  • 完整的内容简报模板
  • SEO 优化指南
  • 内容结构框架
  • 语气和风格开发指南
  • 文案写作公式和示例

总结

内容简报可确保:

  • 清晰——每个人都清楚预期
  • 高效——减少所需的修改次数
  • 优质——内容始终如一且具有策略性
  • 见效——内容能够实现目标

使用此技能创建全面的简报,帮助写作者取得成功。


**请记住:**花时间做好简报,可以节省 10 倍的修改时间。开始写作前,先把简报做好。

评论

支持 Markdown