SuperAPI AI 工具集

devrel-content

写作与研究

查看项目

更新于 10-16 09:28

技能介绍

用途:当需要为开发者创作技术内容(博客文章、教程、文档、观点文章)时使用该技能。触发语包括“write a blog post”“technical article”“developer content”“tutorial”“devrel content”“dev blog”“technical writing”等。

使用方式:开始前先加载受众上下文,读取 .agents/developer-audience-context.md,了解读者角色、资历、技术栈、痛点、原话表达和语气;若该文件不存在,先运行 developer-audience-context 技能。

主要能力:内容框架分三个阶段。第一阶段做研究与验证,检查搜索意图、社区信号(Reddit、HN、Stack Overflow)、竞品缺口、内部数据(工单、Discord、GitHub issue)与关键词研究;并给出不建议写的信号,如只有自己在乎、已有 10 篇相同文章、主题过宽或过窄。第二阶段选择内容类型:教程、指南、对比、公告、观点领导、案例研究、排错。第三阶段提供大纲模板,从标题、钩子、语境到主体分节,再到完整汇总与下一步行动。

代码示例要求:可复制粘贴即能运行、包含导入、展示输出、处理错误、使用真实值;并给出 JavaScript、TypeScript、Python、Go、Rust、Shell 的语言约定;发布前需核对代码可运行、版本匹配、链接有效、命令可用、截图最新、无废弃 API、无硬编码密钥,并由工程师同行评审。

SEO 与质量:列出开发者搜索模式(报错信息、how to、对比、最佳实践、替代方案、with)与技术 SEO 清单(标题、描述、H1/H2、代码高亮、内链外链、URL slug),并给出“应做/不应做”的质量信号。另附博客文章与对比文章模板,以及衡量指标(浏览量、停留时间、滚动深度、跳出率、排名、外链、社交分享、转化)和转化路径、相关工具与相关技能。

限制:仅在任务与来源及本地项目上下文明确匹配时使用;应用变更前须验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代针对环境的测试、安全审查,以及破坏性或高成本操作的用户批准。