Devrel Content

DevRel 内容

适用场景

当用户希望为开发者创作技术内容（包括博客文章、教程和文档）时使用本技能。触发短语包括"写一篇博客文章"、"技术文章"、"开发者内容"、"教程"、"DevRel 内容"、"开发者博客"、"技术写作"或"开发者内容..."。

本技能帮助你创作开发者真正愿意阅读的技术内容：博客文章、教程、文档以及能够建立信任并推动采用的思想领导类内容。

开始之前

首先加载受众上下文。 阅读 .agents/developer-audience-context.md 以了解：

• 你在为谁写作（角色、资历、技术栈）
• 他们的痛点（哪些问题能引发共鸣）
• 他们的原话（他们如何描述事物）
• 语气与基调（需要多正式或多技术）

如果上下文文件不存在，请先运行 developer-audience-context 技能。

DevRel 内容框架

阶段 1：研究与验证

在动手写作之前，先验证这个主题值得写。

危险信号 — 出现下列情况时不要写：

• 你是唯一关心这个话题的人
• 已经有 10 篇类似的文章
• 主题过于宽泛（例如"JavaScript 入门"）
• 主题过于狭窄（没有搜索量，也没有社区关注）

阶段 2：内容类型选择

根据目标选择合适的格式：

阶段 3：提纲结构

使用以下提纲模板：

# [承诺具体价值的标题]

## 开场钩子（2-3 句话）
- 点出问题或机会
- 建立可信度（例如"我们迁移了 10,000 个仓库……"）
- 承诺读者将学到什么

## 背景（可选）
- 必要时给出简要背景
- 链接到前置知识

## 主体内容
### 第 1 节：[第一个核心概念]
- 解释说明
- 代码示例
- 常见陷阱

### 第 2 节：[第二个核心概念]
- 解释说明
- 代码示例
- 实际应用

### 第 3 节：[第三个核心概念]
- 解释说明
- 代码示例
- 高阶技巧

## 整合落地
- 完整示例
- 可运行代码

## 下一步
- 链接到更深入的内容
- 行动号召（试用产品、加入 Discord 等）

编写代码示例

代码就是内容本身，必须写对。

复制粘贴测试

每个代码示例都必须满足：

代码示例结构

首先，安装依赖：

\`\`\`bash
npm install your-library axios
\`\`\`

接下来创建一个名为 `fetch-data.js` 的文件：

\`\`\`javascript
// fetch-data.js
import { Client } from 'your-library';
import axios from 'axios';

const client = new Client({
  apiKey: process.env.YOUR_API_KEY // 使用环境变量
});

async function fetchUserData(userId) {
  try {
    const user = await client.users.get(userId);
    console.log(`Fetched user: ${user.name}`);
    return user;
  } catch (error) {
    console.error(`Failed to fetch user: ${error.message}`);
    throw error;
  }
}

// 使用示例
fetchUserData('user_123')
  .then(user => console.log(user))
  .catch(err => process.exit(1));
\`\`\`

运行它：

\`\`\`bash
YOUR_API_KEY=sk_test_xxx node fetch-data.js
\`\`\`

预期输出：

\`\`\`
Fetched user: Jane Developer
{ id: 'user_123', name: 'Jane Developer', email: 'jane@example.dev' }
\`\`\`

各语言约定

技术准确性检查清单

发布前请逐项过一遍：

面向开发者内容的 SEO

开发者使用 Google 的方式与普通消费者不同。

开发者的搜索模式

技术 SEO 检查清单

优化标题示例

内容质量信号

优秀 DevRel 内容与平庸内容的区别在于：

应当这样做

• 展示而非讲述 — 用代码代替大段文字
• 回应"为什么" — 不仅是怎么做，还包括何时做、为何做
• 承认取舍 — 没有完美方案；开发者尊重诚实
• 引用来源 — 官方文档、RFC、相关文章
• 标注日期 — "更新于 2024 年 3 月"或带上版本号
• 渐进式披露 — 从简单入手，逐步增加复杂度
• 真实示例 — 生产场景，而非 hello world

不要这样做

• 一整面文字墙 — 用代码、标题、列表来打断节奏
• 营销腔 — "业界领先"、"无缝"、"颠覆性"
• 假设读者已具备知识 — 解释缩写，链接前置知识
• 过时内容 — 没有比一篇用着废弃 API 的 2019 年教程更糟糕的事了
• 埋没要点 — 先给答案，再做解释
• 没有代码 — 开发者来看代码，不是来看散文的

内容模板

博客文章模板

# [具体、富含关键词的标题]

[2-3 句开场钩子：问题 + 承诺]

## 问题

[1 段说明痛点]

## 解决方案

[简要说明你的思路]

### 第 1 步：[动作]

[解释说明]

\`\`\`language
// Code
\`\`\`

### 第 2 步：[动作]

[解释说明]

\`\`\`language
// Code
\`\`\`

### 第 3 步：[动作]

[解释说明]

\`\`\`language
// Code
\`\`\`

## 完整示例

\`\`\`language
// 完整可运行代码
\`\`\`

## 排错

### [常见错误 1]
[解决方案]

### [常见错误 2]
[解决方案]

## 下一步

- [深入内容的链接]
- [相关教程的链接]
- [行动号召：亲自试一试]

对比文章模板

# [工具 A] vs [工具 B]：[具体使用场景]（[年份]）

[1 段：本文适合谁，以及你将学到什么]

## 快速对比

| 特性 | 工具 A | 工具 B |
|---------|--------|--------|
| [特性 1] | | |
| [特性 2] | | |
| [特性 3] | | |

## 何时选择 [工具 A]

- [场景 1]
- [场景 2]
- [场景 3]

## 何时选择 [工具 B]

- [场景 1]
- [场景 2]
- [场景 3]

## 深度剖析：[具体方面]

### 工具 A 的做法
[解释说明 + 代码]

### 工具 B 的做法
[解释说明 + 代码]

## 我们的推荐

[基于使用场景的具体建议]

衡量内容效果

需要追踪的指标

内容 → 转化路径

追踪完整旅程：

1. 搜索/社交 → 博客文章
2. 博客文章 → 文档 / 快速上手
3. 文档 → 注册 / 安装
4. 注册 → 激活（首次成功）

工具

相关技能

• developer-audience-context — 了解读者的基础
• technical-tutorials — 深入探讨步骤化内容
• developer-newsletter — 通过邮件分发内容
• developer-seo — 技术 SEO 优化
• hacker-news-strategy — 在 HN 上高效分享内容

局限性

• 仅当任务明确匹配其上游来源和本地项目上下文时才使用本技能。
• 在应用变更之前，请验证命令、生成的代码、依赖、凭证以及外部服务行为。
• 不要把示例当作针对特定环境的测试、安全审查，或用户对破坏性或高成本操作的审批的替代品。