技能介绍

解决的具体问题

技术文档里的教程，经常出现受众模糊、章节顺序混乱、案例脱节的情况：面向新手的内容塞了太多前置知识，面向进阶用户的部分又反复解释基础概念；章节之间缺少逻辑衔接，读者跟着走容易迷路；想配案例却不知道选什么场景，要么太简单没参考价值，要么太复杂超出受众能力。手动打磨大纲耗时长，且很难一次性覆盖受众分析、结构设计、案例匹配的全部环节。

核心能力与工作流程

这个技能聚焦教程大纲设计，覆盖从受众定位到内容落地的关键环节：

分步指导大纲创建全流程，从拆解受众需求开始，明确区分初级开发者、平台运维、API 调用者等不同群体的能力基线
遵循技术文档行业最佳实践，按入门准备→核心操作→进阶场景→故障排查的逻辑组织章节，保证内容递进合理
生成可落地的配置文件与代码结构，比如为案例配套示例数据、调用脚本的模板，直接适配 API 文档、用户指南、架构说明等文档场景
输出会做标准校验，检查大纲是否遗漏前置条件、参数说明、预期结果等必填要素，避免后期返工

适用边界与注意点

适合需要系统化教程大纲的技术写作场景，尤其是API 文档、用户指南、架构说明这类结构化文档。但需要提前配置好相关开发环境，确保依赖工具可用，且使用者需具备基础的文档写作概念。如果要做的是非结构化的经验分享，或是纯创意类内容大纲，这个技能帮助有限；它只负责生成大纲框架，不会替代你完成实际的内容撰写与案例填充。