4.7 KiB
4.7 KiB
title, type, tags, date
| title | type | tags | date | |||||
|---|---|---|---|---|---|---|---|---|
| Developer Advocate | source |
|
2026-04-30 |
Source File
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 反馈回路。