关于 content-brief-generator
content-brief-generator 是为写作者和内容团队创建结构化内容简报的技能。模板和指南涵盖受众、目标、SEO、内容要求及成效指标,适用于多种内容形式。
主要功能
- 01交互式生成内容简报
- 02多种内容类型的模板
- 03定义受众与业务目标
- 04SEO 关键词与搜索意图
- 05语气、结构和媒体要求
- 06简报完整性检查
适用场景
- 01规划博客文章或落地页
- 02明确技术文档的编写要求
- 03统一写作者对受众、语气和目标的理解
- 04设定内容成效指标
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jamesrochabrun/ skills --skill content-brief-generator安装后在 Claude Code 中输入/content-brief-generator确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/content_frameworks.mdseo_guidelines.mdtone_voice_guide.mdscripts/generate_brief.shvalidate_brief.sh详细介绍
内容简报生成器
一套全面的技能,用于创建详细的内容简报,指导写作者、确保内容一致,并使内容与业务目标保持一致。
此技能的作用
帮助你为以下内容创建专业的内容简报:
- 博客文章和文章 - 思想领导力、教程、操作指南
- 技术文档 - API 文档、指南、README 文件
- 营销文案 - 着陆页、电子邮件营销活动、广告
- 社交媒体内容 - 帖子、营销活动、话题串
- 案例研究 - 客户成功故事
- 白皮书和报告 - 深度研究内容
- 产品描述 - 电商和产品页面
- 视频脚本 - YouTube 视频、讲解视频、演示
内容简报为何重要
没有简报:
- 预期和范围不明确
- 需要多轮修改
- 语气和信息不一致
- 错失 SEO 机会
- 浪费时间和资源
有了简报:
- 方向和目标明确
- 减少修改次数
- 质量一致
- 针对 SEO 优化的内容
- 高效的工作流
内容简报的核心组成部分
1. 内容概述
- 标题/暂定标题
- 内容类型(博客、文档、着陆页等)
- 目标受众
- 主要目标(教育、转化、娱乐等)
- 核心信息或要点
2. 受众与背景
- 目标用户画像
- 读者的知识水平
- 痛点和需求
- 他们所处的转化漏斗阶段
- 他们将如何发现内容
3. 策略要素
- 业务目标
- SEO 关键词和搜索意图
- 竞争格局
- 成功指标
- CTA 和转化目标
4. 内容要求
- 语气和风格
- 长度/字数
- 结构和章节
- 研究要求
- 视觉/媒体需求
5. SEO 与分发
- 主要和次要关键词
- 搜索意图
- 元描述
- 内部/外部链接
- 分发渠道
内容类型与模板
博客文章简报
适用场景: 思想领导力、教程、清单式文章、操作指南
关键要素:
- 吸引人的开头和引言角度
- 主要要点(通常为 3-7 个)
- 需要包含的示例和数据
- 行动号召
- 内部链接策略
技术文档简报
适用场景: API 文档、指南、开发者文档
关键要素:
- 技术准确性要求
- 所需代码示例
- 受众的技术水平
- 前置条件
- 相关文档
着陆页简报
适用场景: 产品页面、注册页面、营销活动页面
关键要素:
- 价值主张
- 优势与功能
- 社会认同要求
- 转化目标
- A/B 测试计划
案例研究简报
适用场景: 客户成功故事、推荐证言
关键要素:
- 客户背景
- 问题/解决方案/结果框架
- 指标和成果
- 所需引言
- 行业背景
内容结构框架
AIDA(注意、兴趣、欲望、行动)
最适合: 营销文案、销售页面
- 注意: 用标题吸引注意
- 兴趣: 通过优势激发兴趣
- 欲望: 用证据激发需求
- 行动: 通过明确的 CTA 促使行动
PAS(问题、激化、解决)
最适合: 博客文章、电子邮件营销活动
- 问题: 指出痛点
- 激化: 强调紧迫性
- 解决: 提出解决方案
倒金字塔结构
最适合: 新闻、技术文档
- 最重要的信息放在前面
- 补充细节
- 背景信息
故事弧
最适合: 案例研究、叙事内容
- 开端(人物/情境)
- 冲突(挑战)
- 解决(方案)
- 启示(经验)
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
交互式工作流将引导你完成以下步骤:
- 内容类型与受众
- 目标与目的
- SEO 要求
- 结构与要求
- 成功指标
验证简报
./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 倍的修改时间。开始写作前,先把简报做好。