docs-as-marketing

此技能使软件代理能够弥补技术文档与营销策略之间的差距。它基于开发者通常在产品采用前将文档视为主要接触点的事实，使其成为营销组合中最关键的转换工具。该技能指导创作兼具教育与获客功能的文档，确保内容在技术搜索查询中排名靠前，同时有效地引导用户进行激活。

• 信息架构：实施教程、操作指南、API 参考与概念说明等逻辑结构，以降低跳出率与认知负载。

• 快速启动优化：应用五分钟法则设计高转换率的入职流程，包括先决条件验证、安装指令与下一步路径。

• API 文档最佳实践：标准化请求/响应格式，提供可验证的复制粘贴示例，并记录错误代码以确保可靠的整合。

• 开发者 SEO：优化文档内容以捕捉技术搜索意图，专注于“如何做”查询与特定的错误信息疑难排解。

• 转换导向写作：超越枯燥的技术规格，阐述产品功能的“是什么”、“为什么”与“如何做”，透过透明度与准确性建立开发者信任。

• 输入：需要存取 API 端点、代码片段、现有文档结构以及已识别的开发者受众角色（透过 developer-audience-context）。

• 输出：可执行的基于 Markdown 的文档文件、优化的快速启动流程、重构的导航阶层与高保真代码示例。

• 实际使用：在审核当前文档的流失点、发布新 API 功能或优化入门体验时使用此技能。它旨在与 devrel-content 及 sdk-dx 技能结合使用，以保持开发者生命周期的一致性。请始终优先考虑功能性代码片段，并验证所有 curl 或 SDK 示例均为最新，以防止开发者感到挫折。