devrel-content

用途

DevRel Content 用于帮助用户创建面向开发者的技术内容，目标是产出开发者真正会阅读的内容，从而建立信任并推动产品采用。适用内容类型包括博客文章、教程、文档和思想领导力文章。触发场景包括用户提出“写一篇博客文章”等需求。

使用前提

开始前应先加载受众上下文：读取 .agents/developer-audience-context.md，以了解目标读者的角色、资历、技术栈、痛点、他们描述问题的原话以及语气与正式程度。如果该上下文文件不存在，应先运行 developer-audience-context 技能。

内容框架

该技能将内容创作分为多个阶段：

阶段一：调研与验证。 在动笔前验证选题是否值得写。调研类型包括搜索意图（搜索该主题，看已有排名内容和缺失点）、社区信号（Reddit、HN、Stack Overflow 上开发者是否在问）、竞品空白（竞品写了什么、没写什么）、内部数据（支持工单、Discord 提问、GitHub issue）以及关键词研究（使用 Ahrefs/SEMrush 查技术词搜索量）。警示信号包括：只有你自己关心该主题、已有 10 篇雷同文章、主题过宽（如“JavaScript 入门”）或过窄（无搜索量、无社区兴趣）。

阶段二：内容类型选择。 根据目标选择格式：教程（教具体技能，分步、代码密集）、指南（全面覆盖主题，分节、参考资料）、对比（辅助决策，表格、优缺点）、公告（发布功能/产品，新闻导语、what/why/how）、思想领导力（建立权威，观点、预测）、案例研究（社会证明，问题→方案→结果）、故障排查（解决具体错误，错误→原因→修复）。

阶段三：大纲结构。 提供大纲模板：标题（承诺具体价值）、钩子（2-3 句，陈述问题或机会、建立可信度、承诺读者将学到什么）、上下文（可选，简要背景与前置链接）、主体（各节包含解释、代码示例、常见陷阱或进阶提示）、整合（完整示例与可运行代码）、下一步（深入内容链接与行动号召）。

代码示例规范

代码即内容，必须准确。每个代码示例需通过“复制粘贴测试”：无需修改即可运行、包含 import、展示输出、处理错误、使用真实值（避免 foo、bar、example.com）。技能给出了代码示例结构（安装依赖、创建文件、运行、预期输出）以及各语言约定表，涵盖 JavaScript/Node、TypeScript、Python、Go、Rust、Shell 的代码块标记、包安装命令和环境变量写法。

技术准确性检查

发布前需逐项核对：代码可运行（逐段复制粘贴运行）、版本匹配、链接有效、命令可执行、截图与当前产品一致、无废弃 API、安全审查（无硬编码密钥、SQL 注入等）、同行评审（请工程师审阅准确性）。

面向开发者的 SEO

开发者搜索模式包括错误信息、how to、对比、最佳实践、替代方案、with 组合等。技术 SEO 检查项包括标题（含主关键词、框架名、年份）、meta 描述（150 字符、含关键词、承诺具体结果）、H1、H2、代码块语法高亮、内部链接、外部链接、URL slug。技能还给出优化标题的对比示例。

内容质量信号

应做：展示而非讲述（代码优于散文）、解释“为什么”（何时与为何）、承认权衡、链接来源、标注日期、渐进披露、真实示例。不应做：大段文字、营销话术（“一流”“无缝”“革命性”）、假设读者已知、过时内容、埋没重点、无代码。

内容模板

提供博客文章模板和对比文章模板，包含标题、钩子、问题、解决方案、分步、完整示例、故障排查、下一步等结构，以及对比表格、选择建议、深入分析和推荐。

效果衡量

跟踪指标包括页面浏览量、页面停留时间、滚动深度、跳出率、搜索排名、反向链接、社交分享、转化事件。转化路径为：搜索/社交→博客→文档/快速上手→注册/安装→激活。

工具

列出 Octolens（监测内容分享与竞品表现、从开发者对话中找选题）、Grammarly/Hemingway（可读性与语法）、Carbon/Ray.so（代码截图）、Excalidraw（技术图表）、Loom（视频讲解）、Ahrefs/SEMrush（关键词与 SEO）、Google Search Console（搜索表现）。

限制

该技能未提供具体的收费、价格或平台支持信息；其效果取决于是否先建立受众上下文以及是否严格执行代码验证与同行评审。

技能介绍

用途