用途
本技能用于建立或更新开发者的受众上下文。它面向开发者营销工作,目的是产出一份可复用的基础文档,让其他开发者营销技能在运行时优先引用该文档,从而只需定义一次目标受众。
主要能力
技能围绕 .agents/developer-audience-context.md 文件展开。若该文件已存在,则读取并提供更新特定章节的选项;若不存在,则创建目录和文件,然后逐节推进。
构建上下文有两种方式:
- 方式一:从代码库自动起草(推荐)。通过分析现有材料起草初始版本,材料包括:README.md(产品描述、功能、入门)、文档(/docs、API 参考、教程)、落地页(index.html、营销文案)、package.json / pyproject.toml(依赖可反映生态)、GitHub Issues(常见问题、困扰、用例)、现有博客文章(技术内容、教程)。起草完成后,逐节校验并补齐空白。
- 方式二:从零开始。逐节提问,当前章节未完成前不进入下一节。
使用方式
文档需捕获以下十个部分:
- 产品概述:产品名称与别名、一句话介绍(“We help [developers] do [X] without [Y]”)、类别(API、SDK、CLI、SaaS、开源库、基础设施)、核心技术(支持的编程语言、框架、平台)、定价模式(免费/开源、免费增值、按用量、按席位)。
- 开发者画像:主要角色(后端、前端、全栈、DevOps、数据、ML、移动)、资历(初级、中级、高级、staff、负责人、架构师)、公司规模(个人、初创、成长期、企业)、行业垂直领域(金融科技、医疗科技、电商、游戏、B2B SaaS)、技术栈(使用的语言、框架、云服务商)、决策权限(个人贡献者、团队负责人、买家、影响者)。可提问:“用一段话描述从你的产品中获得最大价值的开发者。他们的日常工作是什么样的?”
- 他们常出现的渠道:社区(具体 subreddit、Discord 服务器、Slack 群组)、社交(Twitter/X 话题标签、LinkedIn 群组)、内容(阅读的博客、订阅的 newsletter、播客)、活动(会议、聚会、黑客松)、代码(GitHub 话题、Stack Overflow 标签)。提示:使用社交监听工具监控 Hacker News、Reddit、Stack Overflow、GitHub 和 Twitter 上的讨论,观察围绕你问题领域的讨论在何处自然发生。
- 问题与痛点:功能层面(“我无法做 X”/“X 太耗时”/“X 容易出错”)、情感层面(挫败、焦虑、尴尬、恐惧)、情境层面(痛点何时发生?什么触发搜索?)。可提问:“把开发者带到你这里的头号挫败是什么?”可搜索 Reddit、Hacker News 和 Stack Overflow 中关于你问题领域的抱怨,记录原话。
- 当前替代方案:直接竞品(解决同一问题的工具)、DIY/自建(自定义脚本、内部工具)、间接方案(变通办法、手动流程)、什么都不做(忍受痛点)。对每个替代方案记录:开发者为何选择它、它令人沮丧之处、什么会促使他们切换。
- 关键差异化:技术层面(“快 10 倍”“无依赖”“类型安全”)、开发者体验(“5 分钟完成设置”“文档优秀”“一流的 CLI”)、生态(“可与 X 配合”“为 Y 框架打造”)、理念(“开源”“隐私优先”“本地优先”)。注意:避免营销空话,开发者能看穿“同类最佳”和“企业级”,应使用具体、可证明的说法。
- 开发者原话:描述问题(“这太痛苦了”“我希望我能直接……”)、描述你的产品(他们如何向他人解释)、异议(“但是……呢”“我担心……”)、赞扬(推荐语、推文、GitHub 评论)。来源:GitHub issues、Twitter 提及、Hacker News 评论、支持工单、销售电话、社区 Slack/Discord。
- 技术信任信号:采用度(GitHub stars、npm 下载量、Docker 拉取量)、质量(测试覆盖率、安全审计、正常运行时间 SLA)、社区(贡献者、Discord 成员、论坛活跃度)、可信度(由 X 支持、被 Y 使用、由 Z 创建)、透明度(开源、公开路线图、更新日志)。
- 转化动作:各阶段的主要动作与次要动作——认知(star 仓库、在 Twitter 关注;阅读博客、分享内容)、考虑(clone 仓库、阅读文档;观看演示、加入 Discord)、试用(注册、安装 SDK;完成快速入门、发出首次 API 调用)、激活(达到“Hello World”时刻;集成到真实项目)、转化(升级付费;添加团队成员、扩大使用)。
- 语气与风格:维度包括正式程度(随意 ← → 专业)、技术性(易懂 ← → 深度技术)、个性(中立 ← → 有观点)、幽默感(严肃 ← → 俏皮)。示例:Stripe → 专业、精确、干净;Vercel → 现代、自信、开发者优先;Supabase → 友好、易懂、社区驱动;Tailwind → 有观点、直接、实用。
输出格式
保存到 .agents/developer-audience-context.md,结构为:标题“# Developer Audience Context”、最后更新时间,以及十个章节(Product Overview、Developer Persona、Where They Hang Out、Problems & Pain Points、Current Alternatives、Key Differentiators、Verbatim Developer Language、Technical Trust Signals、Conversion Actions、Voice & Tone)。
维护
在以下情况更新文档:从用户研究中获得新信息、发现出色的原话、定位或差异化发生变化、扩展到新的开发者细分。
相关技能
建立上下文后,以下技能会引用它:devrel-content(撰写引起共鸣的内容)、hacker-news-strategy(在 HN 上真实互动)、developer-onboarding(优化实现价值的时间)、developer-seo(定位合适的技术查询)、competitor-tracking(理解竞争格局)。
限制
资料未提供技能的安装命令、技术实现细节、价格或收费信息。