---
title: "Developer Advocate"
type: source
tags: [developer-experience, community-building, technical-content, the-agency, specialized]
date: 2026-04-30
---

## Source File
- [[Agent/agency-agents/specialized/specialized-developer-advocate]]

## Summary（用中文描述）
- 核心主题：The Agency 的 Developer Advocate（开发者倡导者）专业智能体——定位于产品团队与开发者社区之间的桥梁，通过真实的技术参与提升开发者体验（DX）、驱动平台采用率、建立开发者信任。
- 问题域：开发者社区参与度低、文档质量差、SDK 体验不佳、产品反馈闭环缺失、技术内容供给不足。
- 方法/机制：DX 工程审计 → 技术内容创作 → 社区运营 → 产品反馈闭环四步工作流；内置 DX Audit Framework、Viral Tutorial Structure、Conference Talk Proposal Template、GitHub Issue Response Templates 等标准化交付物。
- 结论/价值：开发者倡导者的核心资产是社区信任（AstroTurf 会永久摧毁）；DX 改进（错误消息/TypeScript 类型/SDK 修复）的价值随时间复利增长，优于单纯的内容产出。

## Key Claims（用中文描述）
- **开发者体验优先原则**：在发布任何新教程之前，必须先修复排名前 3 的 DX 问题；DX 改进长期复利，内容有半衰期。
- **真实性伦理约束**：绝不做 AstroTurf（虚假社区参与）；社区信任是开发者倡导者唯一的资产，一旦损坏永久不可逆。
- **社区→产品的代理角色**：开发者倡导者首先对开发者负责，其次才对公司负责——必须将开发者痛点转化为有证据支撑的产品需求。
- **可量化成功指标**：新开发者首次成功 API 调用时间 ≤15 分钟、GitHub issue 首响时间 ≤24 小时、教程完成率 ≥50%、开发者 NPS ≥8/10。
- **技术内容质量标准**：所有代码示例必须无需修改即可运行；不为非 GA 功能发布教程（除非明确标注 Preview/Beta）。

## Key Quotes
> "You don't do marketing — you do developer success." — Developer Advocate Agent 核心定位

> "Authentic community trust is your entire asset; fake engagement destroys it permanently." — Advocacy Ethics 核心原则

> "Fix the top 3 DX issues before publishing any new tutorials." — DX-first 工作流原则

> "Conference Q&A patterns — 5 people ask the same question = 500 have the same confusion." — 社区反馈信号放大原理

## Key Concepts
- [[Developer Experience Engineering]]：审计并改善"首次 API 调用时间"或"首次成功时间"，消除 onboarding、SDK、文档和错误消息中的摩擦点。
- [[Technical Content Creation]]：编写教程、博客、视频脚本、会议演讲，核心理念是"先展示最终结果，再解释如何实现"；代码示例必须零修改运行。
- [[Community Building & Engagement]]：通过 GitHub Issues、Stack Overflow、Discord/Slack 提供真实技术支持，建立大使/冠军计划，组织 hackathons 和 office hours。
- [[Product Feedback Loop]]：将开发者痛点转化为可操作的产品需求，用证据而非轶事在产品规划会议中代表开发者声音。
- [[Advocacy Ethics]]：绝不 AstroTurf、技术准确优先、为开发者代理、公开关系披露、不过度承诺路线图。

## Key Entities
- [[The Agency]]：该 Agent 所属的 The Agency 项目，提供 12 个业务部门的专业智能体。
- Developer Community（开发者社区）：Developer Advocate 的首要服务对象和反馈来源。

## Connections
- [[specialized-mcp-builder]] ← extends ← [[specialized-developer-advocate]]（MCP Builder 扩展了开发者工具能力，Developer Advocate 负责传播和推广）
- [[backend-architect-with-memory]] ← depends_on ← [[specialized-developer-advocate]]（后端架构师产出的 SDK 和示例应用依赖 Developer Advocate 的 DX 反馈优化）
- [[specialized-workflow-architect]] ← shares_workflow ← [[specialized-developer-advocate]]（两者都使用结构化模板驱动工作流）

## Contradictions
- 与 [[engineering-technical-writer]] 潜在冲突：
  - 冲突点：技术写作与开发者倡导者都产出手册和教程，但目标受众和交付标准不同。
  - 当前观点（Developer Advocate）：教程必须先展示最终结果，必须包含失败模式和调试方法，代码必须零修改运行，不为非 GA 功能发布教程。
  - 对方观点（Technical Writer）：文档以参考完整性优先，覆盖所有 API 端点和参数，面向不同熟练度的开发者分层提供内容。
  - 协调方案：Developer Advocate 负责"教程/快速入门/演示"等引导式内容；Technical Writer 负责"API 参考/规范文档/操作指南"等查阅式内容；两者共享 DX 反馈回路。